kontenedor

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

  1. Primitives: raw palettes (ink, cobalt, green, amber, red, cyan) in OKLCH.
  2. Semantic roles: what components use (background, foreground, surface, muted, border, primary, success…).
  3. 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 fluid text-display-md|lg|xl for 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.