{
  "id": "x-twitter",
  "version": "1.0.0",
  "name": "X (formerly Twitter)",
  "description": "X (formerly Twitter) is the real-time, public-square social platform acquired by Elon Musk in 2022 and rebranded from Twitter to X in July 2023. The post-rebrand identity is a deliberate monochrome reduction: a single geometric X mark in white-on-black or black-on-white, with no chromatic accent surviving from the Twitter Blue era. The product surface retains a multi-mode theme (default dark, \"Lights Out\" pure-black, light), but the brand-mark surface is one of two values — black or white — with the proprietary Chirp typeface carrying the marketing voice.\n",
  "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"
  },
  "tags": [
    "social",
    "x",
    "twitter",
    "monochrome",
    "dark-first",
    "consumer-tech"
  ],
  "palette": {
    "ref": "x-twitter@1.0.0",
    "swatches": [
      {
        "id": "x-black",
        "name": "X Black",
        "value": "#000000",
        "description": "Canonical canvas — the X identity reads as the white mark on black.",
        "aliases": []
      },
      {
        "id": "x-white",
        "name": "X White",
        "value": "#FFFFFF",
        "description": "Inverse canvas / mark fill — the X mark renders white on black or black on white.",
        "aliases": []
      },
      {
        "id": "x-dim",
        "name": "X Dim",
        "value": "#15202B",
        "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",
        "aliases": []
      },
      {
        "id": "x-dim-elevated",
        "name": "X Dim Elevated",
        "value": "#1E2732",
        "description": "Authored elevated surface on the Dim canvas — modals, hover rows.",
        "aliases": []
      },
      {
        "id": "x-charcoal",
        "name": "X Charcoal",
        "value": "#16181C",
        "description": "Authored elevated surface on the Lights Out (pure-black) canvas — rows, tile borders, and modal backgrounds on x.com dark mode.\n",
        "aliases": []
      },
      {
        "id": "x-gray",
        "name": "X Gray",
        "value": "#71767B",
        "description": "Secondary text and icon tone on the dark canvas.",
        "aliases": []
      },
      {
        "id": "x-gray-light",
        "name": "X Gray Light",
        "value": "#E7E9EA",
        "description": "Primary text tone on the dark canvas (off-white).",
        "aliases": []
      },
      {
        "id": "x-gray-border",
        "name": "X Gray Border",
        "value": "#2F3336",
        "description": "Hairline divider and border tone on the dark canvas.",
        "aliases": []
      },
      {
        "id": "twitter-blue-legacy",
        "name": "Twitter Blue (Legacy)",
        "value": "#1DA1F2",
        "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",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "x-white",
          "surface": "x-white",
          "surface-elevated": "x-white",
          "text-primary": "x-black",
          "text-secondary": "x-gray",
          "text-tertiary": "x-gray",
          "primary": "x-black",
          "primary-hover": "x-charcoal",
          "accent": "x-black",
          "accent-hover": "x-charcoal",
          "warning": "x-black",
          "warning-hover": "x-charcoal",
          "error": "x-black",
          "success": "x-black"
        }
      },
      "dark": {
        "roles": {
          "background": "x-black",
          "surface": "x-charcoal",
          "surface-elevated": "x-dim-elevated",
          "text-primary": "x-gray-light",
          "text-secondary": "x-gray",
          "text-tertiary": "x-gray",
          "primary": "x-white",
          "primary-hover": "x-gray-light",
          "accent": "x-white",
          "accent-hover": "x-gray-light",
          "warning": "x-white",
          "warning-hover": "x-gray-light",
          "error": "x-white",
          "success": "x-white"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "chirp@1.0.0",
      "family": "Chirp",
      "classification": "sans-serif",
      "source": {
        "kind": "external",
        "family": "Chirp",
        "notes": "Licensed font; no public CDN. Distributed by X Corp to authorized brand-use partners. CSS @font-face declarations must reference internally hosted files under X's licensing.\n"
      },
      "fallbackStack": [
        "Inter",
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "normal"
        }
      ]
    },
    {
      "role": "body",
      "ref": "chirp@1.0.0",
      "family": "Chirp",
      "classification": "sans-serif",
      "source": {
        "kind": "external",
        "family": "Chirp",
        "notes": "Licensed font; no public CDN. Distributed by X Corp to authorized brand-use partners. CSS @font-face declarations must reference internally hosted files under X's licensing.\n"
      },
      "fallbackStack": [
        "Inter",
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "normal"
        }
      ]
    },
    {
      "role": "mono",
      "ref": "jetbrainsmono-nerdfont@1.0.0",
      "family": "JetBrainsMono Nerd Font",
      "classification": "monospace",
      "source": {
        "kind": "external",
        "family": "JetBrainsMono Nerd Font",
        "notes": "Nerd-Font-patched build of JetBrains Mono. Not available via Google Fonts. Download woff2/ttf files from the Nerd Fonts GitHub release and self-host, or install system-wide for terminal/IDE use.\n"
      },
      "fallbackStack": [
        "JetBrains Mono",
        "Fira Code",
        "Menlo",
        "Monaco",
        "Consolas",
        "Liberation Mono",
        "monospace"
      ],
      "availableStyles": [
        {
          "weight": 100,
          "style": "normal"
        },
        {
          "weight": 100,
          "style": "italic"
        },
        {
          "weight": 200,
          "style": "normal"
        },
        {
          "weight": 200,
          "style": "italic"
        },
        {
          "weight": 300,
          "style": "normal"
        },
        {
          "weight": 300,
          "style": "italic"
        },
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 500,
          "style": "normal"
        },
        {
          "weight": 500,
          "style": "italic"
        },
        {
          "weight": 600,
          "style": "normal"
        },
        {
          "weight": 600,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        },
        {
          "weight": 800,
          "style": "normal"
        },
        {
          "weight": 800,
          "style": "italic"
        }
      ]
    }
  ],
  "roles": {
    "colors": {
      "identity": "x-black",
      "on-identity": "x-white",
      "background": "x-black",
      "surface": "x-charcoal",
      "surface-elevated": "x-dim-elevated",
      "text-primary": "x-gray-light",
      "text-secondary": "x-gray",
      "text-tertiary": "x-gray",
      "primary": "x-white",
      "primary-hover": "x-gray-light",
      "accent": "x-white",
      "accent-hover": "x-gray-light",
      "mark": "x-white",
      "text-emphasis": "x-gray-light",
      "text-muted": "x-gray"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "wordmark": "heading",
      "code": "mono"
    }
  },
  "assets": [],
  "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
    }
  ]
}