@andabove/gum-tokens
v0.1.0
Published
GUM design tokens (CSS variables + Tailwind v4 theme)
Readme
@andabove/gum-tokens
Design tokens for GUM. Structure is fixed (primitives → semantic → Tailwind @theme). Values sync from Figma variables — never invent palettes here.
Exports
| Export | Path | Purpose |
| -------------------------------- | -------------------- | ---------------------------- |
| @andabove/gum-tokens/style.css | src/index.css | All CSS custom properties |
| @andabove/gum-tokens/theme.css | tailwind/theme.css | Tailwind v4 @theme mapping |
Snapshot and generation
Committed snapshot: figma/tokens.json (do not hand-edit values).
# Regenerate CSS + theme from the committed snapshot
pnpm run generate:tokens
# Rebuild the snapshot from .tmp/figma-extract (maintainers only)
pnpm run assemble:tokens-json
# Drift and raw-value gates
pnpm run check:token-sync
pnpm run check:raw-valuesFonts
Family tokens are Google Sans Flex (--font-family-sans) and Google Sans Code (--font-family-mono). This package does not ship @font-face rules; load the faces in the host app (Google Fonts CDN, Fontsource, or self-host). Storybook already loads them via packages/ui/.storybook/preview-head.html.
Dark mode
Semantic colour overrides live in src/semantic/dark.css under [data-theme="dark"]. Components never branch on theme in JS.
Naming
Figma path Colours/Blue/500-default → --palette-blue-500-default. Semantic Colours/Text/primary → --color-text-primary. See docs/plans/001-foundations-tokens/plan.md for the full mapping table.
License / usage
UNLICENSED. This package is published publicly for installation convenience, but no rights are granted by default; usage terms are at &above's discretion. Contact &above before using it outside &above projects.
