Technical reference for contributors working on the frontend.
| Document | What it covers |
|---|---|
| Development Guide | Start here. Project overview, DataService rules, design system summary, common patterns, change checklist |
| Architecture Decisions | ADRs: Pinia store pattern, bootstrap modal sequencing, mobile WebGL constraints, spinner unification, modal button classes, OTA update exit lock |
| Data Service | Centralised HTTP layer: bootstrap phases, TTL-aware caching, polling schedule, WebSocket-first delivery, /stats idle timeout |
| Design Tokens | Full CSS variable system (light/dark), Tailwind aliases, semantic groupings for surface, text, border, and accent colours |
| Style Guide | Global utility class catalogue, inline styles audit table, decision guide for Tailwind vs global class vs inline |
| UI Components | Shared UI primitives: Spinner, NeighborMenu, modal utilities, glass cards, configuration card utilities |
| Configuration Workflow | Unsaved-changes guard, useUnsavedChanges composable, save/restart flow, and per-tab behaviour differences |
| z-index Layering | Standardised z-index scale for all fixed/modal/overlay elements |