{
  "name": "J-Dawg's House brand tokens",
  "version": "1.0.0",
  "updated": "2026-11-18",
  "home": "https://brand.jdawgshouse.com",
  "note": "Source of truth. Edit this file, run python brand/build.py, commit. Every site reads the generated /tokens.css or /tokens.json.",
  "color": {
    "cream": {
      "value": "#fbf5ec",
      "use": "The ground in light mode, and the card in dark mode so it reads from across the kitchen."
    },
    "paper": {
      "value": "#ffffff",
      "use": "Cards on the cream ground."
    },
    "ink": {
      "value": "#3b2a1e",
      "use": "Text. A warm brown, never pure black."
    },
    "ink-2": {
      "value": "#7a6250",
      "use": "Secondary text and block headings on cream or paper."
    },
    "ink-3": {
      "value": "#a68f7b",
      "use": "Decoration and disabled states only. Too light for words anyone has to read."
    },
    "line": {
      "value": "#e5d6c2",
      "use": "Borders and dividers."
    },
    "fawn": {
      "value": "#c9a074",
      "use": "Bubba's coat. Outlines, pills and the wordmark on dark."
    },
    "fawn-2": {
      "value": "#e6cfae",
      "use": "Bands and soft fills."
    },
    "fawn-3": {
      "value": "#f3e6d2",
      "use": "Strips, chips and quiet buttons."
    },
    "caramel": {
      "value": "#d49b5a",
      "use": "The highlight: focus rings, the walkthrough spotlight, step numbers."
    },
    "caramel-wash": {
      "value": "#fff1d6",
      "use": "The warm fill behind a spotlighted item."
    },
    "oxblood": {
      "value": "#5e1620",
      "use": "Emphasis. The one thing nobody may skip, no-lists, the one sign-up button."
    },
    "oxblood-2": {
      "value": "#7a1d2a",
      "use": "Oxblood when it is spotlighted or hovered."
    },
    "blush": {
      "value": "#f7b6c4",
      "use": "The ring and the exclamation mark that sit on oxblood."
    },
    "amber": {
      "value": "#f2b33d",
      "use": "Close and other plain action buttons, with ink text."
    },
    "green": {
      "value": "#2f9a5b",
      "use": "Done, covered, good to go."
    },
    "green-wash": {
      "value": "#dff5e6",
      "use": "The fill behind a done state."
    },
    "green-ink": {
      "value": "#175c34",
      "use": "Text on green-wash."
    },
    "chocolate": {
      "value": "#241a13",
      "use": "The ground in dark mode."
    },
    "chocolate-2": {
      "value": "#2e2219",
      "use": "A raised area on the dark ground."
    },
    "chocolate-3": {
      "value": "#3a2c22",
      "use": "Strips and bands in dark mode."
    },
    "cream-2": {
      "value": "#d9c4aa",
      "use": "Secondary text on the dark ground."
    }
  },
  "semantic": {
    "light": {
      "bg": "cream",
      "on-bg": "ink",
      "on-bg-2": "ink-2",
      "card": "paper",
      "card-ink": "ink",
      "card-ink-2": "ink-2",
      "strip": "fawn-3",
      "strip-ink": "ink",
      "band": "fawn-2",
      "band-ink": "ink",
      "line": "line",
      "outline": "fawn",
      "highlight": "caramel",
      "highlight-wash": "caramel-wash",
      "emphasis": "oxblood",
      "emphasis-hot": "oxblood-2",
      "on-emphasis": "paper",
      "emphasis-ring": "blush",
      "action": "amber",
      "on-action": "ink",
      "ok": "green",
      "ok-wash": "green-wash",
      "ok-ink": "green-ink",
      "wordmark": "ink"
    },
    "dark": {
      "bg": "chocolate",
      "on-bg": "cream",
      "on-bg-2": "cream-2",
      "card": "cream",
      "card-ink": "ink",
      "card-ink-2": "ink-2",
      "strip": "chocolate-3",
      "strip-ink": "fawn-3",
      "band": "chocolate-3",
      "band-ink": "fawn-2",
      "line": "chocolate-3",
      "outline": "fawn",
      "highlight": "caramel",
      "highlight-wash": "caramel-wash",
      "emphasis": "oxblood",
      "emphasis-hot": "oxblood-2",
      "on-emphasis": "paper",
      "emphasis-ring": "blush",
      "action": "amber",
      "on-action": "ink",
      "ok": "green",
      "ok-wash": "green-wash",
      "ok-ink": "green-ink",
      "wordmark": "fawn"
    }
  },
  "font": {
    "display": {
      "value": "'Fredoka', 'Nunito', system-ui, sans-serif",
      "use": "Headings, buttons, labels, numbers. Weights 500, 600, 700."
    },
    "body": {
      "value": "'Nunito', system-ui, -apple-system, 'Segoe UI', sans-serif",
      "use": "Everything you read. Weights 500, 700, 800."
    }
  },
  "type": {
    "note": "One scale for every content block. TV values are at 1920 wide; the body follows 1.05vw between 16 and 22px. Headings are multiples of the body.",
    "tv": {
      "body": "clamp(16px, 1.05vw, 22px)",
      "title": "2em",
      "lede": "1.1em",
      "heading": "1.15em",
      "label": "1.1em"
    },
    "phone": {
      "body": "17px",
      "title": "28px",
      "lede": "19px",
      "heading": "20px",
      "label": "19px"
    },
    "phone_max_width": "700px",
    "line_height": "1.5",
    "body_floor": "Body never shrinks below 85% (17px on the TV). A card longer than that scrolls by touch."
  },
  "space": {
    "block-pad": {
      "tv": "32px",
      "phone": "16px"
    },
    "gap": "1em",
    "target": "56px"
  },
  "radius": {
    "card": "24px",
    "control": "18px",
    "pill": "999px"
  },
  "shadow": {
    "light": "0 6px 20px rgba(59,42,30,.10)",
    "dark": "0 10px 30px rgba(0,0,0,.35)"
  },
  "motion": {
    "fast": "150ms",
    "base": "250ms",
    "rule": "Under prefers-reduced-motion the movement goes and the highlight stays."
  },
  "contrast": [
    {
      "text": "ink",
      "on": "cream",
      "ratio": 12.61,
      "grade": "AAA",
      "use": "Body text on the light ground"
    },
    {
      "text": "ink",
      "on": "paper",
      "ratio": 13.67,
      "grade": "AAA",
      "use": "Body text on a card"
    },
    {
      "text": "ink-2",
      "on": "cream",
      "ratio": 5.25,
      "grade": "AA",
      "use": "Secondary text on the light ground"
    },
    {
      "text": "ink-2",
      "on": "paper",
      "ratio": 5.69,
      "grade": "AA",
      "use": "Secondary text on a card"
    },
    {
      "text": "ink-3",
      "on": "cream",
      "ratio": 2.83,
      "grade": "decoration",
      "use": "Decoration only, not for words"
    },
    {
      "text": "cream",
      "on": "chocolate",
      "ratio": 15.72,
      "grade": "AAA",
      "use": "Body text on the dark ground"
    },
    {
      "text": "cream-2",
      "on": "chocolate",
      "ratio": 10.09,
      "grade": "AAA",
      "use": "Secondary text on the dark ground"
    },
    {
      "text": "fawn-3",
      "on": "chocolate-3",
      "ratio": 10.91,
      "grade": "AAA",
      "use": "A title on a dark strip"
    },
    {
      "text": "fawn",
      "on": "chocolate",
      "ratio": 7.11,
      "grade": "AAA",
      "use": "The wordmark on the dark ground"
    },
    {
      "text": "paper",
      "on": "oxblood",
      "ratio": 13.03,
      "grade": "AAA",
      "use": "Callouts and no-lists"
    },
    {
      "text": "oxblood",
      "on": "blush",
      "ratio": 7.72,
      "grade": "AAA",
      "use": "The exclamation mark"
    },
    {
      "text": "ink",
      "on": "amber",
      "ratio": 7.35,
      "grade": "AAA",
      "use": "Action buttons"
    },
    {
      "text": "ink",
      "on": "fawn-3",
      "ratio": 11.11,
      "grade": "AAA",
      "use": "Quiet buttons and chips"
    },
    {
      "text": "ink",
      "on": "caramel-wash",
      "ratio": 12.24,
      "grade": "AAA",
      "use": "A spotlighted item"
    },
    {
      "text": "paper",
      "on": "green",
      "ratio": 3.56,
      "grade": "AA large",
      "use": "The big done button (large bold text only)"
    },
    {
      "text": "green-ink",
      "on": "green-wash",
      "ratio": 7.01,
      "grade": "AAA",
      "use": "A done state"
    },
    {
      "text": "paper",
      "on": "caramel",
      "ratio": 2.43,
      "grade": "decoration",
      "use": "White on caramel: too faint, do not use"
    },
    {
      "text": "ink",
      "on": "caramel",
      "ratio": 5.62,
      "grade": "AA",
      "use": "Step numbers, set the right way"
    },
    {
      "text": "ink",
      "on": "fawn",
      "ratio": 5.71,
      "grade": "AA",
      "use": "A selected pill"
    },
    {
      "text": "ink",
      "on": "fawn-2",
      "ratio": 9.05,
      "grade": "AAA",
      "use": "A band"
    }
  ]
}
