React Dashboard¶
Incrementally migrated React dashboard shell, routing, provider selection, and same-origin API boundary at /app.
Details¶
The React dashboard is the incrementally migrated desktop surface served at /app. The Python-generated dashboard at / remains available for operational surfaces that have not moved. They share one Flask service, one origin, and the same backend authority; they are distinct frontends rather than aliases.
Route and hosting contract¶
Registered /app/<view> routes host standardized dashboard views. /app/settings/... hosts the React Settings projection backed by the same-origin Settings authority. Explicit development routes host fixture laboratories. Unknown routes do not silently become convincing sample data.
Flask serves the production index, content-hashed assets, manifest, icons, and safe history fallbacks for registered routes. Optional PWA metadata changes presentation and install identity; it does not bootstrap Work Buddy services.
View composition¶
Shareable views normally enter through the contribution registry and render through ViewHost. A view contribution declares identity, chrome, widget placements, and a provider. The host validates the contribution before rendering it.
Providers own view definitions, widget input, and declared intent handling. A provider that already implements the dashboard contract is not an adapter. An adapter is justified only when translating an incompatible source, such as a root-dashboard Journal payload, into that contract.
Widget renderers receive typed presentation input and emit declared intents. They do not collect global context, connect directly to external providers, own credentials, or choose transport endpoints. App and System layers retain those authorities.
Network and event boundary¶
Browser code uses same-origin /api/... routes only. It never calls sibling localhost service ports, because those addresses fail over remote access and move service authority into the browser. Real-time UI reconciliation consumes the dashboard's lossy SSE projection at /api/events; durable reactions belong to the durable Events backbone.
Migration contract¶
The root dashboard remains in service while React coverage grows. Moving one view does not imply that all root tabs, mutations, or integrations have moved. Compatibility providers state whether they are read-only or write-capable, and a failed live source remains visibly failed instead of falling back to demo fixtures.
See services/dashboard/react/widget-platform for widget composition, services/dashboard/react/appearance for visual compatibility, services/dashboard/react/calendar-surface for the temporal presentation adapter, settings for configuration authority, and services/dashboard/frontend for the Python-generated root frontend.