Skip to Content
drksci
System

Tokens

Design tokens in three tiers, rendered from the token source.

Components read component tokens, component tokens point at semantic roles, and semantic roles point at primitive scales or at a Fumadocs --color-fd-* variable. A theme is one file in src/tokens/themes; bun run gen:tokens writes the stylesheet and a JSON export from it, and a test fails when either is stale.

Type and space steps are fluid: each is a clamp() between its value at a 360px viewport and its value at 1440px.

Stock Fumadocs colours and fonts with fluid editorial scales.

Primitive

Space scale

TokenValueSample
--ds-space-10.25rem
--ds-space-20.5rem
--ds-space-3clamp(0.75rem, 0.6667rem + 0.3704vw, 1rem)
--ds-space-4clamp(1rem, 0.8333rem + 0.7407vw, 1.5rem)
--ds-space-5clamp(1.5rem, 1.1667rem + 1.4815vw, 2.5rem)
--ds-space-6clamp(2.5rem, 2rem + 2.2222vw, 4rem)
--ds-space-7clamp(4rem, 3rem + 4.4444vw, 7rem)
--ds-space-8clamp(6rem, 4.6667rem + 5.9259vw, 10rem)

Type scale

TokenValueSample
--ds-step--1clamp(0.8125rem, 0.7917rem + 0.0926vw, 0.875rem)Ag
--ds-step-0clamp(1rem, 0.9792rem + 0.0926vw, 1.0625rem)Ag
--ds-step-1clamp(1.125rem, 1.0625rem + 0.2778vw, 1.3125rem)Ag
--ds-step-2clamp(1.3125rem, 1.1875rem + 0.5556vw, 1.6875rem)Ag
--ds-step-3clamp(1.5rem, 1.25rem + 1.1111vw, 2.25rem)Ag
--ds-step-4clamp(1.875rem, 1.5rem + 1.6667vw, 3rem)Ag
--ds-step-5clamp(2.25rem, 1.6667rem + 2.5926vw, 4rem)Ag
--ds-step-6clamp(3rem, 1.6667rem + 5.9259vw, 7rem)Ag

Font families

TokenValueSample
--ds-font-sansvar(--font-sans)Hamburgefonstiv
--ds-font-serifvar(--font-serif)Hamburgefonstiv
--ds-font-monovar(--font-mono)Hamburgefonstiv

Leading, weight and tracking

TokenValue
--ds-leading-tight1.08
--ds-leading-snug1.3
--ds-leading-body1.65
--ds-weight-regular400
--ds-weight-medium500
--ds-weight-bold600
--ds-tracking-tight-0.025em
--ds-tracking-wide0.04em

Measures

TokenValueSample
--ds-measure-note10rem
--ds-measure-breakout12rem
--ds-measure-tile16rem
--ds-measure-half18rem
--ds-measure-body38rem

Radii and ratios

TokenValue
--ds-radius-00
--ds-radius-10.5rem
--ds-ratio-square1
--ds-ratio-tall4 / 5
--ds-ratio-classic3 / 2
--ds-ratio-wide16 / 9
--ds-ratio-plate21 / 9

Line weights

TokenValue
--ds-line-hair1px
--ds-line-bold2px

Plotter pens

TokenValueSample
--ds-pen-pink#ff2e7e
--ds-pen-blue#2d5bff
#6f8dff in dark
--ds-pen-teal#00a99d
--ds-pen-amber#ffaa00
--ds-pen-violet#7b3cff
#a47bff in dark
--ds-blend-overprintmultiply
screen in dark

Semantic

Colour roles

TokenValueSample
--ds-color-papervar(--color-fd-background)
--ds-color-inkvar(--color-fd-foreground)
--ds-color-mutevar(--color-fd-muted-foreground)
--ds-color-sunkenvar(--color-fd-muted)
--ds-color-raisedvar(--color-fd-card)
--ds-color-hairvar(--color-fd-border)
--ds-color-accentvar(--color-fd-primary)
--ds-color-faintcolor-mix(in oklab, var(--color-fd-muted-foreground) 62%, var(--color-fd-background))
--ds-color-washcolor-mix(in oklab, var(--color-fd-foreground) 12%, var(--color-fd-muted))
color-mix(in oklab, var(--color-fd-foreground) 18%, var(--color-fd-muted)) in dark

Text roles

TokenValueSample
--ds-text-captionvar(--ds-step--1)Ag
--ds-text-bodyvar(--ds-step-0)Ag
--ds-text-ledevar(--ds-step-1)Ag
--ds-text-headingvar(--ds-step-2)Ag
--ds-text-quotevar(--ds-step-3)Ag
--ds-text-statvar(--ds-step-4)Ag
--ds-text-displayvar(--ds-step-5)Ag
--ds-text-mastheadvar(--ds-step-6)Ag

Spacing roles

TokenValueSample
--ds-gap-hairvar(--ds-space-2)
--ds-gap-tightvar(--ds-space-3)
--ds-gap-blockvar(--ds-space-4)
--ds-gap-guttervar(--ds-space-5)
--ds-gap-breakvar(--ds-space-6)
--ds-gap-sectionvar(--ds-space-7)

Component

Layout kit: grid and rhythm

TokenValueSample
--lk-measurevar(--ds-measure-body)
--lk-breakoutvar(--ds-measure-breakout)
--lk-section-gapvar(--ds-gap-section)
--lk-gapvar(--ds-gap-block)
--lk-guttervar(--ds-gap-gutter)
--lk-caption-gapvar(--ds-gap-tight)
--lk-breakvar(--ds-gap-break)
--lk-padvar(--ds-gap-block)

Layout kit: minimum useful widths

TokenValueSample
--lk-min-prosevar(--ds-measure-half)
--lk-min-figurevar(--ds-measure-tile)
--lk-min-livevar(--ds-measure-half)
--lk-min-quotevar(--ds-measure-tile)
--lk-min-statvar(--ds-measure-note)
--lk-min-notevar(--ds-measure-note)

Layout kit: blocks

TokenValue
--lk-figure-radiusvar(--ds-radius-1)
--lk-figure-surfacelinear-gradient(135deg, var(--ds-color-sunken), var(--ds-color-wash))
--lk-figure-ratiovar(--ds-ratio-classic)
--lk-plate-ratiovar(--ds-ratio-plate)
--lk-live-min-blockvar(--ds-measure-tile)
--lk-spread-grow1.3
--lk-display-measure16em
--lk-title-sizevar(--ds-step-0)
--lk-min-titlevar(--ds-measure-breakout)
--lk-stat-glyph0.62
--lk-stat-width100cqi
--lk-stat-floorvar(--ds-text-body)
--lk-lines3
--lk-slot-narrow15rem
--lk-slot-medium30rem
--lk-slot-wide60rem
--lk-lead-sizevar(--ds-text-lede)
--lk-panel-minvar(--ds-measure-breakout)
--lk-panel-padvar(--ds-gap-tight)

Piece page: contents rail

TokenValue
--pc-rail-topcalc(3.5rem + var(--ds-gap-gutter))

Plot kit

TokenValue
--pl-inkvar(--ds-color-ink)
--pl-papervar(--ds-color-paper)
--pl-mutevar(--ds-color-mute)
--pl-faintvar(--ds-color-faint)
--pl-hairvar(--ds-color-hair)
--pl-greycolor-mix(in srgb, var(--ds-color-ink) 34%, var(--ds-color-paper))
--pl-fontvar(--ds-font-mono)
--pl-blendvar(--ds-blend-overprint)
--pl-focusvar(--ds-pen-pink)
--pl-control-sizevar(--ds-step--1)
--pl-control-blockvar(--ds-space-5)
--pl-thumbvar(--ds-space-4)
--pl-track-maxvar(--ds-measure-body)
--pl-w-hair0.8
--pl-w-fine1.2
--pl-w-base1.6
--pl-w-bold2.4
--pl-w-heavy3.2
--pl-dash-dot1 3
--pl-dash-short3 3
--pl-dash-long6 3
--pl-size-micro7px
--pl-size-small8.5px
--pl-size-base10px
--pl-size-large12px
--pl-size-display22px

Player

TokenValue
--pv-chromevar(--ds-color-raised)
--pv-edgevar(--ds-color-ink)
--pv-padvar(--ds-space-2)
--pv-iconvar(--ds-space-4)
--pv-hitvar(--ds-space-6)
--pv-sidevar(--ds-measure-note)
--pv-popvar(--ds-measure-tile)

Surface blocks

TokenValue
--sf-bandcolor-mix(in srgb, var(--ds-color-ink) 5%, var(--ds-color-raised))
--sf-perfvar(--ds-space-5)
--sf-screenvar(--ds-color-ink)
--sf-phosphorvar(--ds-color-paper)
--sf-scan-pitch3px

Social images

TokenValue
--og-paper#101114
--og-ink#f7f6f2
--og-mute#a8a7a1
--og-accentvar(--ds-pen-pink)
--og-font-textGeist
--og-font-labelGeist Mono
--og-size-title-192px
--og-size-title-276px
--og-size-title-360px
--og-size-deck34px
--og-size-label26px
--og-pad72px
--og-gap28px