# Local development

## Data plane

```bash
docker compose up -d
npm run db:migrate
npm run db:seed
npm run dev:api
```

Defaults:

- Postgres at `postgresql://seahaven:seahaven@127.0.0.1:5432/seahaven_ap`
- API at `http://127.0.0.1:8787`
- MinIO at `http://127.0.0.1:9000` (documents bucket for AP-15)

## Smoke

```bash
curl -s http://127.0.0.1:8787/health
curl -s http://127.0.0.1:8787/api/me
```

With `DEV_AUTH_BYPASS=true` and `NODE_ENV=development` (or `test`), `/api/me`
does not require a Bearer token. Bypass is rejected for staging, preview,
production, and any other `NODE_ENV`.

## Docs

```bash
npm run lint:api
npm run docs:preview
```

`docs:preview` runs `redocly build-docs` (CLI v2) and opens the HTML at
`/tmp/seahaven-ap-api-docs.html`. Published OpenAPI servers point at
`https://ap.seahaven.com`. Use this page for the local docs view.