# Development

## Local Docker Stack

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

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

## Backend

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

Useful commands from `backend/`:

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

## Frontend

Frontend source lives in `frontend/src`.

Useful commands from `frontend/`:

```bash
npm install
npm run dev
```

## Tests and Checks

```bash
./scripts/lint.sh
./scripts/test.sh
```