← Back to Design System

Color Space & Typography

Complete color palette, contrast rules, type scale, and syntax highlighting — every variable, every value

01

Complete Color Palette

Every CSS variable in the design system with its hex value. Grouped by function — from primary colors through backgrounds to semantic colors and chart colors.

Primary (3)

--color-deep-blue#000099
--color-impulse-orange#FE8F11
--color-warm-gray#E4DAD4

Backgrounds (3)

--color-bg#FFFFFF
--color-bg-warm#F3EFEB
--color-bg-code#000066

Text (3)

--color-text#1A1A2E
--color-text-secondary#5C5A6B
--color-text-muted#6B6778

Borders & Surfaces (4)

--color-border#E4DAD4
--color-border-light#EDE8E4
--color-surface#FFFFFF
--color-surface-warm#F8F5F2

Accent (4)

--color-accent#FE8F11
--color-accent-hover#E57D00
--color-accent-light#FFF3E5
--color-accent-muted#FEB85C

Semantic (8)

--color-success#84C041
--color-success-light#EFF7E5
--color-error#CC0000
--color-error-light#FFE5E5
--color-info#1195EB
--color-info-light#E5F2FC
--color-warning (alias)#FE8F11
--color-warning-light#FFF3E5

Actor Colors (6)

--actor-orchestrator#000099
--actor-pipeline#FE8F11
--actor-file-agent#84C041
--actor-validator#1195EB
--actor-error#CC0000
--actor-user#5BE3D6

Chart Colors (6)

--chart-1#000099
--chart-2#FE8F11
--chart-3#84C041
--chart-4#5BE3D6
--chart-5#FEB85C
--chart-6#7B7BA0
02

Contrast Rules in Detail

WCAG AA requires at least 4.5:1 for normal text and 3:1 for large text. Here are the forbidden combinations and their corrected values.

Critical Fix: --color-text-muted

BEFORE (failed)

This text uses #9995A0 on white

Ratio: 2.8:1 — FAIL AA
AFTER (corrected)

This text uses #6B6778 on white

Ratio: 5.1:1 — PASS AA

Forbidden Combinations

Combination Ratio Status
#FFFFFF on #F3EFEB1.1:1FORBIDDEN
#FFFFFF on #F8F5F21.1:1FORBIDDEN
#E4DAD4 on #FFFFFF1.5:1FORBIDDEN (as text)
#FEB85C on #FFFFFF2.1:1FORBIDDEN (as text)
#84C041 on #FFFFFF2.7:1FORBIDDEN (as text)

Rule of thumb: For body text, always use --color-text (#1A1A2E) or --color-text-secondary (#5C5A6B). Light colors like orange or green only for accents (badges, icons, borders) — never as text color on light backgrounds.

03

Typography Scale

The complete type scale from --text-xs (.75rem) to --text-6xl (3.75rem). Each step with its use case.

--text-xs
.75rem / 12px
Badges, labels, monospace meta
--text-sm
.875rem / 14px
Secondary text, breadcrumbs, card descriptions
--text-base
1rem / 16px
Body text, paragraphs, quiz options
--text-lg
1.125rem / 18px
Lead text, card titles, quiz titles
--text-xl
1.25rem / 20px
Hero subtitles, section introductions
--text-2xl
1.5rem / 24px
Sub-headings
--text-3xl
1.875rem / 30px
Large section titles
--text-4xl
2.25rem / 36px
Module titles (.module-title)
--text-5xl
3rem / 48px
Hero titles (L1–L3)
--text-6xl
3.75rem / 60px
Module numbers (01, 02 ...)

Font Weight Assignments

Context Font Weight Line-Height
Hero Title--font-display800--leading-tight (1.15)
Module Title--font-display700--leading-tight (1.15)
Card Title--font-display600--leading-normal (1.6)
Body Text--font-body400--leading-normal (1.6)
Code / Mono--font-mono400–6001.8 (code blocks)
04

Syntax Highlighting

Code blocks use --color-bg-code (#000066) as background. Not black, not charcoal — Deep Navy Blue. Here are all highlight classes.

keyword
.kw#FEB85C
string
.str#84C041
function
.fn#5BE3D6
comment
.cm#7B7BA0
number
.nr#FDC83A
default
(base color)#D0D0E8

Example with all classes

// Example: File Agent configuration
const createFileAgent = (config) => {
  const agent = {
    filename:  "colorspace-typography_dev_en.html",
    audience:  "dev",
    level:     2,
    hs_score:  7,   // no L3 deep dive
    sections:  4,
  };

  // Validation: check WCAG AA
  if (contrastRatio(agent.textColor, agent.bgColor) < 4.5) {
    throw new Error("WCAG AA contrast not met");
  }

  return agent;
};
✏️ Quick Check

What is the background color for code blocks?

#000000 — pure black
#000066 — Deep Navy Blue
#1A1A2E — the main text color
#333333 — charcoal