Create design system
kaava_create_systemGenerate a complete, contrast-checked design system from a brand color and optional style, save it as kaava.json, and return a summary and contrast report for token emission.
Instructions
Generate a complete design system from a short brief and save it as kaava.json in the project root. Only brandColor is required; style picks a hand-authored character for the rest (read kaava://styles for what each one is). Returns a summary and a contrast report. Follow with kaava_emit to write tokens for the project stack.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"brandColor": "<brandColor>"
},
"name": "kaava_create_system"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name of the design system or product. | |
| fonts | No | Font families. A single name ("Inter") gets a system fallback stack appended; a comma-separated value is used as the full stack. `display` is for headings and defaults to `sans`. | |
| style | No | A hand-authored style that decides the character of the system: ramp shape, typography, spacing rhythm, corners, elevation, motion. The fields below override single aspects of it; leave them out to keep the style as designed. | |
| accent | No | Secondary accent color (CSS color). Omit to derive one from the brand hue according to the style. | |
| dryRun | No | Return the content that would be written instead of writing files. | |
| radius | No | Replace the style's corner rounding with a generic scale. "full" gives pill-shaped controls. | |
| density | No | Control sizes and spacing rhythm. Default: the density the style was designed for. | |
| shadows | No | Replace the style's shadows with a generic recipe, or "none" for a flat system. | |
| darkMode | No | Generate a dark theme. Default true. | |
| overwrite | No | Replace an existing kaava.json. Without this, an existing system is left untouched. | |
| typeScale | No | Replace the style's type sizes with a modular scale of this ratio. 1.125 = tight/dense UI, 1.2 = balanced, 1.333 = expressive/editorial. | |
| brandColor | Yes | Primary brand color in any CSS syntax: "#4f46e5", "rgb(79 70 229)", "oklch(0.55 0.2 270)", "rebeccapurple". | |
| description | No | One or two sentences on what the product is and who it is for. | |
| neutralTint | No | How much of the brand hue tints the greys. 0 = pure grey, 1 = clearly tinted. | |
| projectRoot | No | Absolute path of the project. Defaults to the first workspace root the client exposes, else the server working directory. |