Core.Presentation

Core.Presentation is the shared presentation runtime for loading, resolving, and emitting design tokens across Web and MAUI, and for generating projection artifacts consumed by platform UI packages.

Portal-Safe Boundary

Core.Presentation owns cross-platform tokens, themes, icons, and small reusable UI primitives. It does not own product workflows, portal sign-in, API clients, persistence, database connectors, workers, or product-specific navigation. Authenticated portals may use its compiled web theme and components alongside product-owned routes and workflows.

Canonical token source

• Source of truth: Core/Presentation/Tokens/*
• Product overlays: Core/Presentation/themes/products/*.theme.json
• Legacy archives:
  • Core/Presentation/Tokens.LegacyArchive/*
  • Core/Presentation/Theme.LegacyArchive/*
  • Core/Presentation/Web.LegacyArchive/*

Runtime pipeline

1. ThemeEmitter reads canonical tokens and emits:
   • Core/Presentation/wwwroot/theme/compiled/tokens.json
   • Core/Presentation/wwwroot/Web/compiled-theme.css
   • Core/Presentation/themes/base.telerik-map.json
   • Avalonia projections:
     • Core/Avalonia/Styles/Generated/*.axaml
   • MAUI projections:
     • Core/Maui/Resources/Themes/Generated/*.xaml
     • Core/Presentation/Maui/Generated/*.xaml
2. ThemeLoader loads compiled tokens + Telerik map and applies optional product overlays.
3. ServiceCollectionExtensions.AddCoreUI(...) wires the theme bundle and Telerik overrides into DI.

Overlay rules

• Product overlays can modify only:
  • semantic.*
  • brand.*
  • component.*
• Primitive/base keys are immutable in overlays.

Standards promotion

When app, portal, API host, or cross-platform experience runbooks prove reusable token, chrome, or presentation behavior, promote the durable rule into Workspace Design/, Docs/Standards, ADRs when architectural, and this package documentation before the runbook is archived. Product-specific themes remain overlays; reusable primitives belong in Core only after they are proven product-agnostic.

Migration tracking

See Core/Presentation/Tokens/MIGRATION.md for remaining compatibility work and final cleanup sequencing.