Design tokens
Tokens are defined once in packages/tokens/src/tokens.mjs and generated into:
kontenedor.css— framework-agnostic CSS variables (--k-*).tailwind.css— the Tailwind v4@theme, utilities and variants.tokens.json— W3C Design Tokens (DTCG) format.figma-variables.json— collections and modes for Figma.
Layers
- Primitives: raw palettes (
ink,cobalt,green,amber,red,cyan) in OKLCH. - Semantic roles: what components use (
background,foreground,surface,muted,border,primary,success…). - Weight: radius, borders, shadows, font weights, icon axes, control heights.
Color roles
| Role | Tailwind | Use |
|---|---|---|
| background / foreground | bg-background text-foreground |
Page |
| surface | bg-surface |
Cards, panels |
| muted / muted-foreground | bg-muted text-muted-foreground |
Secondary text, fills |
| subtle | bg-subtle |
Hover rows, sections |
| border / border-strong / input | border-border |
Dividers, outlines |
| primary (+ -foreground, -subtle) | bg-primary |
Main actions, brand |
| success · warning · danger · info | bg-success-subtle |
Status |
| inverse | bg-inverse |
Tooltips, high contrast |
| chart-1…5 | var(--k-chart-1) |
Data viz |
Every color has a dark-mode value. Raw palettes are available as bg-k-cobalt-500, but prefer semantic roles.
Typography
- Geist (sans) and Geist Mono from Google Fonts.
- Scale
text-2xs→text-7xl, plus fluidtext-display-md|lg|xlfor hero headings.
Breakpoints
| Name | Min width | Device |
|---|---|---|
sm |
640px | Large phones |
md |
768px | Tablet |
lg |
1024px | Desktop |
xl |
1280px | Wide desktop |
2xl |
1536px | Ultra-wide |
Motion
--k-duration-fast 120ms · --k-duration-base 180ms · --k-duration-slow 280ms · --k-ease-out. prefers-reduced-motion is respected globally.