{
  "id": "huggingface",
  "version": "1.0.0",
  "name": "Hugging Face",
  "description": "Hugging Face is the open community platform for machine-learning models, datasets, and Spaces — the canonical host for open-source AI artifacts. The brand voice is warm, community-first, and emoji- native: the yellow hug-mark (🤗) is the identity anchor, a saturated warm orange supports it, and the marketing surface reads as a bright near-white canvas with deep slate text. The brand is light-first and Source Sans Pro carries body and display.\n",
  "provenance": {
    "source": "https://huggingface.co/brand",
    "license": "Proprietary — All Rights Reserved",
    "attribution": "Hugging Face and the hug-mark are trademarks of Hugging Face, Inc. Primary, secondary, and neutral brand colors captured directly from the official brand-assets page at huggingface.co/brand. Typography and surface tokens captured from the deployed stylesheet on huggingface.co.\n",
    "importedDate": "2026-05-19",
    "notes": "Hugging Face publishes a brand-assets page (huggingface.co/brand) that documents the primary, secondary, and neutral hex values and the logo variants (HF Logo, HF Logo with Title, Monochrome, Pirate) — but does not document a full typography or surface system. Surface and ink tokens are therefore supplemented from the live huggingface.co stylesheet on 2026-05-19. Source Sans Pro is the proprietary body face declared on the marketing site; Source Sans 3 is the open-source rendering substitute used here via the source-sans-3@1 atom.\n"
  },
  "tags": [
    "huggingface",
    "ai",
    "ml",
    "community",
    "warm",
    "yellow",
    "light-first"
  ],
  "palette": {
    "ref": "huggingface@1.0.0",
    "swatches": [
      {
        "id": "hug-yellow",
        "name": "Hug Yellow",
        "value": "#FFD21E",
        "description": "Hugging Face's published primary — the warm yellow of the hug-mark.",
        "aliases": []
      },
      {
        "id": "hug-yellow-deep",
        "name": "Hug Yellow Deep",
        "value": "#E6B800",
        "description": "Pressed / hover variant of hug-yellow for interactive surfaces.",
        "aliases": []
      },
      {
        "id": "hug-orange",
        "name": "Hug Orange",
        "value": "#FF9D00",
        "description": "Hugging Face's published secondary — a warm orange that pairs with the yellow primary.",
        "aliases": []
      },
      {
        "id": "hug-orange-deep",
        "name": "Hug Orange Deep",
        "value": "#CC7E00",
        "description": "Pressed / hover variant of hug-orange.",
        "aliases": []
      },
      {
        "id": "hug-neutral",
        "name": "Hug Neutral",
        "value": "#6B7280",
        "description": "Hugging Face's published neutral gray — the body-meta tone.",
        "aliases": []
      },
      {
        "id": "hub-canvas",
        "name": "Hub Canvas",
        "value": "#FFFFFF",
        "description": "Page canvas — the bright neutral surface huggingface.co reads against.",
        "aliases": []
      },
      {
        "id": "hub-surface",
        "name": "Hub Surface",
        "value": "#F9FAFB",
        "description": "Subtle elevated surface; one step warmer than canvas.",
        "aliases": []
      },
      {
        "id": "hub-surface-elevated",
        "name": "Hub Surface Elevated",
        "value": "#F3F4F6",
        "description": "Card / panel surface elevated above hub-surface.",
        "aliases": []
      },
      {
        "id": "hub-border",
        "name": "Hub Border",
        "value": "#E5E7EB",
        "description": "Quiet divider on the hub canvas.",
        "aliases": []
      },
      {
        "id": "hub-ink",
        "name": "Hub Ink",
        "value": "#111827",
        "description": "Primary text on hub canvas — deep slate near-black.",
        "aliases": []
      },
      {
        "id": "hub-ink-secondary",
        "name": "Hub Ink Secondary",
        "value": "#374151",
        "description": "Secondary text; muted slate for body copy de-emphasis.",
        "aliases": []
      },
      {
        "id": "hub-ink-tertiary",
        "name": "Hub Ink Tertiary",
        "value": "#6B7280",
        "description": "Tertiary text / metadata tone — same hex as the published hug-neutral.",
        "aliases": []
      },
      {
        "id": "hub-night",
        "name": "Hub Night",
        "value": "#0B0F19",
        "description": "Dark-mode canvas — the deep slate the hub flips to.",
        "aliases": []
      },
      {
        "id": "hub-night-surface",
        "name": "Hub Night Surface",
        "value": "#1F2937",
        "description": "Elevated surface in dark mode.",
        "aliases": []
      },
      {
        "id": "hub-night-border",
        "name": "Hub Night Border",
        "value": "#374151",
        "description": "Quiet divider on the hub-night canvas.",
        "aliases": []
      },
      {
        "id": "hub-success",
        "name": "Hub Success",
        "value": "#16A34A",
        "description": "Confirmation / positive state green.",
        "aliases": []
      },
      {
        "id": "hub-error",
        "name": "Hub Error",
        "value": "#DC2626",
        "description": "Error / destructive state red.",
        "aliases": []
      }
    ],
    "modes": {
      "light": {
        "roles": {
          "background": "hub-canvas",
          "surface": "hub-surface",
          "surface-elevated": "hub-surface-elevated",
          "text-primary": "hub-ink",
          "text-secondary": "hub-ink-secondary",
          "text-tertiary": "hub-ink-tertiary",
          "primary": "hug-yellow",
          "primary-hover": "hug-yellow-deep",
          "accent": "hug-orange",
          "accent-hover": "hug-orange-deep",
          "success": "hub-success",
          "warning": "hug-orange",
          "error": "hub-error",
          "border": "hub-border"
        }
      },
      "dark": {
        "roles": {
          "background": "hub-night",
          "surface": "hub-night-surface",
          "surface-elevated": "hub-ink-secondary",
          "text-primary": "hub-canvas",
          "text-secondary": "hub-surface-elevated",
          "text-tertiary": "hub-ink-tertiary",
          "primary": "hug-yellow",
          "primary-hover": "hug-yellow-deep",
          "accent": "hug-orange",
          "accent-hover": "hug-orange-deep",
          "success": "hub-success",
          "warning": "hug-orange",
          "error": "hub-error",
          "border": "hub-night-border"
        }
      }
    }
  },
  "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": "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": "hug-yellow",
      "on-identity": "hub-ink",
      "primary": "hug-yellow",
      "primary-hover": "hug-yellow-deep",
      "accent": "hug-orange",
      "accent-hover": "hug-orange-deep",
      "mark": "hug-yellow",
      "success": "hub-success",
      "warning": "hug-orange",
      "error": "hub-error",
      "text-primary-light": "hub-ink",
      "text-primary-dark": "hub-canvas",
      "background-light": "hub-canvas",
      "background-dark": "hub-night",
      "surface-light": "hub-surface",
      "surface-dark": "hub-night-surface",
      "text-secondary-light": "hub-ink-secondary",
      "text-tertiary-light": "hub-ink-tertiary",
      "border-light": "hub-border"
    },
    "typography": {
      "display": "heading",
      "prose": "body",
      "code": "mono"
    }
  },
  "assets": [],
  "rules": [
    {
      "type": "colorChoice",
      "target": "roles.colors.mark",
      "severity": "error",
      "rationale": "The hug-mark renders in its signature Hug Yellow (#FFD21E), in monochrome ink on light surfaces, or in monochrome canvas on dark surfaces — per the four logo variants published at huggingface.co/brand (HF Logo, HF Logo with Title, HF Logo Monochrome, HF Logo Pirate). The secondary orange is a supporting accent, not a mark fill.\n",
      "allowed": [
        "hug-yellow",
        "hub-ink",
        "hub-canvas"
      ],
      "forbidden": [
        "hug-orange",
        "hub-success",
        "hub-error",
        "hub-night"
      ]
    },
    {
      "type": "colorChoice",
      "target": "roles.colors.primary",
      "severity": "error",
      "rationale": "Hugging Face's published brand page names Hug Yellow as the primary and Hug Orange as the secondary. Swapping them inverts the brand hierarchy — the yellow is the identity, the orange supports it.\n",
      "allowed": [
        "hug-yellow",
        "hug-yellow-deep"
      ],
      "forbidden": [
        "hug-orange",
        "hub-ink",
        "hub-canvas"
      ]
    },
    {
      "type": "forbiddenTreatment",
      "target": "logo",
      "severity": "error",
      "rationale": "Hugging Face publishes specific monochrome and pirate logo variants; consumers must use those variants rather than apply effects to the full-color mark. Stretching, rotating, or drop-shadowing the hug breaks the warm, hand-drawn voice.\n",
      "treatments": [
        "stretched",
        "rotated",
        "recolored",
        "drop-shadow",
        "gradient-fill",
        "on-busy-photo"
      ]
    },
    {
      "type": "contrastRatio",
      "target": "text-primary",
      "severity": "error",
      "rationale": "Hub Ink (#111827) on Hub Canvas (#FFFFFF) reads at ~17:1 — well above WCAG AA. Long-form model cards and dataset docs depend on holding that floor.\n",
      "against": "background",
      "minRatio": 4.5,
      "standard": "WCAG-AA"
    },
    {
      "type": "contextRestriction",
      "target": "roles.colors.primary",
      "severity": "warning",
      "rationale": "Hug Yellow (#FFD21E) on white reads at ~1.6:1 contrast — far below the AA 4.5:1 floor for body text. The yellow is for brand-mark surfaces and large emphasis blocks, never for small text or thin iconography on a light canvas.\n",
      "forbiddenContexts": [
        "body-text",
        "small-icon-on-light"
      ]
    },
    {
      "type": "enumMembership",
      "target": "typography.heading.fontWeight",
      "severity": "warning",
      "rationale": "The live huggingface.co surface renders display headings at 400 / 600 / 700 on Source Sans Pro. The substitute Source Sans 3 family carries the same weight band; intermediate weights are not part of the published display set.\n",
      "allowed": [
        "400",
        "600",
        "700"
      ]
    },
    {
      "type": "compositionConstraint",
      "target": "roles.colors.primary",
      "severity": "recommendation",
      "rationale": "Hug Yellow reads cleanest against deep ink, bright canvas, or alongside its warm secondary orange. Adjacent saturated reds or greens fight the warm-on-bright voice and read as product-state semantics rather than brand identity.\n",
      "pairsWith": [
        "hub-ink",
        "hub-canvas",
        "hug-orange"
      ],
      "doesNotPairWith": [
        "hub-error",
        "hub-success"
      ]
    },
    {
      "type": "accessibilityRequirement",
      "target": "*",
      "severity": "error",
      "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Hugging Face's Hub canvas pairs deep slate ink with bright surfaces, comfortably clearing AA; consumers must hold this floor across the adapted palette.\n",
      "standard": "WCAG-AA",
      "criterion": "1.4.3"
    }
  ]
}