# clawstor dashboard

React + Vite frontend for the (legacy) `claw-store serve` HTTP API.
Displays node status, hot-tier usage, ZFS snapshots, and the sync
queue for the original ZFS-backed deployment.

**Note:** the primary observability path in the current distributed
architecture is Prometheus (`/metrics` on each node's `prom_bind`
port, default `:7703`) + `deploy/scripts/fleet-status.sh`. This
dashboard predates that and is not maintained as the operator's
main pane of glass. Kept in-tree because the underlying HTTP
endpoints on `claw-store serve` still function.

## Build

```bash
cd dashboard
npm install
npm run build
# → dist/ ready to serve from claw-store serve --static-dir <path>
```

## Dev

```bash
npm run dev
# Vite dev server + HMR against a running `claw-store serve` on :3030.
```

## What it shows

- `/api/status` — node role, uptime, hot usage, ZFS pool.
- `/api/projects` — active + branch + size per project.
- `/api/snapshots` — ZFS snapshot list.
- `/api/hot` — hot-tier entries.
- `/api/sync-queue` — pending retries.
- `/api/events` — SSE stream, updates every 5 s.

See the top-level [README](../README.md) for the current
architecture, which centers on the distributed content-addressed
blob store rather than the ZFS project mirror model this dashboard
was originally built for.