{
  "$description": "Brand: YouTube (youtube@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette youtube@1.0.0",
      "youtube-red": {
        "$value": "#FF0000",
        "$type": "color",
        "$description": "Pure signature red — the play-button mark fill, the wordmark accent, and primary CTAs."
      },
      "youtube-red-dark": {
        "$value": "#CC0000",
        "$type": "color",
        "$description": "Darker red used for hover/pressed states on the primary red."
      },
      "youtube-red-light": {
        "$value": "#FF4444",
        "$type": "color",
        "$description": "Lighter red used in marketing gradient surfaces and for emphasis on dark canvases."
      },
      "youtube-black": {
        "$value": "#0F0F0F",
        "$type": "color",
        "$description": "Canonical dark-mode canvas — the deployed youtube.com dark theme background."
      },
      "youtube-near-black": {
        "$value": "#181818",
        "$type": "color",
        "$description": "Elevated surface on dark mode — rows, cards, and modal headers."
      },
      "youtube-charcoal": {
        "$value": "#272727",
        "$type": "color",
        "$description": "Hovered surface and disabled-button background on dark mode."
      },
      "youtube-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Canonical light-mode canvas — the classic YouTube surface."
      },
      "youtube-fog": {
        "$value": "#F2F2F2",
        "$type": "color",
        "$description": "Authored elevated surface on light mode."
      },
      "youtube-ink": {
        "$value": "#030303",
        "$type": "color",
        "$description": "Body text on the light canvas."
      },
      "youtube-graphite": {
        "$value": "#606060",
        "$type": "color",
        "$description": "Secondary text and metadata across both modes."
      },
      "youtube-gray": {
        "$value": "#AAAAAA",
        "$type": "color",
        "$description": "Tertiary text and inactive icons on the dark canvas."
      },
      "youtube-divider": {
        "$value": "#E5E5E5",
        "$type": "color",
        "$description": "Authored hairline divider on light mode."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Roboto",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Roboto (roboto@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Roboto",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Roboto (roboto@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$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.mark.fill",
        "severity": "error",
        "rationale": "The YouTube play-button mark renders in pure red, reversed white on dark surfaces, or monochrome black for print. Hover and lighter reds are interactive-state values; gray tones are chrome — none are acceptable mark fills.\n",
        "allowed": [
          "youtube-red",
          "youtube-white",
          "youtube-ink"
        ],
        "forbidden": [
          "youtube-red-dark",
          "youtube-red-light",
          "youtube-gray",
          "youtube-graphite"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "YouTube's brand-resources program is strict about the play-button mark. The 2017 refresh removed the prior red-rectangle-with-white-wordmark composition in favor of a separated play-button mark + monochrome wordmark — consumers MUST NOT reintroduce gradient or drop-shadow treatments.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "gradient-fill",
          "on-busy-photo",
          "inverted-without-variant"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "YouTube Ink (#030303) on YouTube White gives ~21:1 and YouTube White on YouTube Black (#0F0F0F) gives ~19:1 — both directions clear WCAG 2.1 Level AA with substantial margin.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "YouTube Red on white reaches ~4:1 — AA for large text. On the dark canvas the same red against #0F0F0F gives ~5:1 — AA for normal text. This rule guards interactive use at button size.\n",
        "against": "background",
        "minRatio": 3,
        "standard": "WCAG-AA-large"
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "YouTube Sans and the Roboto system chrome use Regular (400), Medium (500), and Bold (700) on UI surfaces. Lighter cuts read as content metadata; heavier cuts are outside the documented product kit.\n",
        "allowed": [
          "400",
          "500",
          "700"
        ]
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "YouTube Red is reserved for the play-button mark, the subscribe-button affordance, and primary alerts. Using it inside body copy or for secondary links dilutes the signature accent and weakens the affordance the red carries throughout the product.\n",
        "forbiddenContexts": [
          "body-text",
          "secondary-link"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The bimodal canvas makes contrast checks the default verification on any new role pairing.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "variantSelection",
        "target": "logo",
        "severity": "error",
        "rationale": "On the dark YouTube canvas, the wordmark renders in white with the play-button mark in red. Do not invert the white wordmark to black on the dark canvas.\n",
        "when": {
          "backgroundColorScheme": "dark"
        },
        "use": "youtube-light"
      },
      {
        "type": "variantSelection",
        "target": "logo",
        "severity": "error",
        "rationale": "On the light YouTube canvas, the wordmark renders in YouTube Ink with the play-button mark in red. Do not render the wordmark in white on a light surface.\n",
        "when": {
          "backgroundColorScheme": "light"
        },
        "use": "youtube-dark"
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "warning",
        "rationale": "YouTube's marketing headlines and surface section heads run materially larger than body and metadata text. A 1.4× minimum ratio preserves the display-to-prose hierarchy the product and marketing both depend on.\n",
        "requires": "body",
        "minSizeRatio": 1.4
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://www.youtube.com/about/brand-resources/",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Google LLC — YouTube, the YouTube wordmark, and the play-button mark are registered trademarks of Google LLC. The signature YouTube Red (#FF0000) is documented across YouTube's brand- resources page. YouTube Sans is the proprietary corporate typeface; this atom references Roboto (Google's open-source Apache-licensed corporate sans) as the documented fallback, matching the YouTube product surface which has historically used Roboto for system chrome.\n",
      "importedDate": "2026-05-18",
      "notes": "YouTube Sans (proprietary) is reserved for the wordmark and select marketing surfaces. Roboto (already in this catalog as roboto@1) is the documented public fallback and the long-standing chrome font for YouTube product surfaces. This atom references Roboto for both heading and body roles and notes YouTube Sans as the proprietary primary in provenance.\n"
    },
    "com.brand-atoms.references": {
      "palette": "youtube@1.0.0",
      "fonts": {
        "heading": "roboto@1.0.0",
        "body": "roboto@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}