docs(design): document design tokens + component inventory#40
Merged
Conversation
Capture the live calm-corporate design system as formal reference docs, sourced from src/index.css + tailwind.config.js (the source of truth). - Add .planning/design/system/tokens.md: full token reference (light + dark theme, all semantic roles with HSL + hex, status accents, special tokens, typography, spacing, radius, shadows, breakpoints, contrast). - Add .planning/design/system/components.md: inventory of 41 live components (21 shadcn primitives + 20 app-level) with page-pattern map. - Fix CLAUDE.md Styling Reference: values were stale after the reskin (--radius 0.375->0.5rem; --accent/--destructive/--muted-foreground/ --border/--input from cool hue 220 -> warm hue 30-40); link to tokens.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Formalizes the live calm-corporate design system into reference docs, and fixes stale token values in
CLAUDE.md.All values are read from the source of truth —
src/index.css(CSS custom properties) +tailwind.config.js— not invented or copied from a template.Changes
🆕
.planning/design/system/tokens.md— full token reference:success/warning/info), special tokens (zebra striping, per-BU chip identity)🆕
.planning/design/system/components.md— inventory of 41 live components (21 shadcn primitives + 20 app-level), grouped into 7 categories, with a component→page-pattern map✏️
CLAUDE.md— "Styling Reference" was stale after the calm-corporate reskin (PR feat(design): calm-corporate whole-app reskin (tokens + primitives + shell) #38). Corrected:--radius0.375rem0.5rem--accent220 14% 96%40 8% 94%--destructive0 84% 60%0 72% 51%--muted-foreground220 10% 46%33 5% 43%--border/--input220 15% 90%40 8% 90%/40 8% 87%Palette shifted from cool hue 220 → warm hue 30–40 during the reskin; the reference now matches and links to
tokens.md.Notes
index.css/tailwind.config.jsand must be kept in sync when those change (stated in the docs themselves).🤖 Generated with Claude Code