2.6 KiB
2026-03-17 — WebUI Skins Phase 2 (Checkpoint)
Objective
Continue post-Phase-1 migration by moving high-traffic shell components from hardcoded light/dark utility colors to semantic token-backed classes so all new skins affect core navigation surfaces.
Implemented in this checkpoint
1) Semantic utility classes added
In frontend/src/index.css, added token-backed utility classes:
ui-bgui-surfaceui-surface-2ui-borderui-textui-text-mutedui-focus-ring(focus-visible outline via--ui-focus)
These utilities are powered by Phase-1 semantic CSS variables and can be adopted incrementally.
2) App shell migrated (core frame)
In frontend/src/App.tsx, migrated key layout/surface text classes:
- Header surface/border now token-driven
- Main app background now
ui-bg - Primary content card now token-driven
- Footer text now token-driven
- Inactive utility icon buttons moved to token-driven text/background/border
3) Quick settings modal migrated
In frontend/src/components/SettingsPanel.tsx, migrated major shell styles:
- Modal panel surface + borders
- Header text + icon text
- Theme button inactive states
- Full Settings row and supporting text
4) Global audio bar migrated
In frontend/src/components/GlobalAudioBar.tsx, migrated:
- Bar shell surface + border
- Timer/title text colors
- Volume section divider
- Mute/close icon text colors
5) Sidebar shell partially migrated
In frontend/src/components/Sidebar.tsx, migrated key frame sections:
- Sidebar container surface + border
- Toggle button shell
- Collapsed strip icon text
- Active jobs section divider/empty text
- Projects counter text
- Project search icon/input/clear button
- Empty-state text
What remains for later Phase 2 passes
- Finish migrating remaining Sidebar row components (
ActiveJobItem,ProjectItem, Subsonic search/import cards). - Migrate additional pages (
Separator,ProjectDetail, deep Settings forms) from static slate/gray classes to semantic token classes. - Introduce tokenized status badge variants where beneficial.
Compatibility notes
- Existing light/dark/system behavior still works through
ThemeContext. - Accent colors remain unchanged and continue to control
brand-*usage. - Skin and readability settings from Phase 1 continue to persist and rehydrate.
- No TypeScript/CSS diagnostics were introduced by this checkpoint.
Summary
Phase 2 has started with the highest-impact shell components. The app frame now responds to skin tokens consistently, reducing the visual delta between skins and preparing deeper page-level migration.