Frontend Architecture
The UI is a React app with a clear split between canonical data and live overlays.
At a glance
- pages / components / hooks / store / theme.
- Canonical data vs live overlays.
- Tests under frontend/tests.
Organization
The app is organized into pages, components, hooks, a store, and theme. The store holds UI state; it is not a second source of truth for canonical data.
Canonical vs live
Canonical data comes from the backend; live overlays show in-flight progress. Keeping them distinct avoids the frontend drifting from server truth. Tests live under frontend/tests.