Stack Overview

Stack Overview

Layer	Technology	Version
Frontend	Angular	21.2.4
Frontend runtime	Node / Bun	24.x / 1.3.5
Backend	Django + DRF	5.2 / 3.15
Backend runtime	Python	3.13
Database	PostgreSQL	16
ASGI server	uvicorn	0.30+
Auth (dev)	SimpleJWT (httpOnly cookies)	5.3+
Auth (post-MVP)	AWS Cognito	—
Deploy frontend	AWS Amplify	—
Deploy backend	AWS App Runner	—

Stack decisions documented in [[adr-002-dev-stack]], [[adr-002-a-backend-dev-stack]], [[adr-002-b-frontend-dev-stack]], [[adr-003-a-backend-prod-stack]], [[adr-003-b-frontend-prod-stack]].

Local Dev

docker compose up -d   # PostgreSQL + Django API at :8000
cd frontend && bun start  # Angular dev server at :4200 (proxies /api/* to :8000)

Entry point: config.asgi:application (uvicorn, ASGI). Migrations + superuser seeding run automatically in the container entrypoint.