Files
stemengine_old/20260317_WebUI_Skins_Phase2_Checkpoint.md
T
2026-03-17 15:27:42 +09:00

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-bg
  • ui-surface
  • ui-surface-2
  • ui-border
  • ui-text
  • ui-text-muted
  • ui-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.