{
  "$schema": "https://design-tokens.github.io/community-group/format/",
  "$meta": {
    "brand": "Benson's Bees",
    "location": "Aptos, California",
    "version": "1.0.0",
    "date": "2026-10-01",
    "source": "brand-package/tokens.json (W3C design tokens spec), materialized for the handover package"
  },
  "color": {
    "primary": {
      "terracotta": { "$type": "color", "$value": "#C8553D", "$description": "Primary warm — walls, accent, bold brand" },
      "aptos-pink": { "$type": "color", "$value": "#E5A5A0", "$description": "Soft contrast — signage, packaging, CTA" },
      "honey-gold": { "$type": "color", "$value": "#E8A53A", "$description": "Mascot body, honey cues, type accent" },
      "mustard": { "$type": "color", "$value": "#D9A441", "$description": "Secondary warm, label backgrounds" }
    },
    "neutral": {
      "sand-cream": { "$type": "color", "$value": "#F2E6CF", "$description": "Primary background, packaging base" },
      "off-white": { "$type": "color", "$value": "#FAF3E2", "$description": "High-contrast surface, tablecloth, paper trim" },
      "warm-charcoal": { "$type": "color", "$value": "#2B2A28", "$description": "Type, line work, the B's — never pure black" }
    },
    "supporting": {
      "sage": { "$type": "color", "$value": "#8FA68E", "$description": "Foliage and scene green, calm counterpoint" },
      "deep-sage": { "$type": "color", "$value": "#3D7A3D", "$description": "Clover leaf shadow tone" },
      "coastal-teal": { "$type": "color", "$value": "#3D5A6C", "$description": "Surfboards, sea accents, type detail" },
      "terracotta-shadow": { "$type": "color", "$value": "#A04530", "$description": "Hover/pressed state for terracotta" },
      "clover-leaf-alt": { "$type": "color", "$value": "#4A8A4A", "$description": "Alternate clover leaf tone in the brand mark" },
      "clover-center": { "$type": "color", "$value": "#2D5A2D", "$description": "Clover center knot in the brand mark" }
    },
    "interface": {
      "bg": { "$type": "color", "$value": "#F2E6CF", "$description": "alias: neutral.sand-cream" },
      "surface": { "$type": "color", "$value": "#FAF3E2", "$description": "alias: neutral.off-white" },
      "fg": { "$type": "color", "$value": "#2B2A28", "$description": "alias: neutral.warm-charcoal" },
      "muted": { "$type": "color", "$value": "#3D5A6C", "$description": "alias: supporting.coastal-teal" },
      "border": { "$type": "color", "$value": "#D3C9B5", "$description": "Rules and dividers — warm charcoal 14% over sand cream" },
      "accent": { "$type": "color", "$value": "#C8553D", "$description": "alias: primary.terracotta" }
    }
  },
  "typography": {
    "fontFamily": {
      "display": { "$type": "fontFamily", "$value": ["Recoleta", "Cormorant Garamond", "Playfair Display", "Georgia", "serif"] },
      "body": { "$type": "fontFamily", "$value": ["Inter", "Söhne", "system-ui", "-apple-system", "Segoe UI", "Helvetica Neue", "Arial", "sans-serif"] },
      "accent": { "$type": "fontFamily", "$value": ["Caveat", "Patrick Hand", "Marker Felt", "cursive"] }
    },
    "size": {
      "display-xl": { "$type": "dimension", "$value": "96px" },
      "display-l": { "$type": "dimension", "$value": "64px" },
      "heading-m": { "$type": "dimension", "$value": "40px" },
      "body-l": { "$type": "dimension", "$value": "20px" },
      "body-m": { "$type": "dimension", "$value": "16px" },
      "body-s": { "$type": "dimension", "$value": "14px" },
      "label": { "$type": "dimension", "$value": "12px" }
    },
    "letterSpacing": {
      "wordmark": { "$type": "letterSpacing", "$value": "0.18em", "$description": "BENSON · BEES · APTOS, all-caps, never below 12px" }
    }
  },
  "spacing": {
    "xs": { "$type": "dimension", "$value": "4px" },
    "s": { "$type": "dimension", "$value": "8px" },
    "m": { "$type": "dimension", "$value": "16px" },
    "l": { "$type": "dimension", "$value": "24px" },
    "xl": { "$type": "dimension", "$value": "40px" },
    "2xl": { "$type": "dimension", "$value": "64px" },
    "3xl": { "$type": "dimension", "$value": "96px" }
  },
  "radius": {
    "default": { "$type": "dimension", "$value": "8px" },
    "chip": { "$type": "dimension", "$value": "6px" },
    "pill": { "$type": "dimension", "$value": "999px" },
    "leaf": { "$type": "string", "$value": "60% 60% 40% 40%", "$description": "Four-leaf clover motif only" }
  },
  "border": {
    "default": { "$type": "dimension", "$value": "1px" }
  },
  "shadow": {
    "soft": { "$type": "shadow", "$value": { "color": "rgba(43,42,40,0.12)", "offsetX": "0px", "offsetY": "6px", "blur": "12px" } },
    "warm": { "$type": "shadow", "$value": { "color": "rgba(200,85,61,0.18)", "offsetX": "0px", "offsetY": "12px", "blur": "24px" } }
  },
  "motion": {
    "duration": {
      "fast": { "$type": "duration", "$value": "200ms" },
      "normal": { "$type": "duration", "$value": "400ms" },
      "slow": { "$type": "duration", "$value": "700ms" },
      "story": { "$type": "duration", "$value": "6000ms", "$description": "Full logo reveal" }
    },
    "easing": {
      "out-cubic": { "$type": "easing", "$value": "cubic-bezier(0.215, 0.61, 0.355, 1)", "$description": "reveals" },
      "in-back": { "$type": "easing", "$value": "cubic-bezier(0.6, -0.28, 0.735, 0.045)", "$description": "collapses" },
      "in-out-back": { "$type": "easing", "$value": "cubic-bezier(0.68, -0.55, 0.265, 1.55)", "$description": "the B's rotation" },
      "out-bounce": { "$type": "easing", "$value": "cubic-bezier(0.34, 1.56, 0.64, 1)", "$description": "the bee's landing" },
      "out-elastic": { "$type": "easing", "$value": "cubic-bezier(0.68, -0.6, 0.32, 1.6)", "$description": "the clover pop" }
    }
  },
  "$rules": {
    "muted": "Every color is slightly muted. If it pops neon, it's wrong. When in doubt, desaturate by 10%.",
    "accent": "Terracotta is a high-signal color — sparingly, never a large wash. Hover/pressed uses terracotta-shadow.",
    "black": "Never pure black (#000). Type and line work are warm charcoal.",
    "shadows": "Two shadows exist: soft and warm. That's the whole list."
  }
}