Local Development Setup

Local Development Setup

Backend (FastAPI)

cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt

# Start PostgreSQL and Redis (or use Docker)
docker compose up db redis -d

# Run backend with hot reload
uvicorn app.main:app --reload --port 8000

API docs available at: http://localhost:8000/docs

Frontend (Next.js)

cd frontend/web
npm install
npm run dev

Frontend at http://localhost:3000 — proxies /api/ to backend automatically.

Environment Variables

Copy .env.example to .env and configure:

• DATABASE_URL — PostgreSQL connection string
• REDIS_URL — Redis connection string
• SECRET_KEY — JWT signing key (generate with: openssl rand -hex 32)

Running Tests

cd backend
pytest tests/ -v