Skip to main content
Source snapshot: 13 October 2026. These pages describe the current implementation, including unfinished controls. See coverage and review notes.

System settings

Host: control.<ROOT_DOMAIN> · Route: /settings

Purpose and access

Edit platform configuration and inspect system telemetry.You need an account session and platform access. Platform privileges are separate from tenant roles; privileged writes remain subject to endpoint role checks.

Screen layout

General Platform Identity covers name, root domain, support email, currency, and timezone. Security & Session Policies covers timeout/session count. Fleet & Onboarding Defaults covers trial/audit defaults; telemetry and fleet/compliance panels are read-only.

Fields and displayed information

Fields and filters: Platform settings view

Actions

Interaction sequence

Change configuration → Save Changes → patch /platform/settings → refresh. Inspect telemetry separately from the editable fields.

States and rules

Persisted setting values do not prove every runtime service consumes them. Document the saving operation without claiming that editing rootDomain automatically rewrites DNS or that all policy controls are fully enforced.The rendered action controls bind loading indicators to pending state. Failed API saves keep their documented error/notification path; a loading indicator alone does not establish persistence.

Implementation references

Paths below are relative to the application repository. This is source-reviewed behavior, not a recorded browser test.
  • apps/web/src/app/sites/control/(app)/settings/page.tsx
  • apps/web/src/features/platform/platform-settings-view.tsx
Data and access helpers: apps/web/src/lib/platform.ts, apps/web/src/lib/server-api.ts, apps/web/src/lib/api-client.ts

API behavior references

  • apps/api/src/platform/platform-tenant-access.controller.ts
  • apps/api/src/platform/platform.controller.ts
  • apps/api/src/billing/plans.controller.ts
  • apps/api/src/billing/tenant-billing.controller.ts
  • apps/api/src/features/features.controller.ts
  • apps/api/src/features/tenant-features.controller.ts
  • apps/api/src/forms/forms.controller.ts
  • apps/api/src/analytics/analytics.controller.ts
  • apps/api/src/analytics/tenant-analytics.controller.ts