{
  "$schema": "https://design-tokens.github.io/community-group/format/",
  "_meta": {
    "name": "KitZ Brand System",
    "version": "1.0.0",
    "date": "2026-05-27",
    "canonical": "https://kitz.services/branding",
    "description": "W3C Design Tokens for the KitZ Japandi Terminal design system"
  },
  "color": {
    "surface": {
      "bone": { "$value": "#F9F6EF", "$type": "color", "$description": "Page background" },
      "paper": { "$value": "#F2EEE4", "$type": "color", "$description": "Card/input background" },
      "paper-2": { "$value": "#ECE7DA", "$type": "color", "$description": "Hover background" },
      "veil": { "$value": "#E5DECD", "$type": "color", "$description": "Overlay" },
      "card": { "$value": "#FDFBF6", "$type": "color", "$description": "Elevated surface, email card" }
    },
    "ink": {
      "ink": { "$value": "#1A1A1A", "$type": "color", "$description": "Primary text, CTA background, logo fill" },
      "ink-2": { "$value": "#3A3733", "$type": "color", "$description": "Headings, body text" },
      "ink-3": { "$value": "#6E6A62", "$type": "color", "$description": "Secondary text, muted labels" },
      "ink-4": { "$value": "#9A9489", "$type": "color", "$description": "Captions, footer text" }
    },
    "border": {
      "rule": { "$value": "#D9D2BF", "$type": "color", "$description": "Borders, dividers" },
      "rule-2": { "$value": "#C7BFA8", "$type": "color", "$description": "Active borders" }
    },
    "accent": {
      "gold": { "$value": "#A68B5B", "$type": "color", "$description": "Links, highlights, CTA accents" },
      "gold-deep": { "$value": "#8C7244", "$type": "color", "$description": "Hover gold" },
      "gold-soft": { "$value": "#D9C9A6", "$type": "color", "$description": "Background accent" },
      "moss": { "$value": "#7A8B6F", "$type": "color", "$description": "Success states" },
      "moss-deep": { "$value": "#5E6E54", "$type": "color", "$description": "Success hover" },
      "moss-soft": { "$value": "#BFCBB1", "$type": "color", "$description": "Success background" }
    },
    "status": {
      "warn": { "$value": "#B8884B", "$type": "color", "$description": "Warning" },
      "error": { "$value": "#A14B3C", "$type": "color", "$description": "Danger/error" },
      "whatsapp": { "$value": "#25D366", "$type": "color", "$description": "WhatsApp green" }
    },
    "agent": {
      "luna": { "$value": "#6E7A8C", "$type": "color", "$description": "Luna — SDR — Dusk Slate" },
      "marco": { "$value": "#A68B5B", "$type": "color", "$description": "Marco — Account Exec — Gold" },
      "nova": { "$value": "#B16A4F", "$type": "color", "$description": "Nova — Customer Success — Terracotta" },
      "sage": { "$value": "#7A8B6F", "$type": "color", "$description": "Sage — Advisor — Moss" },
      "flux": { "$value": "#8C7A6E", "$type": "color", "$description": "Flux — Operations — Warm Stone" },
      "creativa": { "$value": "#6E5778", "$type": "color", "$description": "Creativa — Branding — Plum" }
    }
  },
  "fontFamily": {
    "serif": { "$value": "'Cormorant Garamond', 'Cormorant', Georgia, serif", "$type": "fontFamily", "$description": "Headings, greeting lines" },
    "mono": { "$value": "'JetBrains Mono', ui-monospace, 'SF Mono', Menlo, Consolas, monospace", "$type": "fontFamily", "$description": "Body text, labels, buttons, data" },
    "sans": { "$value": "'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif", "$type": "fontFamily", "$description": "System UI fallback" },
    "logo": { "$value": "'Playfair Display', 'Bodoni Moda', Didot, Bodoni, Georgia, serif", "$type": "fontFamily", "$description": "Logo K only" }
  },
  "typeScale": {
    "h1": { "$value": { "fontSize": "26px", "fontWeight": 500, "fontFamily": "{fontFamily.serif}" }, "$type": "typography" },
    "h2": { "$value": { "fontSize": "20px", "fontWeight": 500, "fontFamily": "{fontFamily.serif}" }, "$type": "typography" },
    "h3": { "$value": { "fontSize": "16px", "fontWeight": 500, "fontFamily": "{fontFamily.serif}" }, "$type": "typography" },
    "body": { "$value": { "fontSize": "13.5px", "fontWeight": 400, "fontFamily": "{fontFamily.mono}" }, "$type": "typography" },
    "body-sm": { "$value": { "fontSize": "13px", "fontWeight": 400, "fontFamily": "{fontFamily.mono}" }, "$type": "typography" },
    "label": { "$value": { "fontSize": "12px", "fontWeight": 500, "fontFamily": "{fontFamily.mono}" }, "$type": "typography" },
    "button": { "$value": { "fontSize": "11px", "fontWeight": 500, "fontFamily": "{fontFamily.mono}", "textTransform": "uppercase", "letterSpacing": "0.12em" }, "$type": "typography" },
    "caption": { "$value": { "fontSize": "11px", "fontWeight": 400, "fontFamily": "{fontFamily.mono}" }, "$type": "typography" },
    "legal": { "$value": { "fontSize": "10px", "fontWeight": 400, "fontFamily": "{fontFamily.mono}" }, "$type": "typography" }
  },
  "borderRadius": {
    "default": { "$value": "0", "$type": "dimension", "$description": "Square corners everywhere" },
    "avatar": { "$value": "9999px", "$type": "dimension", "$description": "Full round for avatars only" }
  },
  "rules": {
    "noCoolBlues": "Never use cool blues, random gray ladders, or neon colors",
    "squareCorners": "border-radius: 0 everywhere except avatars (9999px)",
    "lightOnly": "No dark mode. Japandi Terminal is a warm light aesthetic.",
    "thinBorders": "1px borders using --kz-rule (#D9D2BF). Never heavy.",
    "blackCTA": "Primary CTA: #1A1A1A background, #FDFBF6 text, 0 radius",
    "goldLinks": "Links are gold #A68B5B, no underline",
    "voice": "Neutral LATAM Spanish, warm-direct, no emojis in professional material",
    "productName": "Always 'KitZ' — never 'KitZ OS', 'KitZ(OS)', or 'Kitz'"
  }
}