Architecture
Web Architecture
Understand how the Next.js dashboard proxies API traffic, consumes realtime data, and renders separate operational surfaces.
Web Architecture
The web app is the authenticated operator surface.
Responsibilities
- authentication flows
- workspace-aware dashboards and detail pages
- add-node and install-command surfaces
- metrics, diagnostics, packages, and terminals
- split Updates Center
- control-plane apply freeze modal
App Router routes and proxy handlers
feature UIs for nodes, metrics, diagnostics, terminals, updates, login, and setup
API client, auth helpers, realtime hooks, data hooks, mapping utilities
Zustand app state and client-side snapshots
API access model
The web app uses internal proxy routes for many server-side requests, but those
proxies must preserve externally reachable API URLs where commands are shown back
to the user. Internal upstreams such as http://nginx are valid runtime wiring,
not valid public API URLs for display.
Realtime consumption
Recent fixes ensured the web layer consumes live metric and node-install events instead of only relying on periodic polling.