From 54710b35e98ab1ab48b23b0849306263cf25235f Mon Sep 17 00:00:00 2001 From: Bryan Van Deusen Date: Mon, 27 Apr 2026 18:05:47 -0400 Subject: [PATCH] docs(design-system): note foundation pass shipped; expand surface-phase thread MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updates the "Scribe-specific decisions in progress" header to reflect that the foundation pass landed in 7a9a8b7. Replaces the brief "next phase" placeholder with a concrete shipped/remaining split — listing what foundation covered and the surface-phase work that still needs doing (button reclassification, Lucide migration, border audit, voice/tone, long-form line-height, bubble shape tweaks). Co-Authored-By: Claude Opus 4.7 --- docs/design-system.md | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/docs/design-system.md b/docs/design-system.md index 4ad6795..d1db05e 100644 --- a/docs/design-system.md +++ b/docs/design-system.md @@ -362,7 +362,7 @@ If using Tailwind, extend the theme with these tokens rather than relying on def > This section tracks decisions made while adapting the FabledSword baseline above for Scribe specifically. Items here are *in progress* — once they feel solid, they get folded into the main body of the document (either as Scribe-specific extensions in the per-app section, or as updates to the universal rules where Scribe's needs reveal a gap in the baseline). -*Iteration started: 2026-04-26.* +*Iteration started: 2026-04-26. Foundation pass shipped 2026-04-27 in `7a9a8b7` — palette, fonts, light mode, action tokens, hardcoded indigo cleanup, warm-gold deprecation. Surface phase (button reclassification, border audit, Lucide migration, voice/tone) tracked in a separate spec.* ## Decisions made so far @@ -531,4 +531,21 @@ Border weight is not load-bearing for Scribe — happy to use the doc's 0.5px ha ## Open threads (next iterations) -*All initial-iteration threads resolved. Next phase is the polish pass — applying the system to existing UI, component by component. New threads will accumulate here as we discover gaps in the polish pass.* +### Foundation pass — shipped 2026-04-27 (`7a9a8b7`) + +Mechanical token + font + light-mode rewrite of `frontend/src/assets/theme.css`, plus a sweep of hardcoded indigo and `--color-accent-warm` references across ~14 component files. Action tokens (`--color-action-primary` Moss, `--color-action-secondary` Bronze, `--color-action-destructive` Oxblood, `--color-action-ghost-border` Pewter) are defined but not yet applied — buttons still flow through `--color-primary` and read as dusty-violet gradients in the meantime, by design. Spec lives at `docs/superpowers/specs/2026-04-27-design-system-polish-foundation-design.md` (gitignored, local-only). + +### Surface phase — next + +Per-component work, picked up surface-by-surface: + +- Button reclassification per the Hybrid rule — for each button decide brand moment (accent) vs Moss / Bronze / Oxblood / Pewter, swap to the appropriate `--color-action-*` token +- Lucide icon migration (~16 files, 30–60 swaps) — install `lucide-vue-next`, replace hand-inlined SVGs, enforce 16/24px scale and 1/1.5 stroke weights +- Border placement audit per the structural-not-decorative rule — strip from list rows, inline `ToolCallCard` inside chat bubbles, filter chips, empty-state callouts +- Voice/tone copy touchups, opportunistic as components are touched +- 3 emoji-as-icons replaced with Lucide equivalents +- Long-form 1.7 line-height applied to Notes viewer, Journal entries, assistant chat bubbles +- Bubble shape tweaks (radius asymmetry, tail) if needed beyond the foundation recolor +- Per-component scoped-CSS font-family declarations cleaned up opportunistically + +A surface-phase design spec gets written when the work begins. New threads will accumulate here as gaps surface during application.