{
  "$description": "Brand: HEY (hey@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette hey@1.0.0",
      "hey-yellow": {
        "$value": "#FFFF00",
        "$type": "color",
        "$description": "The defining HEY accent — a pure CSS-yellow used as a highlight throughout the product (think text-marker / \"Screener\" highlight bar). Loud by design.\n"
      },
      "hey-blue": {
        "$value": "#0088CC",
        "$type": "color",
        "$description": "The action blue captured from hey.com — used for links, primary buttons, and active-state affordance.\n"
      },
      "hey-blue-hover": {
        "$value": "#1A8AD5",
        "$type": "color",
        "$description": "Slightly brighter hover variant."
      },
      "hey-blue-active": {
        "$value": "#176BAD",
        "$type": "color",
        "$description": "Pressed / active blue."
      },
      "hey-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Page canvas — pure white, no warm tint."
      },
      "hey-near-white": {
        "$value": "#FCFCFC",
        "$type": "color",
        "$description": "Subtle elevated surface."
      },
      "hey-grey-100": {
        "$value": "#F5F5F5",
        "$type": "color",
        "$description": "Hairline panel background."
      },
      "hey-grey-300": {
        "$value": "#DDDDDD",
        "$type": "color",
        "$description": "Border and divider on light surfaces."
      },
      "hey-grey-500": {
        "$value": "#888888",
        "$type": "color",
        "$description": "Tertiary text / inactive icon."
      },
      "hey-grey-700": {
        "$value": "#555555",
        "$type": "color",
        "$description": "Secondary text."
      },
      "hey-text": {
        "$value": "#333333",
        "$type": "color",
        "$description": "Body text on white canvas."
      },
      "hey-heading": {
        "$value": "#222222",
        "$type": "color",
        "$description": "Heading and emphasis text on white."
      },
      "hey-near-black": {
        "$value": "#1E1E1E",
        "$type": "color",
        "$description": "Deepest ink for high-contrast type and dark-mode canvas."
      },
      "hey-success": {
        "$value": "#3C763D",
        "$type": "color",
        "$description": "Confirmation green — Bootstrap success-text heritage."
      },
      "hey-success-bg": {
        "$value": "#DFF0D8",
        "$type": "color",
        "$description": "Success-state surface tint."
      },
      "hey-error": {
        "$value": "#A94442",
        "$type": "color",
        "$description": "Error red — Bootstrap danger-text heritage."
      },
      "hey-error-bg": {
        "$value": "#F2DEDE",
        "$type": "color",
        "$description": "Error-state surface tint."
      },
      "hey-warning": {
        "$value": "#8A6D3B",
        "$type": "color",
        "$description": "Warning amber."
      },
      "hey-warning-bg": {
        "$value": "#FCF8E3",
        "$type": "color",
        "$description": "Warning-state surface tint."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Helvetica Neue",
          "Helvetica",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Helvetica Neue (helvetica-neue@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Helvetica Neue",
          "Helvetica",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Helvetica Neue (helvetica-neue@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "mono": {
      "family": {
        "$value": [
          "JetBrainsMono Nerd Font",
          "JetBrains Mono",
          "Fira Code",
          "Menlo",
          "Monaco",
          "Consolas",
          "Liberation Mono",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → JetBrainsMono Nerd Font (jetbrainsmono-nerdfont@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "200": {
          "$value": 200,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "HEY Text (#333333) on HEY White clears AAA at ~12.6:1. HEY's product is reading-dense by design (long email threads, paper-trail receipts); the AAA contrast target reflects the product's deliberate emphasis on extended-reading comfort.\n",
        "against": "background",
        "minRatio": 7,
        "standard": "WCAG-AAA"
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.accent",
        "severity": "error",
        "rationale": "HEY Yellow (#FFFF00) is THE brand accent — the screaming highlight that defines the product's visual fingerprint. Substituting any other hue erases the brand's most distinguishing visual choice. The Yellow is used aggressively as a text-highlight / attention-redirect throughout HEY.\n",
        "allowed": [
          "hey-yellow"
        ],
        "forbidden": [
          "hey-blue",
          "hey-blue-hover",
          "hey-success",
          "hey-warning"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "HEY's wordmark is rendered as plain, system-font-flavored type — no gradient fills, no decorative treatments, no drop-shadows. The brand's whole point is anti-decoration; a treated HEY mark contradicts the brand's stated values.\n",
        "treatments": [
          "stretched",
          "rotated",
          "drop-shadow",
          "gradient-fill",
          "on-busy-photo",
          "decorative-typography"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.body.fontFamily",
        "severity": "warning",
        "rationale": "HEY deliberately uses the OS system-font stack — Lucida Grande on macOS, Helvetica / Arial / Verdana as fallbacks — rather than a proprietary or web-hosted face. Introducing a custom typeface (Inter, Söhne, etc.) breaks the brand's intentional system-aesthetic stance.\n",
        "allowed": [
          "Lucida Grande",
          "Lucida Sans Unicode",
          "Helvetica Neue",
          "Helvetica",
          "Arial",
          "Verdana",
          "system-ui",
          "-apple-system",
          "BlinkMacSystemFont"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "HEY Blue (#0088CC) on HEY White clears AA at ~5.3:1 — the product uses #0088CC for both link affordance and primary button fills; staying above AA is non-negotiable on the reading-dense product surface.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.accent",
        "severity": "error",
        "rationale": "HEY Yellow (#FFFF00) is a highlight — used as a thin text-marker stripe or a small badge. Using it as a body-text color (no contrast against white) or as a full-page background (visual assault) inverts the brand's deliberate \"loud but contained\" use of the hue.\n",
        "allowedContexts": [
          "highlight",
          "emphasis",
          "attention-redirect"
        ],
        "forbiddenContexts": [
          "body-text",
          "large-surface-fill"
        ]
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.accent",
        "severity": "error",
        "rationale": "HEY Yellow is only legible on a dark text foreground (no contrast against white). Pairing it adjacent to HEY Blue creates a primary-color competition that destabilizes the single-accent rule.\n",
        "pairsWith": [
          "hey-heading",
          "hey-near-black",
          "hey-text"
        ],
        "doesNotPairWith": [
          "hey-white",
          "hey-blue"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "recommendation",
        "rationale": "HEY uses the same system-font family for headings and body — hierarchy is signaled by size and weight rather than family-switching. A 1.3× minimum heading-to-body size ratio preserves hierarchy when one family does all the work.\n",
        "requires": "body",
        "minSizeRatio": 1.3
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://hey.com/about",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "HEY, the HEY wordmark, Basecamp, and 37signals are trademarks of 37signals LLC. Brand colors and identity guidance documented here are derived from hey.com and hey.com/about, captured on 2026-05-18.\n",
      "importedDate": "2026-05-18",
      "notes": "Derived from live site CSS at https://hey.com on 2026-05-18; no public brand guide located. HEY is authored by Basecamp / 37signals — the visual restraint and system-font choice are intentional brand decisions inherited from the parent company's operating philosophy. The bright Yellow (#FFFF00) is the brand's single most distinguishing visual choice — used aggressively as a highlight throughout the product. No proprietary typeface; the marketing site renders in the system stack (\"Lucida Grande\", \"Lucida Sans Unicode\", Arial, Helvetica, Verdana, sans-serif).\n"
    },
    "com.brand-atoms.references": {
      "palette": "hey@1.0.0",
      "fonts": {
        "heading": "helvetica-neue@1.0.0",
        "body": "helvetica-neue@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}
