# alpaclaudia — dashboard

Next.js 14 dashboard that renders the bot's Alpaca snapshot (live via REST) and
its SQLite state log (read-only).

## Dev

```bash
cd dashboard
npm install
cp .env.example .env.local      # fill ALPACA_API_KEY + ALPACA_API_SECRET
npm run dev                     # http://localhost:3030
```

The dashboard never places orders — it only reads. Write-paths are owned by
the Python bot (see `../bot`).

## Environment

| Var | Purpose |
|---|---|
| `ALPACLAUDIA_DB` | Path to bot SQLite DB (default `../data/alpaclaudia.db`) |
| `ALPACA_API_KEY` / `ALPACA_API_SECRET` | Paper API creds |
| `ALPACA_BASE_URL` | `https://paper-api.alpaca.markets` |

## Production

```bash
npm run build
npm start    # serves on :3030
```

Reverse-proxy behind Caddy / nginx as needed; the process is single-tenant.