mdx-formatter
GitHub repository

Type to search...

to open search from anywhere

Full Token Reference

Full Token Reference

Sources of truth (zudo-doc 11.0.0, Graphite theme pack):

  • Package tokens: doc/node_modules/@takazudo/zudo-doc/dist/theme.css (plain :root custom properties; the zudoDoc() preset maps them to zudo-wind utility tokens)

  • Graphite palette and line/control-border roles: doc/node_modules/@takazudo/zudo-doc/dist/theme-packs/graphite/pack.css

  • Host overrides and playground classes: doc/src/styles/global.css (:root {} slot)

zudo-wind has no numeric spacing unit in this preset: only the named tokens below generate CSS.

Horizontal Spacing (hsp)

TokenValueTypical use
hsp-2xs0.125rem (2px)Tight inline padding
hsp-xs0.375rem (6px)Compact inline gaps
hsp-sm0.5rem (8px)Small buttons, small padding
hsp-md0.75rem (12px)Default gaps, list items
hsp-lg1rem (16px)Standard padding, larger gaps
hsp-xl1.5rem (24px)Generous padding, content edges
hsp-2xl2rem (32px)Large padding blocks

Vertical Spacing (vsp)

TokenValueTypical use
vsp-3xs0.25rem (4px)Hairline gaps
vsp-2xs0.4375rem (7px)Tight gaps
vsp-xs0.875rem (14px)Small gaps, list items
vsp-sm1.25rem (20px)Compact sections
vsp-md1.5rem (24px)Standard gap between blocks
vsp-lg1.75rem (28px)Section-to-section gap
vsp-xl2.5rem (40px)Large section gap
vsp-2xl3.5rem (56px)Page-level breaks

Icon Sizes

TokenValue
icon-xs0.75rem (12px)
icon-sm1rem (16px)
icon-md1.25rem (20px)
icon-lg1.5rem (24px)

Semantic Colors (Graphite)

Each --zd-* role is set with light-dark(light, dark) on html[data-theme-pack="graphite"]; utilities read them through --color-*.

TokenLightDarkUse
bg#F2F3F2#242629Page background
fg#3A4146#D3D5D9Main text
surface#E8EBEA#2D3034Panels, cards, header/footer
muted#566168#ADB2B8Secondary text, labels, placeholders
accent#9A4919#E9AA79Links, CTAs, active states, focus
accent-hover#934619#EAAF81Hover for accent
code-bg#E8EBEA#202225Code blocks, code textareas, inputs
code-fg#3A4146#D3D5D9Code text
success#4E6552#9DBA9APositive
danger#89504E#CE9B97Error
warning#775B2E#CEB077Caution
info#4B6373#9DB6C5Informational

Line and control-border roles

Graphite separates muted text from decorative lines and necessary control boundaries. These have no public token; the pack inlines them, and global.css mirrors them for the playground.

RoleLightDarkHost variable / class
line#D2D8DC#41464D--fp-line / .fp-line
control border#737D86#858D96--fp-control-border / .fp-control

Under any other pack both host variables fall back to color-mix(in oklab, var(--zd-muted) 30%, transparent).

Focus: Graphite draws outline: 2px solid var(--zd-accent) with a 3px offset on every :focus-visible element.

Typography

Font Families

  • font-sans: system-ui, sans-serif (Graphite loads no web fonts)

  • font-mono: ui-monospace, monospace

Font Sizes

TokenValuerem
text-micro12px0.75rem
text-caption14px0.875rem
text-small16px1rem
text-body19.2px1.2rem
text-title22.4px1.4rem
text-heading48px3rem
text-display60px3.75rem

Line Heights

TokenValue
leading-none1
leading-tight1.25
leading-snug1.375
leading-normal1.5
leading-relaxed1.625

Font Weights

TokenValue
font-normal400
font-medium500
font-semibold600
font-bold700

Border Radius

TokenValue
rounded0.25rem (4px)
rounded-lg0.5rem (8px)
rounded-full9999px

Breakpoints

TokenValueUse
sm:640pxTablet
lg:1024pxDesktop, sidebar appears
xl:1280pxWide desktop

Content Styling (.zd-content)

Applied to article elements by @takazudo/zudo-doc/content.css; selectors use :where() for zero specificity.

  • Flow spacing: blocks get margin-top: var(--flow-space, vsp-md)

  • Lists: padding-left: hsp-xl, li spacing vsp-xs

  • Code: font-mono; fenced code is highlighted at build time by zfb (hi-* classes resolved through --zd-syntax-*)

  • Admonitions: 4px left border in the state colour

Layout Constants

  • Header height: --zd-header-h 80px (anchor scroll-margin-top)

  • Sidebar width: --zd-sidebar-w clamp(14rem, 20vw, 22rem)