Tokens
The design values the whole system comes from, the same ones your taisho.config.ts produces. Each swatch uses the live CSS var, so it follows the site’s
light or dark mode.
Color
Each family has 10 shades (100 light → 1000 dark) generated in OKLCH from a
seed. Use them with bg-{family}-{shade} or the --color-{family}-{shade} var.
Text color
--ts-color-heading--ts-color-copy--ts-color-subtle--ts-color-labelStatus colors
Typography
Sizes
10 · 10px12 · 12px14 · 14px16 · 16px18 · 18px20 · 20px24 · clamp(var(--ts-sizing-20), 2vw + 1rem, var(--ts-sizing-24))28 · clamp(var(--ts-sizing-24), 2.5vw + 1rem, var(--ts-sizing-28))32 · clamp(var(--ts-sizing-24), 3vw + 1rem, var(--ts-sizing-32))36 · clamp(var(--ts-sizing-28), 3.5vw + 1rem, var(--ts-sizing-36))40 · clamp(var(--ts-sizing-32), 4vw + 1rem, var(--ts-sizing-40))48 · clamp(var(--ts-sizing-36), 5vw + 1rem, var(--ts-sizing-48))60 · clamp(var(--ts-sizing-40), 6vw + 1rem, var(--ts-sizing-60))72 · clamp(var(--ts-sizing-48), 7.5vw + 1rem, var(--ts-sizing-72))Weights
100200300400500600700800900Spacing
A semantic scale shared by gaps and padding (gap-*, p-*). It’s the one compact density redefines.
Corner radius
--ts-corner-shape is the corner shape: round by default and squircle if the theme sets cornerShape: 'squircle'. With squircle
(only where the browser supports corner-shape) every radius goes up one step on the scale: xs takes the value of sm, and so on up to 2xl. 3xl, none and full don’t move.
Border and ring width
One scale for every stroke: borders, rings
(box-shadow: 0 0 0 N), focus outlines, and accent bands. 1 is the materials’ hairline; 2 is emphasis (active tab, avatar ring); 3 is the outline-* outline; 4 is the focus halo and outline-4-transparent. Override it from the theme with
the borderWidths key.
1px2px3px4pxBlur
For glass backgrounds and decorative layers (backdrop-blur-*, blur-*). none exists so you can
transition from or to a blur. The Modal and Drawer backdrop goes from none to sm. Theme key: blurs.
0px4px8px16px48pxLayers (z-index)
A semantic scale. Each role has its layer, and components use the role
(z-index: var(--ts-z-dropdown)), not a one-off number. The stacking
order is the order of the values. The numeric steps z-0 … z-50 are still available for
general use. Theme key: zIndex.
0123103030404050505051Opacity
Steps for opacity-* and one semantic role. muted is the resting opacity of secondary elements that light up on
hover (the Tag and Banner close button). Theme key: opacities.
00.30.40.50.60.70.750.80.910.6Screens
Reference viewport widths. max-w-screen-* reads them as a
variable. The NavBar, Sidebar, and responsive Table breakpoints use these same values, but an @container or @media condition can’t read
a variable. The generator takes them from the default scale, so a theme override
(the screens key) moves the utilities, not those breakpoints.
640px768px1024px1280pxContrast
--ts-contrast-threshold is the OKLCH lightness below which a custom
Badge’s text switches to white (the contrastThreshold key).
0.56Shadows
Motion
Durations and curves for every CSS transition in the system
(duration-*, ease-*). With prefers-reduced-motion: reduce, transition durations
drop to 1ms from the tokens, and --ts-iterations-loop goes to 0: the skeleton, the indeterminate bar, and the Badge halo stand still. The other
loops (spin, loop-*) keep going. More in Motion.
100ms150ms200ms300ms500ms600ms1200ms1600ms4000msinfiniteeasecubic-bezier(0.4, 0, 1, 1)cubic-bezier(0.22, 1, 0.36, 1)cubic-bezier(0.16, 1.3, 0.3, 1)ease-in-outlinearControl sizes
Height, padding, and box size of each control in its three sizes
(sm, md, lg). They’re
what compact redefines, so controls get
tighter without touching the components. Each row is a pattern that covers its three sizes; the
values go in sm · md · lg order.
| Pattern | Comfortable | Compact |
|---|---|---|
--ts-control-h-{xs|sm|md|lg} | 24px · 32px · 40px · 48px | 24px · 32px · 40px · 48px |
--ts-button-px-{xs|sm|md|lg} | 6px · 10px · 14px · 20px | 6px · 10px · 14px · 20px |
--ts-field-px-{sm|md|lg} | 10px · 12px · 14px | 10px · 12px · 14px |
--ts-select-pr-{sm|md|lg} | 32px · 36px · 40px | 32px · 36px · 40px |
--ts-textarea-px-{sm|md|lg} | 10px · 12px · 14px | 10px · 12px · 14px |
--ts-textarea-py-{sm|md|lg} | 8px · 10px · 12px | 8px · 10px · 12px |
--ts-badge-h-{sm|md|lg} | 20px · 24px · 28px | 20px · 24px · 28px |
--ts-badge-px-{sm|md|lg} | 8px · 10px · 12px | 8px · 10px · 12px |
--ts-tag-h-{sm|md|lg} | 20px · 24px · 28px | 20px · 24px · 28px |
--ts-tag-px-{sm|md|lg} | 6px · 8px · 10px | 6px · 8px · 10px |
--ts-control-box-{sm|md|lg} | 14px · 16px · 20px | 14px · 16px · 20px |
--ts-radio-dot-{sm|md|lg} | 6px · 8px · 10px | 6px · 8px · 10px |
Token families
These properties come in large families, so they’re documented as a pattern with a
count and an example instead of one by one. Backgrounds and backdrops have two levels
each, and -contrast is the text that reads well on that color.
| Pattern | Count | Example | What it’s for |
|---|---|---|---|
--color-{palette}-{shade}-contrast | 70 tokens | --color-brand-100-contrast: var(--color-gray-1000) | A readable text color on that shade (white or gray 1000, depending on contrast). It’s what ts-color-{palette}-{shade}-contrast uses. |
--color-{palette}-solid[-hover|-active][-contrast] | 48 tokens | --color-brand-solid: var(--color-brand-600) | The solid fill of each brand and status color (primary Button, Checkbox, Radio, and Toggle), its hover and active, and the readable text on each. It’s the seed’s step if that is darker than 600; otherwise 600. |
--ts-color-{status}-contrast | 4 tokens | --ts-color-success-contrast: var(--color-success-500-contrast) | Readable text on the solid color of each status (success, warning, info, danger). |
--ts-sizing-{n} | 36 tokens | --ts-sizing-0: 0px | The pixel scale behind ts-w-{n}, ts-h-{n}, ts-size-{n}, and the typography. {n} is the number of px. |
--color-grayAlpha-{shade} | 10 tokens | --color-grayAlpha-100: light-dark(oklch(0 0 0 / 0.05), oklch(1 0 0 / 0.05)) | Translucent gray (black in light mode, white in dark mode) for surfaces that let what’s behind show through. |
--color-{background|overlay}-{n} | 4 tokens | --color-background-100: light-dark(oklch(1 0 0), oklch(0.12 0 0)) | Page backgrounds (background) and the Modal and Drawer backdrops (overlay); each has two levels. |
Other tokens
The font families (--font-sans, --font-mono), the solid button’s background color, and the
spotlight glow.
"Geist Sans", "Geist Sans Fallback", ui-sans-serif, system-ui, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji""Geist Mono", "Geist Mono Fallback", ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospacevar(--color-gray-1000)light-dark(var(--color-gray-100), var(--color-gray-200))light-dark(var(--color-gray-200), var(--color-gray-300))light-dark(var(--color-background-100), var(--color-gray-1000))light-dark(var(--color-gray-1000), var(--color-gray-100))roundlight-dark(var(--color-grayAlpha-700), var(--color-grayAlpha-600))light-dark(var(--color-grayAlpha-100), var(--color-grayAlpha-200))How to use them
Prefer the system’s semantic utilities, and fall back to CSS vars only for one-off cases.
<!-- Semantic utility (recommended) -->
<div class="ts bg-brand-500 p-base radius-lg gap-half">…</div>
<!-- Direct CSS var (one-off cases) -->
<div style="background: var(--color-brand-500); padding: var(--ts-space-base)">…</div>