Configuration
The color-config.json file is the heart of your design system. It defines your semantic intent, and the solver uses it to generate your CSS.
Structure
Section titled “Structure”The configuration is divided into three main sections:
- Vibes: High-level presets that control the “physics” of the system.
- Anchors: The fixed points of lightness that define your contrast range.
- Groups & Surfaces: The semantic taxonomy of your UI.
{ "$schema": "node_modules/@axiomatic-design/color/color-config.schema.json", "vibes": { "mode": "default" }, "anchors": { ... }, "groups": [ ... ]}Vibes (Presets)
Section titled “Vibes (Presets)”Vibes are the easiest way to change the look and feel of your system without tweaking individual math parameters. They configure the underlying physics engine (hue shifting, chroma scaling, and contrast targets).
Add a vibes object to your config:
{ "vibes": { "mode": "vibrant" }}Customizing Colors
Section titled “Customizing Colors”To set your own brand colors, define them in the anchors section. This overrides the default hue for the system.
{ "anchors": { "brand": "#RRGGBB" }}Available Vibes
Section titled “Available Vibes”| Vibe | Description | Characteristics |
|---|---|---|
| default | Balanced and neutral. | Standard contrast, minimal hue shift. |
| vibrant | High energy and saturation. | Aggressive hue shifting, higher chroma surfaces. |
| corporate | Safe, blue-tinted, and professional. | Cool grays, high contrast text, conservative. |
| academic | Low chroma, high legibility. | Warm grays, serif-friendly, paper-like. |
Anchors
Section titled “Anchors”Anchors define the “Lightness Space” of your application. They tell the solver where “White” and “Black” are, and how much contrast is required for text.
See Physics of Light for a deep dive.
Groups & Surfaces
Section titled “Groups & Surfaces”Surfaces are organized into Groups (e.g., “Canvas”, “Objects”, “Actions”). This is purely for organization and does not affect the output CSS.
See Thinking in Surfaces for the mental model.