Day-to-day patterns after Installation and Quick start.
Emit boot script before generated CSS in your base layout:
{{ ui_kernel_theme_boot_script() }}
{{ ui_kernel_css()|raw }}Use ui_kernel_active_theme_id() in debug panels or admin chrome when you need the resolved lineage id.
| Need | Mechanism |
|---|---|
| Brand colours on built-in lineages | user_tokens in app symfinity_ui_kernel.yaml |
| Full custom lineage | App-owned files under config/themes/ + themes_directory |
| Author / export packs | Your own YAML packs (preset / tone / semantics schema via AuthoringThemeConfig) |
Keep app config minimal — do not copy contract or generator blocks from the bundle.
Install tier packages (symfinity/ux-blocks-core, …) for [data-ui-role] CSS. UI Kernel supplies tokens only; component rules live in tier packages.
- Themes — built-in lineages and dark mode
- Configuration —
schema_version,default_physics, system profile - Font Manager pairing — optional webfonts