Token pipeline (Style Dictionary v4, DTCG format): - Primitive tokens: colour palettes (brand, sage, neutral, feedback), typography (3 font families, 21-variant type scale), spacing (4px grid), border radius, shadows, opacity - Semantic tokens: text, surface, border, interactive, feedback colours; typography roles; layout spacing - Component tokens: Button (4 sizes), Input (2 sizes) - Generated outputs: CSS custom properties, JS ES6 module, flat JSON Atoms (3 components): - Button: contained/soft/outlined/text × primary/secondary, 4 sizes, loading state, underline for text variant - Typography: 21 variants across display/heading/body/label/caption/overline, maxLines truncation - Input: external label, helper text, error/success validation, start/end icons, required indicator, 2 sizes, multiline support Infrastructure: - MUI v5 theme with full token mapping - Storybook 8 with autodocs - Claude Code agents and skills for token/component workflows - Design system documentation and cross-session memory Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1.1 KiB
1.1 KiB
name, description
| name | description |
|---|---|
| sync-tokens | Rebuild CSS and JS outputs from token JSON sources |
Synchronise design tokens — rebuild CSS and JS outputs from token JSON sources.
Use this after token JSON files have been edited manually or after /create-tokens. This is a maintenance command — it does NOT create new tokens (use /create-tokens for that).
Use the token-architect agent to handle this task.
Instructions for the agent:
- Read
docs/memory/token-registry.mdto understand current token state - Validate all token JSON files have required fields (
$value,$type,$description) - Run
npm run build:tokensto regenerate:src/theme/generated/tokens.css(CSS custom properties)src/theme/generated/tokens.js(JS ES6 module)tokens/export/tokens-flat.json(flat JSON export)
- Check that
src/theme/index.tsis consuming the generated tokens correctly - If any tokens were added/changed since the theme was last updated, update
src/theme/index.ts - Report what was generated and any issues found
- Update
docs/memory/token-registry.mdif it's out of date