| name | forge-init |
| description | Generate a complete design system from a brand color and project type. Creates .forge.json with palette, tokens, type scale, spacing, shadows, and radii. This is the starting command — everything else references what it generates. |
| user-invokable | true |
/forge-init — Initialize Design System
Usage
/forge-init [hex-color] [project-type]
Example: /forge-init #e8590c saas
Project types: saas, portfolio, ecommerce, docs
What it generates
- Color palette: 11 shades (50-950) from the brand color
- Semantic tokens: surface, text, border, accent, feedback mapped to palette shades
- Type scale: mathematical ratio based on project type + font pairing
- Spacing scale: 4px base, 13 steps from 4 to 128
- Shadow system: 5 elevations tinted with brand hue
- Border radii: 6 steps scaled to project type
Output
Creates .forge.json in the project root. Every subsequent FORGE command reads this file.
Also outputs CSS custom properties to the console for immediate use.