# tokens

URL: /chirp-ui/api/tokens/
Section: api
Description: CSS custom property catalog — machine-readable index of --chirpui-* tokens.

Each `TokenDef` records a single CSS custom property: its name,
semantic category, and scope (global or a component block name).

The catalog is bootstrapped by ``scripts/extract_tokens.py`` and curated here
as the source of truth. Tests validate it against ``chirpui.css`` to catch
drift.

Categories
----------
* **color** — semantic colors, state colors, gradients
* **spacing** — fluid spacing scale and role aliases
* **typography** — font sizes, weights, families, line-heights
* **radius** — border-radius scale
* **elevation** — box-shadow tokens
* **motion** — easing curves and durations
* **layout** — structural tokens (container max, grid min, sidebar dims)
* **component** — per-component override knobs (scoped)

---

> For a complete page index, fetch /chirp-ui/llms.txt.

# tokens

CSS custom property catalog — machine-readable index of --chirpui-* tokens.

Each `TokenDef` records a single CSS custom property: its name,
semantic category, and scope (global or a component block name).

The catalog is bootstrapped by ``scripts/extract_tokens.py`` and curated here
as the source of truth. Tests validate it against ``chirpui.css`` to catch
drift.

Categories
----------
* **color** — semantic colors, state colors, gradients
* **spacing** — fluid spacing scale and role aliases
* **typography** — font sizes, weights, families, line-heights
* **radius** — border-radius scale
* **elevation** — box-shadow tokens
* **motion** — easing curves and durations
* **layout** — structural tokens (container max, grid min, sidebar dims)
* **component** — per-component override knobs (scoped)

module

CSS custom property catalog — machine-readable index of --chirpui-* tokens.

Each `TokenDef` records a single CSS custom property: its name,
semantic category, and scope (global or a component block name).

The catalog is bootstrapped by ``scripts/extract_tokens.py`` and curated here
as the source of truth. Tests validate it against ``chirpui.css`` to catch
drift.

Categories
----------
* **color** — semantic colors, state colors, gradients
* **spacing** — fluid spacing scale and role aliases
* **typography** — font sizes, weights, families, line-heights
* **radius** — border-radius scale
* **elevation** — box-shadow tokens
* **motion** — easing curves and durations
* **layout** — structural tokens (container max, grid min, sidebar dims)
* **component** — per-component override knobs (scoped)

TokenDef

class

A single CSS custom property in the chirp-ui design system.

extract_css_tokens

function

Parse chirpui.css and return the set of declared --chirpui-* property names.