Skip to content

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.

The configuration is divided into three main sections:

  1. Vibes: High-level presets that control the “physics” of the system.
  2. Anchors: The fixed points of lightness that define your contrast range.
  3. Groups & Surfaces: The semantic taxonomy of your UI.
{
"$schema": "node_modules/@axiomatic-design/color/color-config.schema.json",
"vibes": {
"mode": "default"
},
"anchors": { ... },
"groups": [ ... ]
}

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"
}
}

To set your own brand colors, define them in the anchors section. This overrides the default hue for the system.

{
"anchors": {
"brand": "#RRGGBB"
}
}
VibeDescriptionCharacteristics
defaultBalanced and neutral.Standard contrast, minimal hue shift.
vibrantHigh energy and saturation.Aggressive hue shifting, higher chroma surfaces.
corporateSafe, blue-tinted, and professional.Cool grays, high contrast text, conservative.
academicLow chroma, high legibility.Warm grays, serif-friendly, paper-like.

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.

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.