{
  "$description": "Brand: X (formerly Twitter) (x-twitter@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette x-twitter@1.0.0",
      "x-black": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Canonical canvas — the X identity reads as the white mark on black."
      },
      "x-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Inverse canvas / mark fill — the X mark renders white on black or black on white."
      },
      "x-dim": {
        "$value": "#15202B",
        "$type": "color",
        "$description": "\"Dim\" surface — the desaturated near-navy product canvas inherited from Twitter's three-mode theme system, still surfaced on x.com under the Display settings.\n"
      },
      "x-dim-elevated": {
        "$value": "#1E2732",
        "$type": "color",
        "$description": "Authored elevated surface on the Dim canvas — modals, hover rows."
      },
      "x-charcoal": {
        "$value": "#16181C",
        "$type": "color",
        "$description": "Authored elevated surface on the Lights Out (pure-black) canvas — rows, tile borders, and modal backgrounds on x.com dark mode.\n"
      },
      "x-gray": {
        "$value": "#71767B",
        "$type": "color",
        "$description": "Secondary text and icon tone on the dark canvas."
      },
      "x-gray-light": {
        "$value": "#E7E9EA",
        "$type": "color",
        "$description": "Primary text tone on the dark canvas (off-white)."
      },
      "x-gray-border": {
        "$value": "#2F3336",
        "$type": "color",
        "$description": "Hairline divider and border tone on the dark canvas."
      },
      "twitter-blue-legacy": {
        "$value": "#1DA1F2",
        "$type": "color",
        "$description": "The pre-2023 Twitter Blue. Retained as a deprecated reference for historical applications and migration documentation only; not part of the current X monochrome identity.\n"
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Chirp",
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Chirp (chirp@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Chirp",
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Chirp (chirp@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$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.mark",
        "severity": "error",
        "rationale": "The post-2023 X mark is monochrome — black on light surfaces or white on dark surfaces. The legacy Twitter Blue is explicitly out of scope for the current identity; mid-grays compromise the high-contrast reading the brand depends on.\n",
        "allowed": [
          "x-black",
          "x-white"
        ],
        "forbidden": [
          "twitter-blue-legacy",
          "x-gray",
          "x-charcoal",
          "x-dim"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "The X brand toolkit prescribes the X mark only in approved black-or-white variants with adequate clearspace. Recoloring the X into Twitter Blue or any other chromatic value violates the deliberate monochrome reduction that defines the post-rebrand identity.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "inverted-without-variant",
          "chromatic-accent",
          "twitter-blue-recolor"
        ]
      },
      {
        "type": "variantSelection",
        "target": "logo",
        "severity": "error",
        "rationale": "On dark surfaces (the canonical X.com canvas), the white X mark is required for legibility. Do not invert the mark file on the fly or apply a chromatic fill.\n",
        "when": {
          "backgroundColorScheme": "dark"
        },
        "use": "x-mark-white"
      },
      {
        "type": "variantSelection",
        "target": "logo",
        "severity": "error",
        "rationale": "On light surfaces, the black X mark is required. The mark on x.com light mode and on light marketing surfaces is solid black.\n",
        "when": {
          "backgroundColorScheme": "light"
        },
        "use": "x-mark-black"
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "WCAG 2.1 Level AA contrast minimum for body text. X Gray Light (#E7E9EA) on X Black (#000000) reads at ~17.4:1 — comfortably above AA. The rule encodes the floor for any new foreground/background pairing introduced on X-skinned surfaces.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.identity",
        "severity": "error",
        "rationale": "The X brand-use guidance prohibits placement of the X mark in ways that imply endorsement, on competing-product surfaces, or in ways that imply continuity with retired Twitter branding (e.g., pairing the X mark with the bird).\n",
        "forbiddenContexts": [
          "product-of-competitor",
          "endorsement-implication",
          "twitter-era-rebrand-suggestion"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "Chirp is distributed with discrete weights Regular (400), Medium (500), Bold (700), and Heavy (800). X's marketing headlines and the wordmark sit in the 500–800 band; lighter cuts compromise the deliberate, declarative voice the post-rebrand identity depends on.\n",
        "allowed": [
          "500",
          "700",
          "800"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The dark-first canvas makes contrast checks the default verification on any new role pairing.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "warning",
        "rationale": "X's marketing headlines run substantially larger than body copy. A 1.5× minimum size ratio preserves the declarative display-to- prose hierarchy the post-rebrand voice depends on.\n",
        "requires": "body",
        "minSizeRatio": 1.5
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://about.x.com/en/who-we-are/brand-toolkit",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "X and the X mark are registered trademarks of X Corp. This atom reads the publicly available X brand toolkit at about.x.com/en/who-we-are/brand-toolkit; it is not an official X brand-guidelines document. Chirp is X's proprietary corporate typeface (designed with Grilli Type) and is referenced here with a public-web fallback to Inter when the licensed file is unavailable.\n",
      "importedDate": "2026-05-18",
      "notes": "X's canonical brand-mark surface is dark-first: the white X on a black canvas is the most-recognized form across the X.com product and in marketing. The light-mode role mapping is the published inverse — black mark on white canvas — and is equally canonical per the brand toolkit. Legacy Twitter Blue (#1DA1F2) is documented in the palette atom as a deprecated reference only.\n"
    },
    "com.brand-atoms.references": {
      "palette": "x-twitter@1.0.0",
      "fonts": {
        "heading": "chirp@1.0.0",
        "body": "chirp@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}