Colors
The color system uses 13 tones (50–1200) per hue. Primary semantic families are used for UI meaning; accent families are reserved for charts/diagrams. All combinations target WCAG AA contrast.
Principles
Semantic Purpose
- Grey: Interface neutrals, text hierarchy
- Blue: Information, links, system feedback
- Green: Success states, positive actions
- Red: Errors and destructive actions
- Yellow: Warnings and cautionary notices
- Accent Hues: Lavender, Violet, Fuchsia, Magenta, Amber, Bronze, Olive, Teal — for charts/diagrams only
Accessibility Standards
- WCAG AA: 4.5:1 contrast for normal text; never rely on color alone
- Tone Scale: Consistent 13-step scale (50–1200) per hue for predictable contrast
- Color Blind Friendly: Patterns/labels recommended for charts
Defaults & Backgrounds
- Defaults: White = #ffffff; Black = #040404
- Page backgrounds: Use white (#ffffff) or tone 50 of a color family (default: grey-50)
- Card backgrounds: None, white, or tone 50. Use tone 50 on white backgrounds; use white on tone 50 backgrounds; no-background cards may be used on either.
- Emphasis: Apply a background (white or tone 50) when mild emphasis is desired; use no background when no special focus is needed.
Grey Scale (50–1200)
Grey is our foundation for backgrounds, borders, and text hierarchy.
Semantic Color Families
blue
Information, links, and system feedback.
green
Success states and positive actions.
red
Errors and destructive actions.
yellow
Caution, pending states, and highlights.
Secondary Accent Families (Charts & Diagrams)
lavender
Accent for charts/diagrams (not for core UI semantics).
violet
Accent for charts/diagrams (not for core UI semantics).
fuchsia
Accent for charts/diagrams (not for core UI semantics).
magenta
Accent for charts/diagrams (not for core UI semantics).
amber
Accent for charts/diagrams (not for core UI semantics).
bronze
Accent for charts/diagrams (not for core UI semantics).
olive
Accent for charts/diagrams (not for core UI semantics).
teal
Accent for charts/diagrams (not for core UI semantics).
Usage Guidelines
Do
- Use semantic families (blue/green/red/yellow) according to meaning
- Reserve accent families for charts, diagrams, and visual data
- Test contrast ratios before implementation
- Prefer grey tones for neutral interface areas and text hierarchy
Don't
- Use accent hues to represent core UI semantics
- Rely solely on color to convey information
- Create custom colors outside the system
- Use low-contrast combinations that fail WCAG AA
Accent Backgrounds (rare)
- Accents are primarily for diagrams/charts, but may be used sparingly as page or section backgrounds for special contexts (presentations, landing pages, themed events/booths).
- When an accent is used as a background, apply the same accessibility rules:
- Static text: use the background family's tone 1200
- Links: base tones by background (white=600, 50=700, 100=800, 200=900); hover/focus = tone 1000; active = #040404
- Clickable card borders: base 1px (white → tone 600, tone 50 → tone 700); hover/focus 2px tone 1000; active 2px #040404
- Keep accent backgrounds exceptional and purposeful; default backgrounds remain white or grey-50.