frontend/README.md

# Rush Agents Rush Frontend

Next.js UI for the fire-suppression simulation.

## What It Shows

- Model selection from the backend's live Hugging Face model list
- Map-based agent positions and fire placement
- Water sources, coalition links, and leader markers
- Live event chat with model-generated radio-style messages
- End-of-game result banner with top performer info

## Run Locally

```bash
cd frontend
npm install
npm run dev
```

Then open http://localhost:3000.

## Environment Variables

```env
NEXT_PUBLIC_BACKEND_URL=http://localhost:8000
```

## Main Files

- `app/page.tsx` - app shell and simulation flow
- `components/MapCanvas.tsx` - 2D map rendering and agent visuals
- `components/ChatFeed.tsx` - event/chat panel
- `components/ModelSelector.tsx` - model picker
- `lib/api.ts` - backend requests
- `lib/websocket.ts` - simulation WebSocket client

## Notes

- The frontend expects the backend to be running before placing a fire.
- If the browser shows `Failed to fetch`, verify `http://localhost:8000/wake` first.
- The model picker reads `GET /available-models` from the backend and sends those model ids back into the simulation.
- The old volcano terminology has been removed from the current gameplay flow.