{
  "id": "nyt",
  "version": "1.0.0",
  "name": "The New York Times",
  "description": "The New York Times is the paper of record — a 170-year-old newsroom whose brand voice is authoritative, considered, and visually anchored in serif typography on bright white. The identity on nytimes.com renders as near-black ink on paper-white, with a desaturated reading blue for in-copy links and the masthead's deep red reserved for breaking-news bridges. The proprietary type family — Cheltenham (display serif), Imperial (body serif), and Franklin (sans) — carries the editorial voice.\n",
  "provenance": {
    "source": "https://www.nytimes.com/",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "The New York Times Company — visual identity captured from the deployed HTML and inline CSS on nytimes.com. The New York Times, its masthead, and the Cheltenham / Imperial / Franklin typefaces are property of The New York Times Company.\n",
    "importedDate": "2026-05-19",
    "notes": "Derived from live site CSS at https://www.nytimes.com/ on 2026-05-19; no public brand guide located. The proprietary NYT type family (nyt-cheltenham, nyt-imperial, nyt-franklin) is declared in @font-face on the live site but is not publicly distributed. Open-source substitutes are referenced here — playfair-display@1 for the display serif, pt-serif@1 for body prose, and inter@1 for the sans role.\n"
  },
  "tags": [
    "nyt",
    "new-york-times",
    "news",
    "journalism",
    "brand",
    "serif",
    "paper",
    "light-first"
  ],
  "palette": {
    "ref": "nyt@1.0.0",
    "swatches": [
      {
        "id": "ink-black",
        "name": "Ink Black",
        "value": "#121212",
        "description": "Primary body text; the deep ink of a newspaper print page.",
        "aliases": []
      },
      {
        "id": "ink-medium",
        "name": "Ink Medium",
        "value": "#363636",
        "description": "Secondary text; deck and byline weight.",
        "aliases": []
      },
      {
        "id": "ink-light",
        "name": "Ink Light",
        "value": "#5A5A5A",
        "description": "Tertiary text; meta, timestamps, kicker labels.",
        "aliases": []
      },
      {
        "id": "gray-light",
        "name": "Gray Light",
        "value": "#727272",
        "description": "Quiet meta text; disabled captions.",
        "aliases": []
      },
      {
        "id": "gray-rule",
        "name": "Gray Rule",
        "value": "#979797",
        "description": "Hairline rule between stories; column dividers.",
        "aliases": []
      },
      {
        "id": "gray-border",
        "name": "Gray Border",
        "value": "#C7C7C7",
        "description": "Heavier border; card outlines.",
        "aliases": []
      },
      {
        "id": "gray-divider",
        "name": "Gray Divider",
        "value": "#DFDFDF",
        "description": "Section divider; quiet block boundary.",
        "aliases": []
      },
      {
        "id": "gray-tint",
        "name": "Gray Tint",
        "value": "#EBEBEB",
        "description": "Pull-quote background; chip surface.",
        "aliases": []
      },
      {
        "id": "gray-surface",
        "name": "Gray Surface",
        "value": "#F7F7F7",
        "description": "Alternating row tint; subtle inset surface.",
        "aliases": []
      },
      {
        "id": "paper",
        "name": "Paper",
        "value": "#F8F8F8",
        "description": "Newsprint-like off-white; quiet section canvas.",
        "aliases": []
      },
      {
        "id": "white",
        "name": "White",
        "value": "#FFFFFF",
        "description": "Primary page canvas; the bright digital sheet.",
        "aliases": []
      },
      {
        "id": "reading-blue",
        "name": "Reading Blue",
        "value": "#346EB7",
        "description": "In-copy link color; the desaturated NYT blue.",
        "aliases": []
      },
      {
        "id": "reading-blue-hover",
        "name": "Reading Blue Hover",
        "value": "#2B8AD8",
        "description": "Brighter blue for link hover and interactive emphasis.",
        "aliases": []
      },
      {
        "id": "masthead-red",
        "name": "Masthead Red",
        "value": "#D0021B",
        "description": "Breaking-news red; masthead-bridge accent.",
        "aliases": []
      },
      {
        "id": "masthead-red-bright",
        "name": "Masthead Red Bright",
        "value": "#F4564A",
        "description": "Brighter red used in live-update pulses and tags.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "white",
          "surface": "paper",
          "surface-elevated": "white",
          "text-primary": "ink-black",
          "text-secondary": "ink-medium",
          "text-tertiary": "ink-light",
          "primary": "reading-blue",
          "primary-hover": "reading-blue-hover",
          "accent": "masthead-red",
          "accent-hover": "masthead-red-bright",
          "error": "masthead-red",
          "border": "gray-divider"
        }
      },
      "dark": {
        "roles": {
          "background": "ink-black",
          "surface": "ink-medium",
          "surface-elevated": "ink-light",
          "text-primary": "white",
          "text-secondary": "gray-divider",
          "text-tertiary": "gray-border",
          "primary": "reading-blue-hover",
          "primary-hover": "reading-blue",
          "accent": "masthead-red-bright",
          "accent-hover": "masthead-red",
          "error": "masthead-red-bright",
          "border": "ink-light"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "playfair-display@1.0.0",
      "family": "Playfair Display",
      "classification": "serif",
      "source": {
        "kind": "google-fonts",
        "family": "Playfair Display",
        "url": "https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,400..900;1,400..900&display=swap"
      },
      "fallbackStack": [
        "Iowan Old Style",
        "Apple Garamond",
        "Baskerville",
        "Times New Roman",
        "serif"
      ],
      "availableStyles": [
        {
          "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"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "role": "body",
      "ref": "pt-serif@1.0.0",
      "family": "PT Serif",
      "classification": "serif",
      "source": {
        "kind": "google-fonts",
        "family": "PT Serif",
        "url": "https://fonts.googleapis.com/css2?family=PT+Serif:ital,wght@0,400;0,700;1,400;1,700&display=swap"
      },
      "fallbackStack": [
        "Charter",
        "Georgia",
        "Times New Roman",
        "serif"
      ],
      "availableStyles": [
        {
          "weight": 400,
          "style": "normal"
        },
        {
          "weight": 400,
          "style": "italic"
        },
        {
          "weight": 700,
          "style": "normal"
        },
        {
          "weight": 700,
          "style": "italic"
        }
      ]
    },
    {
      "role": "sans",
      "ref": "inter@1.0.0",
      "family": "Inter",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Inter",
        "url": "https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "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"
        },
        {
          "weight": 900,
          "style": "normal"
        },
        {
          "weight": 900,
          "style": "italic"
        }
      ]
    },
    {
      "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": "white",
      "on-identity": "ink-black",
      "primary": "reading-blue",
      "primary-hover": "reading-blue-hover",
      "accent": "masthead-red",
      "accent-hover": "masthead-red-bright",
      "mark": "ink-black",
      "error": "masthead-red",
      "text-primary-light": "ink-black",
      "text-primary-dark": "white",
      "background-light": "white",
      "background-dark": "ink-black",
      "surface-light": "paper",
      "surface-dark": "ink-medium",
      "text-secondary-light": "ink-medium",
      "text-tertiary-light": "ink-light",
      "border-light": "gray-divider"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "ui": "sans",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "Ink Black (#121212) on White (#FFFFFF) gives ~18:1 — well past AAA. The NYT's long-form reading posture and the density of body type on a typical article page justify the AAA enhanced contrast target rather than the AA floor.\n",
      "against": "background",
      "minRatio": 7,
      "standard": "WCAG-AAA"
    },
    {
      "type": "colorChoice",
      "target": "roles.colors.accent",
      "severity": "error",
      "rationale": "The masthead red (#D0021B) is reserved for breaking-news bridges, live-update kickers, and the legacy masthead bridge. Substituting reading-blue (the in-copy link color) for the accent role would conflate the link-affordance meaning with the breaking-news meaning.\n",
      "allowed": [
        "masthead-red",
        "masthead-red-bright"
      ],
      "forbidden": [
        "reading-blue",
        "reading-blue-hover"
      ]
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.accent",
      "severity": "error",
      "rationale": "Masthead Red carries semantic weight in NYT's editorial grammar — it signals urgency and live coverage. Using it as a default CTA or in-copy link color would dilute that meaning and conflict with the editorial taxonomy.\n",
      "allowedContexts": [
        "breaking-news",
        "live-update",
        "editorial-kicker",
        "masthead"
      ],
      "forbiddenContexts": [
        "default-link",
        "body-emphasis",
        "cta"
      ]
    },
    {
      "type": "fontPairing",
      "target": "typography.display",
      "severity": "error",
      "rationale": "NYT pairs the Cheltenham display serif with Imperial for body prose at a clear size step. The display-to-prose hierarchy is part of how the page reads as a newspaper — a 1.5× minimum ratio preserves that hierarchy when open-source substitutes (Playfair Display / PT Serif) stand in for the proprietary primaries.\n",
      "requires": "prose",
      "minSizeRatio": 1.5
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "The NYT Old English masthead is a near-sacred mark. Any recoloring, rotation, gradient, or skew would conflict with the brand's authority and is forbidden by the NYT brand standards reflected in every published rendering.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "gradient-fill",
        "on-busy-photo",
        "cropped"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "warning",
      "rationale": "WCAG 2.1 Success Criterion 1.4.6 (Contrast Enhanced) — Level AAA. NYT's body type is dense; readers spend long sessions on article pages. The AAA contrast target serves that reading posture better than the AA floor.\n",
      "standard": "WCAG-AAA",
      "criterion": "1.4.6"
    },
    {
      "type": "enumMembership",
      "target": "typography.prose.fontStyle",
      "severity": "warning",
      "rationale": "Imperial (and the PT Serif substitute) ships true italics cut as a separate face. Synthetic oblique skews are forbidden — they degrade legibility of the body face and conflict with the typographic discipline that defines the NYT reading experience.\n",
      "allowed": [
        "normal",
        "italic"
      ],
      "forbidden": [
        "oblique"
      ]
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "Reading Blue (#346EB7) reads cleanest on the paper canvas or against ink. Placing it adjacent to the masthead red introduces an editorial-color collision — the page loses its hierarchy because two competing accent signals fight for attention.\n",
      "pairsWith": [
        "white",
        "paper",
        "ink-black"
      ],
      "doesNotPairWith": [
        "masthead-red",
        "masthead-red-bright"
      ]
    }
  ]
}