{
  "$schema": "https://design-tokens.github.io/community-group/format/",
  "meta": {
    "name": "TAGDesigns Brand System",
    "version": "1.0.0",
    "owner": "Ger'Quia Abner / TAGDesigns",
    "license": "Proprietary — for inspection only",
    "updatedAt": "2026-05-03"
  },
  "color": {
    "background":   { "hsl": "0 0% 3%",      "hex": "#080808", "oklch": "oklch(0.13 0 0)",       "role": "Page background — near-black, never pure #000 to keep depth on OLED" },
    "foreground":   { "hsl": "0 0% 98%",     "hex": "#FAFAFA", "oklch": "oklch(0.98 0 0)",       "role": "Primary text on background" },
    "primary":      { "hsl": "16 100% 50%",  "hex": "#FF4D00", "oklch": "oklch(0.66 0.22 38)",   "role": "Electric Safety Orange — accents, links, callouts, the // operator" },
    "primaryFg":    { "hsl": "0 0% 98%",     "hex": "#FAFAFA", "oklch": "oklch(0.98 0 0)",       "role": "Text on primary surfaces" },
    "card":         { "hsl": "0 0% 5%",      "hex": "#0D0D0D", "oklch": "oklch(0.16 0 0)",       "role": "Cards and elevated surfaces" },
    "border":       { "hsl": "0 0% 12%",     "hex": "#1F1F1F", "oklch": "oklch(0.25 0 0)",       "role": "Dividers and outlines" },
    "muted":        { "hsl": "0 0% 12%",     "hex": "#1F1F1F", "oklch": "oklch(0.25 0 0)",       "role": "Muted surface" },
    "mutedFg":      { "hsl": "0 0% 60%",     "hex": "#999999", "oklch": "oklch(0.64 0 0)",       "role": "Secondary text" },
    "destructive":  { "hsl": "0 84% 60%",    "hex": "#EF4444", "oklch": "oklch(0.64 0.22 25)",   "role": "Errors and destructive actions" }
  },
  "typography": {
    "families": {
      "display": { "stack": "Space Grotesk, sans-serif", "use": "Display headings, numerals, kinetic type" },
      "sans":    { "stack": "Space Grotesk, sans-serif", "use": "Body copy" },
      "mono":    { "stack": "JetBrains Mono, monospace", "use": "Captions, // operator, technical labels, numbers in tabular contexts" }
    },
    "scale": {
      "xs":   { "rem": "0.75rem",  "px": 12, "use": "// captions, tabular labels" },
      "sm":   { "rem": "0.875rem", "px": 14, "use": "Small body, FAQ" },
      "base": { "rem": "1rem",     "px": 16, "use": "Body" },
      "lg":   { "rem": "1.125rem", "px": 18, "use": "Lead paragraphs" },
      "xl":   { "rem": "1.25rem",  "px": 20, "use": "Section intros" },
      "2xl":  { "rem": "1.5rem",   "px": 24, "use": "Card titles" },
      "3xl":  { "rem": "1.875rem", "px": 30, "use": "Sub-section heads" },
      "4xl":  { "rem": "2.25rem",  "px": 36, "use": "Section heads" },
      "6xl":  { "rem": "3.75rem",  "px": 60, "use": "Page heads (mobile)" },
      "9xl":  { "rem": "8rem",     "px": 128, "use": "Display heads (desktop)" }
    },
    "tracking": {
      "tighter": "-0.04em",
      "widest":  "0.1em"
    },
    "leading": {
      "none":    "1",
      "snug":    "1.25",
      "relaxed": "1.625"
    }
  },
  "spacing": {
    "scale": {
      "1":  "0.25rem",
      "2":  "0.5rem",
      "4":  "1rem",
      "6":  "1.5rem",
      "8":  "2rem",
      "12": "3rem",
      "16": "4rem",
      "24": "6rem",
      "32": "8rem"
    },
    "container": "1280px",
    "gridUnit":  "8px"
  },
  "radius": {
    "base": "0rem",
    "rule": "Hard edges. Radius is reserved for input affordances and avatars only."
  },
  "motion": {
    "duration": {
      "instant": "120ms",
      "fast":    "240ms",
      "base":    "400ms",
      "slow":    "900ms",
      "epic":    "1400ms"
    },
    "ease": {
      "standard": { "css": "cubic-bezier(0.4, 0, 0.2, 1)",     "use": "Default UI transitions" },
      "out":      { "css": "cubic-bezier(0.16, 1, 0.3, 1)",     "use": "Reveal-in, kinetic type, page wipes" },
      "in":       { "css": "cubic-bezier(0.7, 0, 0.84, 0)",     "use": "Exit transitions" },
      "expo":     { "css": "cubic-bezier(0.87, 0, 0.13, 1)",    "use": "Hero impact, big swings" },
      "back":     { "css": "cubic-bezier(0.34, 1.56, 0.64, 1)", "use": "Playful overshoot — use sparingly" }
    },
    "respectReducedMotion": true
  },
  "voice": {
    "tone":   "Direct, technical, confident. No marketing fluff.",
    "person": "First-person studio (\"we\") for engagements; third-person (\"the studio\") for credentials.",
    "rules":  [
      "Lead with the outcome, not the process.",
      "Numbers > adjectives.",
      "Never end a CTA with a period.",
      "Use sentence case in body. Use UPPERCASE in section labels and CTAs.",
      "// is the operator — it begins technical labels and only technical labels."
    ]
  },
  "operator": {
    "mark":    "//",
    "purpose": "Visual operator that marks technical metadata, section labels, and editorial annotation.",
    "do":      ["// SECTION LABEL", "// 01", "// CASE STUDY", "// FOR: BUYERS"],
    "dont":    ["// in body copy", "// inside CTAs", "// without UPPERCASE following it"]
  },
  "logo": {
    "lockups": [
      { "name": "wordmark",  "use": "Default — TAGDESIGNS one-line wordmark in display weight" },
      { "name": "stacked",   "use": "TAG / DESIGNS — stacked split for narrow contexts" },
      { "name": "monogram",  "use": "T/D monogram — favicons, social avatars, app icons" },
      { "name": "signature", "use": "Ger'Quia Abner signature — credits, byline, about pages" }
    ],
    "clearSpace": "Minimum clear space equals the cap-height of the wordmark on all sides.",
    "minSize":    "24px monogram, 96px wordmark"
  }
}