Developers

Code Architecture

Guidelines for navigating the application repository without confusing UI, API, and persistence layers.

ZoneRole
src/appNext.js routes, pages, and API endpoints
src/componentsInterface, tabs, widgets, and modals
src/providersClient state and calls to the configuration API
src/libTypes, authentication, access control, persistence, integrations, and business rules
publicStatic resources
e2ePlaywright scenarios
scriptsContainer tests and maintenance tools
dataPersistent local data, never source code

Configuration mutations go through server routes, which enforce administrator privileges and filter responses. Integrations are queried on the server side to avoid exposing their secrets directly to the browser.

Before modifying a shared type, search for its consumers across the API, forms, persistence layer, reader filters, and tests. A visible option without a complete server contract is an unfinished feature.

Integration manifests and connection contracts live in src/integrations; the widget registry and renderers live in src/widgets; page persistence, filtering and templates live in src/lib/pages; translations live in src/i18n. Infrastructure credentials remain server-side. Weather location/forecast requests are browser-side and carry no integration secret.