Development

Local Docker Stack

cp .env.example .env
docker compose -f docker-compose.dev.yml up --build

The dev stack runs PostgreSQL, Redis, backend, worker, and frontend.

Backend source lives in backend/app. Migrations live in backend/alembic.

Useful commands from backend/:

alembic upgrade head
uvicorn app.main:app --reload

Frontend source lives in frontend/src.

Useful commands from frontend/:

npm install
npm run dev

./scripts/lint.sh
./scripts/test.sh