{
  "$description": "Brand: Rivian (rivian@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette rivian@1.0.0",
      "rivian-blue": {
        "$value": "#004B87",
        "$type": "color",
        "$description": "Rivian's signature corporate navy-teal — the wordmark and corporate chrome."
      },
      "rivian-blue-deep": {
        "$value": "#003560",
        "$type": "color",
        "$description": "Pressed / hover variant of Rivian Blue for interactive states."
      },
      "rivian-lemon": {
        "$value": "#FCE300",
        "$type": "color",
        "$description": "Adventure-line accent — used historically on R1T launch livery, signage, and high-priority highlights."
      },
      "rivian-black": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Canonical canvas — rivian.com hero modules and the brand's identity surface default to true black."
      },
      "rivian-near-black": {
        "$value": "#0B0B0C",
        "$type": "color",
        "$description": "Surface color just above true black — used for the dark product chrome."
      },
      "rivian-charcoal": {
        "$value": "#1A1A1C",
        "$type": "color",
        "$description": "Elevated surface — card and modal backgrounds on the dark canvas."
      },
      "rivian-graphite": {
        "$value": "#33333A",
        "$type": "color",
        "$description": "Border on dark surfaces; secondary surface on light."
      },
      "rivian-stone": {
        "$value": "#7A7A82",
        "$type": "color",
        "$description": "Tertiary text and icon color on the dark canvas."
      },
      "rivian-fog": {
        "$value": "#D9D9DC",
        "$type": "color",
        "$description": "Light surface neutral; secondary text on dark."
      },
      "rivian-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Primary text on the dark canvas; canvas color for light-mode marketing surfaces."
      },
      "rivian-success": {
        "$value": "#1F8A4C",
        "$type": "color",
        "$description": "Functional success — charge complete, system OK."
      },
      "rivian-error": {
        "$value": "#C0392B",
        "$type": "color",
        "$description": "Functional error — destructive / unavailable."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Inter (inter@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"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Inter (inter@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"
        },
        "900": {
          "$value": 900,
          "$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": "colorChoice",
        "target": "logo.wordmark.fill",
        "severity": "error",
        "rationale": "The Rivian wordmark renders in Rivian Blue, white, or black depending on the surface. The Rivian Lemon adventure accent is a livery and CTA hue — not a wordmark fill. The pressed-blue variant is an interactive-state value, and the neutral grays are surface / text colors.\n",
        "allowed": [
          "rivian-blue",
          "rivian-white",
          "rivian-black"
        ],
        "forbidden": [
          "rivian-lemon",
          "rivian-blue-deep",
          "rivian-stone",
          "rivian-graphite"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "The Rivian wordmark and \"R\" mark are rendered flat with generous clearspace. Gradients, shadows, recolorings, and busy-background placements compromise the cinematic, engineered identity Rivian's brand depends on against landscape photography.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "gradient-fill",
          "on-busy-photo",
          "placed-without-clearspace",
          "inverted-without-variant"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Rivian White (#FFFFFF) on Rivian Black (#000000) gives 21:1 — the maximum contrast achievable. The dark-first canvas makes contrast checks the default verification on any new role pairing; AA is the floor.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.accent",
        "severity": "error",
        "rationale": "Rivian Lemon (#FCE300) on Rivian Black (#000000) gives ~17:1 — well above the 3:1 large-text / UI-component AA floor. Because Lemon carries high-priority highlights on the dark canvas, the rule encodes the expectation explicitly.\n",
        "against": "background",
        "minRatio": 3,
        "standard": "WCAG-AA-large"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.accent",
        "severity": "error",
        "rationale": "Rivian Lemon is reserved for high-priority CTAs, adventure livery moments, and the R1T/R1S launch line. Using it in body copy, as a subtle divider, or as an error-state hue conflicts with its established adventure / promotional meaning and weakens the saturated yellow's optical impact.\n",
        "allowedContexts": [
          "call-to-action",
          "high-priority-promotion",
          "adventure-livery"
        ],
        "forbiddenContexts": [
          "body-text",
          "subtle-divider",
          "error-state"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "Rivian's marketing and product headlines on rivian.com sit most commonly in the Regular (400) through Bold (700) band. Lighter and heavier extremes are not part of the standard brand chrome.\n",
        "allowed": [
          "400",
          "500",
          "700"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The dark-first canvas and the safety-critical contexts Rivian surfaces appear in (in-vehicle UI, charge-status monitoring) make contrast checks the non-negotiable floor.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.accent",
        "severity": "recommendation",
        "rationale": "Rivian Lemon reads cleanest against the near-black dark canvas. Pairing it adjacent to the deep navy brand blue or the functional error red creates a chromatic conflict — the adventure accent fights for attention with the corporate chrome or signals a status meaning it does not carry.\n",
        "pairsWith": [
          "rivian-black",
          "rivian-near-black",
          "rivian-charcoal"
        ],
        "doesNotPairWith": [
          "rivian-blue",
          "rivian-error"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://raw.githubusercontent.com/simple-icons/simple-icons/13.0.0/_data/simple-icons.json",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Rivian Automotive, Inc. — Rivian, the Rivian wordmark, and the Rivian \"R\" mark are trademarks of Rivian Automotive, Inc. The signature blue (#004B87) is verified via the simple-icons brand database (v13.0.0). Rivian does not maintain a publicly visible brand-guidelines or design-system page; rivian.com is the primary reference for product chrome.\n",
      "importedDate": "2026-05-19",
      "notes": "Rivian uses a proprietary corporate sans on its marketing site that is not publicly distributed. This atom references Inter@1 as the open-source rendering substitute for the sans roles. The supporting neutral ramp and the Rivian Lemon adventure accent in the referenced palette are authored complements faithful to rivian.com's chrome rather than lifted from a single Rivian-published token table; see the palette atom notes. Dark is declared as identity per the brand's actual deployment surface.\n"
    },
    "com.brand-atoms.references": {
      "palette": "rivian@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}