Hugging Face — decoded design system

huggingface.co · light · modern · tailwind · deep decode — measured live

Hugging Face's design system, decoded live by Mozaika: measured color roles, type scale, buttons with real hover/focus states, motion and the brand's own tokens.

Open in Mozaika →

This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/decode/huggingface.co.

Decoded design system

Hugging Face's decoded design system: background #FFFFFF, text #000000, accent #E5E7EB, link #6A7282, primary #101828; type scale h1 48px / h2 30px / body 16px; 8px spacing base; 0px base radius. The single interactive/action color is #E5E7EB — used only on interactive or must-notice elements (buttons, links, key highlights), never on large fills.

Color roles

Using these colors

• Action color #E5E7EB — the single interactive color; only on things you click or must notice, never large fills.
• primary #101828, secondary #141C2E are visually the same color (Δ14) — treat as one role (the action color).
• accent, button_bg are all #E5E7EB — one role, not several (the action color).
• accent #E5E7EB — THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed.
• link #6A7282 — reads as a neutral UI color, not a link accent — verify against the reference (action = #E5E7EB).

Typography

• Heading: Source Sans Pro
• Body: Source Sans Pro
• Mono: IBM Plex Mono
• h1: 48px
• h2: 30px
• body: 16px

Spacing

• base unit: 8px
• scale: 2px, 4px, 6px, 8px, 10px, 12px, 14px, 16px, 24px, 32px

Radii

• base: 0px
• button: 3.35544e+07px

Motion

Micro-interactions run at 150ms (dominant) with cubic-bezier(0.4, 0, 0.2, 1).

• durations: 150ms · 200ms
• easings: cubic-bezier(0.4, 0, 0.2, 1) · ease
• animated properties: transform, translate, scale, rotate

Native design tokens

…and 110 more measured on the page.

Button states (measured)

• primary focus: outline 1px auto rgb(16, 16, 16)

Layout (measured)

• container max-width: 1250px
• nav: 65px
• common grid: 2 columns

Motion choreography (measured)

Load order: svg.w-full → svg.absolute×5

Input (measured)

height 36px · radius 8px · focus ring rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgba(0, 0, 0, 0) 0px 0px 0px 0px, rgb(255, 255, 255) 0px 0px 0px 0px inset, oklch(0.87 0.065 274.039) 0px 0px 0px 1px inset, rgba(0, 0, 0, 0.1) 0px 20px 25px -5px, rgba(0, 0, 0, 0.1) 0px 8px 10px -6px

Themes

dark counterpart: background #0B0F19, text oklch(0.928 0.006 264.531).

Responsive (measured)

• mobile (390px): hero 36px · nav hamburger

Install it

Drop this measured system into any shadcn/Tailwind project in one command:

npx shadcn add mozaika.design/r/decode/huggingface.co

registry item · or query it over MCP: get_design_system("Hugging Face")

Export: DESIGN.md

# Hugging Face — Design System

> light, modern, medium, tailwind — deep decode (measured live)

## Colors

| Role | Value |
|------|-------|
| bg | `#FFFFFF` |
| surface | `#EFEFEF` |
| border | `#D8D8D8` |
| text | `#000000` |
| text_muted | `#606060` |
| primary | `#101828` |
| accent | `#E5E7EB` |
| link | `#6A7282` |
| secondary | `#141C2E` |
| button_bg | `#E5E7EB` |
| button_text | `#FFFFFF` |

**Using these colors**

- **Action color** `#E5E7EB` — the single interactive color; it appears only on things you click or must notice (buttons, key highlights), never on large fills or backgrounds.
- `primary` `#101828`, `secondary` `#141C2E` are visually the same color (Δ14) — treat as one role.
- `accent`, `button_bg` are all `#E5E7EB` — one role, not several (your action color).
- **accent** `#E5E7EB` — THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed.
- **link** `#6A7282` — reads as a neutral UI color, not a link accent — verify against the reference (action = #E5E7EB).
- **Page coverage** (full-page screenshot pixels): `#0C0F19` 55.9% · `#FFFFFF` 39.4% · `#5A5C5F` 4.7%

## Typography

- Heading: **Source Sans Pro** _(free fallback: Newsreader)_
- Body: **Source Sans Pro** _(free fallback: Newsreader)_
- Mono: **IBM Plex Mono** _(measured)_

| Role | Size / weight · line-height · tracking |
|------|------------------------------------------|
| hero | 48px / 700 · lh 48px |
| h2 | 30px / 700 · lh 36px |
| h3 | 24px / 600 · lh 32px |
| body | 16px / 400 · lh 24px |
| small | 15px / 400 · lh 24px |

- Weight ladder: 400 · 600 · 700 — use these exact measured weights, not the 400/600 defaults.

> **Fonts —** Source Sans Pro may be proprietary — safe free fallback: Newsreader (Google Fonts).

## Spacing
- base unit: 8px (inferred from the measured scale)
- measured scale: 2px, 4px, 6px, 8px, 10px, 12px, 14px, 16px, 24px, 32px — snap all gaps/padding to these
- section rhythm: 56px top/bottom padding per section (measured)

## Radius
- base: 0px
- button: 3.35544e+07px
- card: 4px
- pill: 9999px

## Buttons

| Button | Fill / text | Border | Radius | Padding | Font | Shadow |
|--------|-------------|--------|--------|---------|------|--------|
| primary | `oklch(0.21 0.034 264.665)` / `#FFFFFF` | 1px solid rgba(0, 0, 0, 0) | 3.35544e+07px | 4px 12px 4px 12px | 400 16px | none |
| secondary | `rgba(0, 0, 0, 0)` / `#FFFFFF` | 1px solid oklch(0.446 0.03 256.802) | 3.35544e+07px | 0px 21.6px 0px 21.6px | 400 16px | none |

**States (measured, not guessed)**

- primary focus: outline `1px auto rgb(16, 16, 16)`

## Motion
- durations: 150ms (dominant) · 200ms
- easings: `cubic-bezier(0.4, 0, 0.2, 1)` (dominant) · `ease`
- animated properties: transform, translate, scale, rotate

Micro-interactions use the dominant duration + easing; nothing on the page animates slower than the longest duration above — don't invent springier motion.

## Their own tokens (verbatim from :root)

| Token | Value |
|-------|-------|
| `--d2h-ins-label-color` | `#399839` |
| `--color-slate-200` | `oklch(92.9% .013 255.508)` |
| `--color-sky-500` | `oklch(68.5% .169 237.323)` |
| `--color-pink-500` | `oklch(65.6% .241 354.308)` |
| `--color-orange-600` | `oklch(64.6% .222 41.116)` |
| `--color-violet-600` | `oklch(54.1% .281 293.009)` |
| `--color-red-900` | `oklch(39.6% .141 25.723)` |
| `--color-orange-800` | `oklch(47% .157 37.304)` |
| `--color-neutral-600` | `oklch(43.9% 0 0)` |
| `--d2h-dark-change-del-color` | `#d2992233` |
| `--color-teal-400` | `oklch(77.7% .152 181.912)` |
| `--color-pink-950` | `oklch(28.4% .109 3.907)` |

_…and 108 more measured on the page._

Prefer these names when extending their system — it's the brand's actual vocabulary.

## Layout (measured)
- container max 1250px · common grid: 2-col
- nav: 65px · border-bottom 1px solid rgba(0, 0, 0, 0)

| Section (y) | Height | Cols | Gap | Pad y | Split |
|---|---|---|---|---|---|
| 65 | 676 | 2 | 14 | 56/0 | — |
| 741 | 640 | 2 | 8 | 80/0 | — |

## Motion choreography (measured)
Load order: `svg.w-full` @0ms → `svg.absolute`×5 @0ms
- `svg.w-full` — transform translateY(0px) rotate(-30deg)→translateY(0px) rotate(-30deg) — 11000ms ease · loops
- `svg.absolute` ×5 — transform translateY(0px) rotate(16deg)→translateY(0px) rotate(16deg) — 12000ms ease · loops

Rebuild the timeline, not just the durations — order, delays and staggers above are the choreography.

## Components (measured)
- input: h 36px · r 8px · border 1px solid oklch(0.928 0.006 264.531) · bg #FFFFFF · placeholder oklch(0.707 0.022 261.325)
  - focus ring: `` — this exact construction, don't invent your own
- link: oklch(0.551 0.027 264.364) · underline

## Themes (both measured)
- dark counterpart: bg `#0B0F19` · text `oklch(0.928 0.006 264.531)`

## Responsive (measured)
- mobile (390px): hero 36px · body 16px · nav: hamburger

## How to apply
Paste the Tailwind `@theme` (or CSS variables) as your base, then build each
section to its spec — verify every color, radius, and font against these tokens.
Hover/focus states, shadows and motion timings above are measured from the live page — match them exactly, don't re-guess them.

← All decoded design systems

An automated reading of Hugging Face's publicly-visible CSS (colors, fonts, spacing, motion) — not affiliated with huggingface.co. No screenshots stored. Removal requests: hello@mozaika.design.