inital commit

README.md

@@ -1,2 +1,51 @@
-# demo_sites
+# Demo Sites Builder
+
+Django app that creates client websites in two flavors:
+
+- Static HTML/CSS package.
+- Django demo project with ecommerce scaffolding and contact/email flow.
+
+Includes local Ollama integration for AI-generated copy and section content.
+
+## Local setup with uv
+
+1. Create virtual environment:
+   - `uv venv .venv`
+2. Activate it:
+   - `source .venv/bin/activate`
+3. Install dependencies:
+   - `uv sync`
+4. Run migrations and seed template catalog:
+   - `uv run python manage.py migrate`
+   - `uv run python manage.py seed_templates`
+5. Start dev server:
+   - `uv run python manage.py runserver`
+
+## Docker
+
+- Build and run:
+  - `docker compose up --build`
+
+The app is available at `http://localhost:8000`.
+
+By default, container points Ollama requests to `http://host.docker.internal:11434`.
+
+## Client templates
+
+Place purchased themes under:
+
+- `templates/template_1/` — NeuralSync (static HTML in `Main File/NeuralSync/`)
+- `templates/template_2/` — Eventio (Next.js in `eventio/eventio-HTML/`)
+- `templates/template_3/` — Waves (static HTML in `site/`)
+- `templates/template_4/` — Multipurpose business (static HTML in `site/`)
+
+Run `uv run python manage.py seed_templates` after adding or changing template folders.
+
+## Default flow
+
+1. Sign up or log in.
+2. Open dashboard.
+3. Enter business details and pick one of the four templates.
+4. Generate site package (copies template files + business/AI personalization).
+5. Download static site zip (and optional Django ecommerce demo zip).