Colors documents text roles, action colors, feedback colors, structure tokens, and radii.
Color roles
Colors document meaning and contrast: text depth, inverse text, action color, status color, structure, and radius tokens. Neutral depth has its own Surfaces page so the z-axis model can be explained with examples.
Intent colors should describe what a state means, not how high it is. Use action, success, warning, destructive, and info tokens for product meaning; use surface levels when the interface needs spatial separation.
Text depth
--text-primaryDefault body, labels, headings, and high-emphasis text.
--text-secondarySupporting copy, helper text, captions, and quieter labels.
--text-tertiaryLow-emphasis metadata, hints, and decorative interface text.
--text-disabledUnavailable, disabled, or intentionally inactive text.
Text roles
--text-inverseText on inverse neutral surfaces.
--text-on-colorText on filled brand or action colors.
--text-linkLinks and navigational text affordances.
Actions
--actionPrimary brand and action color.
--action-secondaryLower-emphasis actions and neutral controls.
--accentSoft emphasis and selected states.
--destructiveDangerous or destructive actions.
--destructive-surfaceSoft destructive surfaces for status components.
--destructive-borderLower-chroma destructive borders and outlines.
Feedback
--successSuccessful states and positive confirmations.
--success-surfaceSoft success surfaces for status components.
--success-borderLower-chroma success borders and outlines.
--warningCautionary states that need attention.
--warning-surfaceSoft warning surfaces for status components.
--warning-borderLower-chroma warning borders and outlines.
--infoInformational states and neutral notices.
--info-surfaceSoft info surfaces for status components.
--info-borderLower-chroma info borders and outlines.
Structure
--borderBorders and separators.
--inputInput borders and field surfaces.
--ringFocus rings and active outlines.
--overlay-scrimModal and drawer scrims that dim inactive content.
Radii
--radiusBase corner radius used to derive the scale.
--radius-smSmall controls and compact nested elements.
--radius-mdDefault control radius.
--radius-lgCards, previews, and larger controls.
--radius-xlLarge surfaces and prominent panels.
--radius-2xlRoomier modal and sheet surfaces.
--radius-3xlMaximum radius for expressive large containers.
--radius-fullFully rounded pills, toggles, and circular controls.