⬅️ Back to State Index

Settings Context

The Settings Context centralizes application-wide user preferences and system information used across UI surfaces.

Responsibilities (high-level)

  • Provide user preferences (e.g., date/number formatting, density) to the app.
  • Persist preferences to browser storage so they survive refresh.
  • Synchronize some defaults with the active UI language.
  • Fetch system info from the backend, with graceful fallback values if the backend is unavailable.

Why this is global

These settings influence multiple parts of the experience: - formatting and display preferences - system metadata display - consistent defaults when the language changes

Persistence and resilience (conceptual)

graph TB UI["UI"] --> Settings["SettingsContext"] Settings --> Storage["localStorage"] Settings --> Backend["system info endpoint"] Backend -->|fail| Fallback["Fallback values"]

Boundaries

Included: - Preference ownership + persistence at a global layer - System info exposure as shared UI metadata

Excluded: - Domain-specific configuration screens (documented under Domains) - Theming tokens and UI component styling (documented under Theming and UI Components)

Back to top