config/packages/symfinity_ui_kernel.yaml — see configuration.md for the full option list.
config/themes/{theme-id}/
├── symfinity.dtcg.yaml # or app-named *.dtcg.yaml
└── …
Built-in themes ship inside the bundle under Resources/themes/. Consumer apps override or extend via symfinity_ui_kernel.themes_directory.
| Area | Path |
|---|---|
| Bundle | src/UiKernelBundle.php |
| CSS generation | src/Css/CssGenerator.php |
| Cascade layers | src/Css/CascadeLayerOrder.php, src/Css/CascadeLayerWrap.php |
| Theme resolution | src/Theme/RegistryThemeResolver.php |
| Profiler collector | src/DataCollector/UiKernelDataCollector.php |
| Function | Role |
|---|---|
ui_kernel_theme_boot_script() |
Inline script — active theme before paint |
ui_kernel_layer_order() |
@layer declaration for the platform stack |
ui_kernel_css() |
Generated theme + profile CSS |
ui_kernel_active_theme_id() |
Active built-in theme id |
ui_kernel_theme_capabilities() |
Enabled theme-engine capability ids for this app runtime |
ui_kernel_theme_shell() |
Theme shell markup for layout chrome |
Prefer {% include '@UiKernel/_head.html.twig' %} in <head> when you do not customize the call order.
| Topic | Handbook |
|---|---|
| Runtime switching | themes.md — runtime switching (boot script, cookies, scheme API) |
| Capability ids | themes.md — capabilities |
| Runtime probe | ui_kernel_theme_capabilities() and injectable probe service — Twig helpers below |
| Overlay merge order | themes.md — overlays |
Theme inheritance (extends) |
themes.md — inheritance |
| Public milestone plan | themes.md — milestones |
Preview session CSS uses SessionThemeInjectionPort on designated preview hosts — see symfinity/ui-designer; the registry is not mutated.
Eight canonical colours (accent, neutral, …), appearances (solid, soft, ghost, …), and physics ids (flat, glass, retro) — see Themes and Configuration.
| Package | Role |
|---|---|
symfinity/ui-designer |
Author/import theme packs |
symfinity/ux-blocks-core |
Role CSS consuming kernel tokens |
symfinity/symfinity-docs |
Public handbook runtime |