01 · COLOR TOKENS

Dual-theme color system

Every color is a token. Switch themes by setting data-theme="light" or data-theme="dark" on the body. Zero hardcoded colors in components.

Surface ramp

0
1
2
3

4-level depth: page > card > hover > elevated

Accent

gold
hover
active

3 interaction states for the primary accent

Semantic

ok
err
warn
info

4 semantic colors with bg + border variants

TokenDark valueLight valueUsage
--surface-0#0A0806#FAF7F2Page background
--surface-1#12100C#F2EDE5Cards, panels
--surface-2#1A1712#E8E2D8Hover, elevated
--gold#C8A96E#A88A50Primary accent
--text-primary#F5F0EB#1A1712Body text
--text-secondary#A09890#5A5249Descriptions
02 · TYPOGRAPHY

Modular type scale

DISPLAY

64px

Cormorant 500 / 1.05 / -.02em — hero only

H1

48px

Cormorant 500 / 1.1 — page titles

H2

36px

Cormorant 500 / 1.15 — sections

H3

28px

Cormorant 500 / 1.2 — cards

H4

22px

Hanken 600 / 1.3 — subsections

LEDE

18px body large

Hanken 400 / 1.6 — intro paragraphs

BODY

16px default body text

Hanken 300 / 1.65 — default

CAPTION

12px caption text

Hanken 500 / 1.4 — labels

OVERLINE11px eyebrow

Mono 600 / 1.3 / .12em — uppercase labels

03 · SPACING & RADIUS

4px base spacing scale

TokenValueUsage
--sp-14pxInline gaps, icon padding
--sp-28pxSmall gaps, badge padding
--sp-312pxInput padding
--sp-416pxDefault gap, card inner
--sp-624pxCard padding, field gaps
--sp-832pxSection sub-gap
--sp-1248pxHero padding
--sp-1664pxSection vertical
--sp-2496pxLarge section vertical
RadiusValueUsage
--r-sm4pxBadges, small chips
--r-md8pxButtons, inputs
--r-lg12pxLarge buttons
--r-xl16pxCards, modals
04 · BUTTONS

Button system

05 · CARDS

Card variants

$32BMerger
130+Agents
1,147Modules
159Tests
ENGINE

Anti-Crowd

26 strategies, 25 dimensions each.

GLASS

Glassmorphic

Backdrop blur with frosted effect.

STANDARD

Standard card

Default surface with hover lift.

06 · FORM INPUTS

Forms with golden focus

Enable notifications
07 · INTERACTIVE COMPONENTS

Tabs, accordion, progress, alerts

Tab 1 content — overview of the system.

PROGRESS
[PASS]All tests passing.
[INFO]New deployment ready.
[FAIL]Proof gate blocked.
MIT License v10 Python TypeScript Docker
08 · IMAGE & BACKGROUND RULES

Background imagery standards

TechniqueHowWhen
Full-bleed heroopacity:.35 + gradient overlay top/bottomPage hero sections
Card backgroundopacity:.5 + bottom gradient to surface-0Image cards
Section dividerFull-width image at opacity:.3Between major sections
Side overlayLinear gradient from surface-0 left to transparentText over image, left-aligned
Parallaxbackground-attachment:fixed (desktop only)Story sections

Image composition rules

1. Always use gradient overlay — never place text directly on an image without a scrim.
2. Maximum image opacity behind text: .50 (dark) / .30 (light theme).
3. Hero images: 16:9 or wider, min 1920px source resolution.
4. Card images: 16:9, object-fit:cover, bottom gradient required.
5. Always set explicit width/height or aspect-ratio to prevent layout shift.
6. Use loading="lazy" on below-fold images, loading="eager" on hero.
7. Prefer WebP format. JPEG fallback. Never PNG for photos (too large).
8. Maximum file size: 200KB per image after compression.

09 · DESIGN RULES

What's allowed vs forbidden

ALLOWED

OKUse CSS custom properties for all colors
OKGold accent max 15% of visible area
OKSerif for headlines, sans for body, mono for data
OKNumbers always in JetBrains Mono with tabular-nums
OK4px spacing grid — no arbitrary values
OKBorder radius from the 4-level scale only
OKShadows from the 5-level elevation system
OKGlassmorphism via backdrop-filter on elevated surfaces
OKGradient overlays on all image+text combinations
OKclamp() for all responsive font sizes
OKprefers-reduced-motion respected everywhere

FORBIDDEN

NOHardcoded hex colors — always use tokens
NOEmojis in UI — use text labels or CSS shapes
NOGold as a large fill — accent only
NOSans-serif for headlines — headlines are serif
NOText directly on images without gradient scrim
NOArbitrary spacing — use the 4px scale
NOMore than 3 font weights per page section
NOBox shadows not from the elevation system
NOFixed pixel font sizes — use clamp() or rem
NOInline styles for colors — use classes/tokens
NOz-index above 9999 (reserved for system)
10 · RESPONSIVE BREAKPOINTS

4-tier breakpoint system

NameRangeContainerGridBehavior
Mobile0 - 639px100% - 2rem padding1 columnStack all grids, hide secondary nav
Tablet640 - 767px100% - 3rem padding2 columnsShow secondary elements
Desktop768 - 1023px1100px max3 columnsFull layout
Wide1024px+1400px max4 columnsFull layout + wide mode

RIG Design System v3

Dual-theme (light + dark) · 10 sections · Zero emojis · 4px spacing grid · Modular type scale

Use data-theme="light" or data-theme="dark" on body to switch.