# Swarm visualization prototype

2D top-down view of swarm data plane from [04 — Swarm sync](../docs/04-swarm-sync.md): drones patrol with obstacles, 5 Hz pose broadcasts (blue flashes), opportunistic bulk sync (green links with rate and byte counters).

No backend. Client-side sim. Same behavioral model as Python simulator (Parquet + UDP).

## Run

```bash
npm install
npm run dev     # http://localhost:5173
```

## Live mode

With k3d fleet + explorer running (`ansible-playbook` + `terraform apply` — see [sim-env README](../infra/terraform/sim-env/README.md)):

- Explorer at `http://localhost:30088`
- Header → **go live** — polls read-only SQL API for real drone positions

## What to look at

- Links form and break by radio range; broadcasts flash active links
- Busy links turn green — rate plus `↑` / `↓` totals
- Per-drone label: id, Wi-Fi channel, battery
- Controls: drone count, speed, pause