# First run

```
cp .env.example .env
sed -i "s/^SECRET_KEY=.*/SECRET_KEY=$(openssl rand -hex 32)/" .env
make up
make migrate        # then restart the api
```

Every service reads `.env`; compose will not start without it.

# Migrations

Migrations are hand-written under `alembic/versions/`.

```
make migrate-create m="name"   # an empty revision to hand-write
make migrate-draft  m="name"   # autogenerate a draft to edit down
make migrate                   # apply everything pending
make migrate-history           # show the chain
make migrate-downgrade         # roll the last one back
```

Apply migrations before restarting the api.

# Checks

```
make lint    # ruff over every package, then prettier and eslint
make test    # pytest in the api container, then svelte-check and vitest
```

Both are what CI runs.