Mirror the ChicoryTV design system to prod (Claude Design ↔ shipped SPA) #388

Closed
opened 2026-07-17 00:03:06 +02:00 by timothy · 2 comments
Owner

Bring the Claude Design prototype (ChicoryTV Design System, project eb3b6122, mirrored in design-system/) into line with the actual shipped SPA on main (web/src/screens/*). Relates to #59 / #92 (design-sync).

Why

The design-system/ prototypes are the original design-time references (#92/#93). Prod has moved far past them across dozens of parity/feature PRs, and prototypes were never back-synced — so Claude Design no longer reflects the app (e.g. Settings looks nothing like live Settings). Policy decided 2026-07-16: mirror — the design system should faithfully reflect prod. Executed as a single full sweep in PR #394 (operator asked to sync the whole design in one go), since these are mockups.

Approach (per session)

Pick a few screens, rebuild/author each prototype (design-system/templates/chicorytv-admin/<Screen>.jsx) to match the current web/src/screens/<Screen>.tsx + rendered app, wire into app.html + Shell nav, verify in-browser (3 themes), push to Claude Design (DesignSync), commit design-system/ on the branch. Prototypes are simplified UI-kit demos — faithful visual/layout parity, not full logic.

Inventory — 41 shipped screens

A. Prototype exists but STALE — rebuild to current prod (8)

  • Dashboard (DashboardScreen)
  • Channels (ChannelsScreen) — kept as the gold reference (already current); not re-authored
  • New Channel / builder (builder/ChannelBuilder)
  • Guide (GuideScreen ⇄ prototype Epg) — rebuilt as Guide.jsx, Epg.jsx retired
  • Schedules (SchedulesScreen ⇄ prototype ScheduleEditor) — rebuilt as Schedules.jsx, ScheduleEditor.jsx retired
  • Playouts (PlayoutsScreen)
  • Settings (SettingsScreen)
  • Reconcile orphan prototype ScheduleLibrary — retired (no 1:1 prod screen)

A′. Current (just synced, no action)

  • Auto-Tune (AutoTuneScreen) — synced 2026-07-16 (#69).

B. No prototype yet — build from prod (32)

  • Channels: [x] ChannelEdit
  • Scheduling: [x] Blocks · [x] Templates · [x] Decos · [x] DecoTemplates · [x] PlayoutScheduleEditors
  • Media: [x] MediaBrowse · [x] MediaDetail · [x] Search · [x] Collections · [x] MultiCollections · [x] RerunCollections · [x] Playlists · [x] FillerPresets · [x] Libraries · [x] LocalLibraryEdit · [x] ImageBrowser · [x] TraktLists · [x] Trash · [x] PathReplacementsEdit
  • Sources: [x] PlexSource · [x] RemoteSource · [x] RemoteConnectionEdit · [x] RemoteLibrariesEdit
  • System: [x] FFmpegProfiles · [x] Watermarks · [x] Logs · [x] ApiKey · [x] Troubleshooting · [x] PlaybackTroubleshooting · [x] BlockPlayoutTroubleshooting · [x] YamlValidator
  • Auth/onboarding: [x] Login · [x] Setup

Notes

  • Inventory is approximate (some prod screens are sub-editors of a nav entry); refine per screen when picked up.
  • Each screen: after pushing, tick its box here. Consider a small design_handoff_<screen>/ only where useful.
  • Non-blocking, incremental; does not gate any feature work.
  • Done in one sweep (PR #394): sub-editors (ChannelEdit, source editors, Login/Setup, etc.) live in a design-kit-only "Editors & auth" nav section since prod reaches them via sub-paths. Mockups = visual/layout parity; some rich screens approximate DS-kit-absent primitives (async pickers, dialogs) — noted per-file. Refinement of any individual screen can be a follow-up.

Done-when

  • Every section-A prototype matches current prod
  • Every section-B screen has a prototype in Claude Design
  • design-system/ committed + pushed to eb3b6122 in step with each screen
Bring the **Claude Design** prototype (`ChicoryTV Design System`, project `eb3b6122`, mirrored in `design-system/`) into line with the **actual shipped SPA on `main`** (`web/src/screens/*`). Relates to #59 / #92 (design-sync). ## Why The `design-system/` prototypes are the *original* design-time references (#92/#93). Prod has moved far past them across dozens of parity/feature PRs, and prototypes were never back-synced — so Claude Design no longer reflects the app (e.g. Settings looks nothing like live Settings). Policy decided 2026-07-16: **mirror** — the design system should faithfully reflect prod. Executed as a **single full sweep** in PR #394 (operator asked to sync the whole design in one go), since these are mockups. ## Approach (per session) Pick a few screens, rebuild/author each prototype (`design-system/templates/chicorytv-admin/<Screen>.jsx`) to match the **current** `web/src/screens/<Screen>.tsx` + rendered app, wire into `app.html` + Shell nav, verify in-browser (3 themes), push to Claude Design (`DesignSync`), commit `design-system/` on the branch. Prototypes are simplified UI-kit demos — faithful **visual/layout** parity, not full logic. ## Inventory — 41 shipped screens ### A. Prototype exists but STALE — rebuild to current prod (8) - [x] Dashboard (`DashboardScreen`) - [x] Channels (`ChannelsScreen`) — kept as the gold reference (already current); not re-authored - [x] New Channel / builder (`builder/ChannelBuilder`) - [x] Guide (`GuideScreen` ⇄ prototype `Epg`) — rebuilt as `Guide.jsx`, `Epg.jsx` retired - [x] Schedules (`SchedulesScreen` ⇄ prototype `ScheduleEditor`) — rebuilt as `Schedules.jsx`, `ScheduleEditor.jsx` retired - [x] Playouts (`PlayoutsScreen`) - [x] Settings (`SettingsScreen`) - [x] Reconcile orphan prototype `ScheduleLibrary` — **retired** (no 1:1 prod screen) ### A′. Current (just synced, no action) - Auto-Tune (`AutoTuneScreen`) — synced 2026-07-16 (#69). ### B. No prototype yet — build from prod (32) - Channels: [x] ChannelEdit - Scheduling: [x] Blocks · [x] Templates · [x] Decos · [x] DecoTemplates · [x] PlayoutScheduleEditors - Media: [x] MediaBrowse · [x] MediaDetail · [x] Search · [x] Collections · [x] MultiCollections · [x] RerunCollections · [x] Playlists · [x] FillerPresets · [x] Libraries · [x] LocalLibraryEdit · [x] ImageBrowser · [x] TraktLists · [x] Trash · [x] PathReplacementsEdit - Sources: [x] PlexSource · [x] RemoteSource · [x] RemoteConnectionEdit · [x] RemoteLibrariesEdit - System: [x] FFmpegProfiles · [x] Watermarks · [x] Logs · [x] ApiKey · [x] Troubleshooting · [x] PlaybackTroubleshooting · [x] BlockPlayoutTroubleshooting · [x] YamlValidator - Auth/onboarding: [x] Login · [x] Setup ## Notes - Inventory is approximate (some prod screens are sub-editors of a nav entry); refine per screen when picked up. - Each screen: after pushing, tick its box here. Consider a small `design_handoff_<screen>/` only where useful. - Non-blocking, incremental; does not gate any feature work. - **Done in one sweep (PR #394)**: sub-editors (ChannelEdit, source editors, Login/Setup, etc.) live in a design-kit-only "Editors & auth" nav section since prod reaches them via sub-paths. Mockups = visual/layout parity; some rich screens approximate DS-kit-absent primitives (async pickers, dialogs) — noted per-file. Refinement of any individual screen can be a follow-up. ## Done-when - [x] Every section-A prototype matches current prod - [x] Every section-B screen has a prototype in Claude Design - [x] `design-system/` committed + pushed to `eb3b6122` in step with each screen
timothy added the enhancementpriority: mediumfrontend labels 2026-07-17 00:03:06 +02:00
timothy added this to the Design system (Claude Design ↔ prod) milestone 2026-07-17 00:25:06 +02:00
timothy added the in-progress label 2026-07-17 00:49:02 +02:00
Author
Owner

Claiming — attempting a full single-session sweep of the whole inventory (operator asked to sync the whole design in one go).

Approach: since these are mockups (visual/layout parity, no backend/logic), fanning the authoring out with a multi-agent workflow — one agent per screen authors a self-contained prototype JSX on the UI-kit primitives from the live web/src/screens/<X>.tsx + reference (Channels.jsx). Orchestrator then does the single-writer wiring (Shell.jsx nav mirrored to prod's routes.tsx groups + app.html script tags/screens map), headless-Playwright render-check across the 3 themes, DesignSync push, and commit on feat/388-design-mirror.

Confirmed against the official Claude Design docs that our design-system/ mirror + DesignSync per docs/design-sync.md is the documented /design-sync workflow (no special bulk-import format). Nav/screen inventory taken from the authoritative web/src/app/routes.tsx (33 top-level routes in Primary/Media/System groups + sub-editors).

Claiming — attempting a **full single-session sweep** of the whole inventory (operator asked to sync the whole design in one go). Approach: since these are **mockups** (visual/layout parity, no backend/logic), fanning the authoring out with a multi-agent workflow — one agent per screen authors a self-contained prototype JSX on the UI-kit primitives from the live `web/src/screens/<X>.tsx` + reference (`Channels.jsx`). Orchestrator then does the single-writer wiring (`Shell.jsx` nav mirrored to prod's `routes.tsx` groups + `app.html` script tags/screens map), headless-Playwright render-check across the 3 themes, `DesignSync` push, and commit on `feat/388-design-mirror`. Confirmed against the official Claude Design docs that our `design-system/` mirror + `DesignSync` per `docs/design-sync.md` **is** the documented `/design-sync` workflow (no special bulk-import format). Nav/screen inventory taken from the authoritative `web/src/app/routes.tsx` (33 top-level routes in Primary/Media/System groups + sub-editors).
timothy added a new dependency 2026-07-17 01:27:52 +02:00
timothy removed the in-progress label 2026-07-17 03:27:31 +02:00
Author
Owner

✅ Closed by PR #394 (rebase-merged to main, CI green).

What was done — full single-session mirror sweep of the entire inventory (operator asked to sync the whole design in one go; OK'd for mockups):

  • 40 prototype mockups authored via a 40-agent fan-out workflow (model-tiered haiku/sonnet by complexity, 0 failures). 7 stale rebuilt + ScheduleLibrary retired; 32 net-new. Channels kept as the gold reference; Auto-Tune already current (#69).
  • New structure: screens.js is the single source of truth for the screen inventory — Shell.jsx nav + app.html screen-map both build from it, nav groups mirror web/src/app/routes.tsx, app.html is hash-routed.
  • Verified: 42 views × 3 themes rendered headlessly (Playwright) — 126/126, 0 real render errors; spot-checked Settings / Guide EPG / Login for fidelity.
  • Pushed to Claude Design (eb3b6122): 46 files written, 3 retired deleted. Operator confirmed it looks good.

Drift prevention (going forward): added .claude/hooks/design-sync-reminder.sh — a mechanical, fail-open, once-per-session hook keyed on the web/src/**.{tsx,css} fileset. PreToolUse (first UI edit) → pull-first nudge; Stop (UI file changed) → mirror/push-back nudge. So the mirror is now a maintained baseline, not a backlog. Cold-reviewed (MERGEABLE, no blockers, fail-open verified empirically).

Docs: docs/design-sync.md updated (bulk-sweep structure + the reminder hook).

Deferred / follow-ups (none blocking): per-screen fidelity refinement where a mockup approximated a DS-kit-absent primitive (async pickers, dialogs) is a per-file follow-up; a couple of cosmetic hook notes from review (mount-guard has no retry cap — pre-existing; TEST_RE doesn't match __tests__//.spec.) left as-is since the hook only ever nudges. No new issues filed.

✅ **Closed by PR #394** (rebase-merged to `main`, CI green). **What was done** — full single-session mirror sweep of the entire inventory (operator asked to sync the whole design in one go; OK'd for mockups): - **40 prototype mockups authored** via a 40-agent fan-out workflow (model-tiered haiku/sonnet by complexity, 0 failures). 7 stale rebuilt + `ScheduleLibrary` retired; 32 net-new. Channels kept as the gold reference; Auto-Tune already current (#69). - **New structure**: `screens.js` is the single source of truth for the screen inventory — `Shell.jsx` nav + `app.html` screen-map both build from it, nav groups mirror `web/src/app/routes.tsx`, `app.html` is hash-routed. - **Verified**: 42 views × 3 themes rendered headlessly (Playwright) — **126/126, 0 real render errors**; spot-checked Settings / Guide EPG / Login for fidelity. - **Pushed to Claude Design** (`eb3b6122`): 46 files written, 3 retired deleted. Operator confirmed it looks good. **Drift prevention (going forward)**: added `.claude/hooks/design-sync-reminder.sh` — a mechanical, fail-open, once-per-session hook keyed on the `web/src/**.{tsx,css}` fileset. PreToolUse (first UI edit) → *pull-first* nudge; Stop (UI file changed) → *mirror/push-back* nudge. So the mirror is now a maintained baseline, not a backlog. Cold-reviewed (MERGEABLE, no blockers, fail-open verified empirically). **Docs**: `docs/design-sync.md` updated (bulk-sweep structure + the reminder hook). **Deferred / follow-ups** (none blocking): per-screen fidelity refinement where a mockup approximated a DS-kit-absent primitive (async pickers, dialogs) is a per-file follow-up; a couple of cosmetic hook notes from review (mount-guard has no retry cap — pre-existing; `TEST_RE` doesn't match `__tests__/`/`.spec.`) left as-is since the hook only ever nudges. No new issues filed.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: timothy/ersatztv#388