{
  "id": "stanford",
  "version": "1.0.0",
  "name": "Stanford",
  "description": "Stanford University — the private research university whose institutional voice has rested on Cardinal red since the university's founding. The Stanford Identity Guide pairs Cardinal Red (#8C1515) with a warm black (#2E2D29) and Cool Grey on a white canvas, with a distinct digital palette that reserves Digital Blue for links and Digital Green for form validation. The brand voice is restrained, scholarly, and unmistakably West-Coast: confident colour, generous whitespace, and a refusal to use Digital Red as a stand-in for Cardinal.\n",
  "provenance": {
    "source": "https://identity.stanford.edu/design-elements/color/primary-colors/",
    "license": "Proprietary — All Rights Reserved (Stanford trademarks)",
    "attribution": "The Board of Trustees of The Leland Stanford Junior University — visual identity captured from the Stanford Identity Guide (identity.stanford.edu). \"Stanford,\" the Stanford block-S, the Stanford wordmark, and the Stanford tree are registered trademarks of the Board of Trustees.\n",
    "importedDate": "2026-05-19",
    "notes": "Stanford ships a proprietary type system anchored on Source Sans 3 and Source Serif 4 (both open-source) for digital surfaces. This atom references inter@1 as the sans surrogate where Source Sans is not the chosen substitute, source-serif-4@1 is unavailable in catalogue so lora@1 is used as the serif substitute, and jetbrainsmono-nerdfont@1 for code. The Identity Guide is explicit that Digital Red is \"not a replacement for Cardinal Red\" and that Digital Blue is reserved for links. Assets are kept empty per trademark policy.\n"
  },
  "tags": [
    "stanford",
    "university",
    "education",
    "cardinal",
    "conservative-institutional",
    "light-first"
  ],
  "palette": {
    "ref": "stanford@1.0.0",
    "swatches": [
      {
        "id": "cardinal-red",
        "name": "Cardinal Red",
        "value": "#8C1515",
        "description": "Stanford's institutional cardinal — primary brand colour.",
        "aliases": []
      },
      {
        "id": "cardinal-red-light",
        "name": "Cardinal Red Light",
        "value": "#B83A4B",
        "description": "Light tint of Cardinal Red for surface accents.",
        "aliases": []
      },
      {
        "id": "cardinal-red-dark",
        "name": "Cardinal Red Dark",
        "value": "#820000",
        "description": "Deep Cardinal — pressed / active variant.",
        "aliases": []
      },
      {
        "id": "white",
        "name": "White",
        "value": "#FFFFFF",
        "description": "Primary canvas in light mode.",
        "aliases": []
      },
      {
        "id": "black",
        "name": "Black",
        "value": "#2E2D29",
        "description": "Warm near-black — primary text on light surfaces.",
        "aliases": []
      },
      {
        "id": "cool-grey",
        "name": "Cool Grey",
        "value": "#53565A",
        "description": "Secondary text / supporting neutral.",
        "aliases": []
      },
      {
        "id": "black-90",
        "name": "Black 90",
        "value": "#43423E",
        "description": "90% black tint — deep text on lighter surfaces.",
        "aliases": []
      },
      {
        "id": "black-10",
        "name": "Black 10",
        "value": "#EAEAEA",
        "description": "10% black tint — soft surface / divider.",
        "aliases": []
      },
      {
        "id": "digital-red",
        "name": "Digital Red",
        "value": "#B1040E",
        "description": "Digital accent red — emphasis only, not a replacement for Cardinal.",
        "aliases": []
      },
      {
        "id": "digital-red-light",
        "name": "Digital Red Light",
        "value": "#E50808",
        "description": "Light digital red — interactive emphasis.",
        "aliases": []
      },
      {
        "id": "digital-red-dark",
        "name": "Digital Red Dark",
        "value": "#820000",
        "description": "Dark digital red — pressed state.",
        "aliases": []
      },
      {
        "id": "digital-blue",
        "name": "Digital Blue",
        "value": "#006CB8",
        "description": "Reserved for links on digital surfaces.",
        "aliases": []
      },
      {
        "id": "digital-blue-light",
        "name": "Digital Blue Light",
        "value": "#6FC3FF",
        "description": "Hover / focus link variant.",
        "aliases": []
      },
      {
        "id": "digital-blue-dark",
        "name": "Digital Blue Dark",
        "value": "#00548F",
        "description": "Visited / active link variant.",
        "aliases": []
      },
      {
        "id": "digital-green",
        "name": "Digital Green",
        "value": "#008566",
        "description": "Form-validation success.",
        "aliases": []
      },
      {
        "id": "digital-green-light",
        "name": "Digital Green Light",
        "value": "#1AECBA",
        "description": "Light validation green — confirmation surfaces.",
        "aliases": []
      },
      {
        "id": "digital-green-dark",
        "name": "Digital Green Dark",
        "value": "#006F54",
        "description": "Dark validation green — pressed state.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "white",
          "surface": "black-10",
          "surface-elevated": "white",
          "text-primary": "black",
          "text-secondary": "cool-grey",
          "text-tertiary": "black-90",
          "primary": "cardinal-red",
          "primary-hover": "cardinal-red-dark",
          "accent": "digital-red",
          "accent-hover": "digital-red-dark",
          "link": "digital-blue",
          "link-hover": "digital-blue-dark",
          "warning": "digital-red",
          "warning-hover": "digital-red-dark",
          "error": "digital-red",
          "success": "digital-green",
          "border": "black-10"
        }
      },
      "dark": {
        "roles": {
          "background": "black",
          "surface": "black-90",
          "surface-elevated": "cool-grey",
          "text-primary": "white",
          "text-secondary": "black-10",
          "text-tertiary": "cool-grey",
          "primary": "cardinal-red-light",
          "primary-hover": "cardinal-red",
          "accent": "digital-red-light",
          "accent-hover": "digital-red",
          "link": "digital-blue-light",
          "link-hover": "digital-blue",
          "warning": "digital-red-light",
          "warning-hover": "digital-red",
          "error": "digital-red-light",
          "success": "digital-green-light",
          "border": "cool-grey"
        }
      }
    }
  },
  "fonts": [
    {
      "role": "heading",
      "ref": "source-sans-3@1.0.0",
      "family": "Source Sans 3",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Source Sans 3",
        "url": "https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,200..900;1,200..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "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": "body",
      "ref": "source-sans-3@1.0.0",
      "family": "Source Sans 3",
      "classification": "sans-serif",
      "source": {
        "kind": "google-fonts",
        "family": "Source Sans 3",
        "url": "https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,200..900;1,200..900&display=swap"
      },
      "fallbackStack": [
        "-apple-system",
        "BlinkMacSystemFont",
        "Segoe UI",
        "Roboto",
        "Helvetica Neue",
        "Arial",
        "sans-serif"
      ],
      "availableStyles": [
        {
          "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": "serif",
      "ref": "lora@1.0.0",
      "family": "Lora",
      "classification": "serif",
      "source": {
        "kind": "google-fonts",
        "family": "Lora",
        "url": "https://fonts.googleapis.com/css2?family=Lora:ital,wght@0,400..700;1,400..700&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"
        }
      ]
    },
    {
      "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": "black",
      "primary": "cardinal-red",
      "primary-hover": "cardinal-red-dark",
      "accent": "digital-red",
      "accent-hover": "digital-red-dark",
      "mark": "cardinal-red",
      "success": "digital-green",
      "warning": "digital-red",
      "error": "digital-red",
      "text-primary-light": "black",
      "text-primary-dark": "white",
      "background-light": "white",
      "background-dark": "black",
      "surface-light": "black-10",
      "surface-dark": "black-90",
      "text-secondary-light": "cool-grey",
      "text-tertiary-light": "black-90",
      "border-light": "black-10"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Cardinal Red (#8C1515) is Stanford's institutional colour. The Stanford Identity Guide is explicit that Digital Red \"is not a replacement for Cardinal red\" and that Digital Blue and Digital Green are role-restricted (links and form validation). The primary brand colour role MUST be Cardinal — no exceptions.\n",
      "allowed": [
        "cardinal-red",
        "cardinal-red-dark"
      ],
      "forbidden": [
        "digital-red",
        "digital-red-light",
        "digital-blue",
        "digital-green"
      ]
    },
    {
      "type": "colorChoice",
      "target": "roles.colors.mark",
      "severity": "error",
      "rationale": "The Stanford wordmark, block-S, and tree mark are reproduced in Cardinal Red, solid black, or solid white (reversed). Digital Red MUST NOT be used to colorize the Stanford wordmark per the published guidance.\n",
      "allowed": [
        "cardinal-red",
        "black",
        "white"
      ],
      "forbidden": [
        "digital-red",
        "digital-red-light",
        "digital-blue",
        "cardinal-red-light"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "Stanford Black (#2E2D29) on white gives ~14:1 — clears AAA. As a research university with extensive long-form scholarly content and obligations under ADA / Section 504, Stanford's surfaces target the enhanced 7:1 floor rather than the AA 4.5:1 minimum.\n",
      "against": "background",
      "minRatio": 7,
      "standard": "WCAG-AAA"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.link",
      "severity": "error",
      "rationale": "The Identity Guide reserves Digital Blue (#006CB8) \"exclusively for links\" on digital communications. Repurposing it for confirmation, error, or data-viz roles breaks the link-affordance contract Stanford visitors rely on.\n",
      "allowedContexts": [
        "link",
        "navigation"
      ],
      "forbiddenContexts": [
        "error-state",
        "confirmation",
        "destructive-action",
        "data-viz-positive"
      ]
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.success",
      "severity": "error",
      "rationale": "Digital Green (#008566) is documented as the form-validation colour. Using it for errors or as a link colour inverts the semantics the Identity Guide assigns it.\n",
      "allowedContexts": [
        "confirmation",
        "completion",
        "form-validation",
        "data-viz-positive"
      ],
      "forbiddenContexts": [
        "error-state",
        "destructive-action",
        "link"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "Stanford's brand standards prohibit stretching, rotating, recolouring, outlining, or applying decorative treatments to the wordmark, block-S, or tree. Marks render in solid Cardinal Red, solid black, or solid white only, with documented clear-space.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "outlined",
        "gradient-fill",
        "on-busy-photo",
        "tilted"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "warning",
      "rationale": "Stanford's Identity Guide type ramp anchors on Regular (400), SemiBold (600), and Bold (700) for headings and body. Heavier display cuts (800/900) are not part of the published institutional ramp.\n",
      "allowed": [
        "400",
        "600",
        "700"
      ]
    },
    {
      "type": "fontPairing",
      "target": "typography.display",
      "severity": "error",
      "rationale": "Stanford's editorial hierarchy pairs a large display sans with body sans at a minimum 1.5× ratio. The Identity Guide depends on that gap for the legible scholarly voice the institution projects.\n",
      "requires": "prose",
      "minSizeRatio": 1.5
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "warning",
      "rationale": "WCAG 2.1 Success Criterion 1.4.6 (Contrast Enhanced) — Level AAA. Stanford's research / scholarly posture and its obligations to a diverse academic community justify the enhanced 7:1 target on core text-on-background pairs.\n",
      "standard": "WCAG-AAA",
      "criterion": "1.4.6"
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "Cardinal Red reads cleanest on white, soft black-tint surfaces, or against the warm institutional black. Adjacent to Digital Red or the light Cardinal tint, the two reds vibrate without resolving into hierarchy — and the Identity Guide treats their roles as semantically distinct.\n",
      "pairsWith": [
        "white",
        "black-10",
        "black"
      ],
      "doesNotPairWith": [
        "digital-red",
        "digital-red-light",
        "cardinal-red-light"
      ]
    }
  ]
}