Development Setup¶
Prerequisites¶
| Tool | Minimum version |
|---|---|
| Python | 3.11 |
| Node.js | 18 |
| Docker + Docker Compose | 24 / 2 (optional, for full-stack) |
Backend¶
Copy the environment file and edit as needed:
Run the development server (hot-reload enabled):
The API is available at http://localhost:8000 and Swagger UI at http://localhost:8000/docs.
Note
On first startup the backend applies Alembic migrations and creates the admin account from FIRST_ADMIN_USERNAME / FIRST_ADMIN_PASSWORD in .env.
Frontend¶
The dev server runs at http://localhost:3721 and calls the backend directly at API_URL (default http://localhost:8000).
Full Stack with Docker (recommended)¶
| Service | URL |
|---|---|
| Frontend | http://localhost |
| Backend API | http://localhost/api |
| Swagger docs | http://localhost/api/docs |
nginx serves the frontend on port 80 and proxies /api/* to the backend (prefix stripped); the backend port is not published.
Rebuild after code changes:
View logs: