About NPR DESIGN.md
Curated by Dov AzencotUpdated Source npr.org
- News & Publishing
NPR's homepage looks like nothing else in US news media — and the trick is what it leaves out. There is no red, no second saturated color, no atmospheric gradient. The page sets every word in NPRSans (a Gotham-derivative sans), prints headlines in charcoal #333333 rather than pure black, and reserves exactly one chromatic voltage — cobalt blue #0a61db — for link text and the audio-play pill buttons. Where CNN saturates its masthead in brand red, where The Guardian leans on a deep indigo masthead bar, and where The New York Times mixes serif headlines with red breaking-news flags, NPR runs the full editorial system in one typeface and one accent color and lets photography do every other chromatic job.
The DESIGN.md file packages the system into a machine-readable spec for React tooling. Inside: 9 color tokens drawn from a 110-variable gray / blue palette that NPR exposes as `--gray-100` through `--gray-900` and `--blue-100` through `--blue-900`. The rendered chrome uses 7 of them — `{colors.ink}` charcoal, `{colors.ink-soft}` near-black, `{colors.canvas}` white, `{colors.muted}` mid-gray, `{colors.muted-2}` dark gray, `{colors.hairline}` light gray, and `{colors.primary}` cobalt blue. 16 typography tokens cover NPRSans at four weights and four scale steps, plus NPRSerif at the body-dek tier. 4 radius tokens centered on 2px for cards and 60px for the audio-play pills. 18 components covering the headline-into-dek story tile, the cobalt audio-play pill, the uppercase section eyebrow, the secondary metadata strip, the photograph-led media card, and the top-nav with its cobalt link treatment.
Feed this file to an AI coding tool and it reproduces NPR's specific moves: NPRSans across every tier with NPRSerif reserved for body deks, charcoal-not-black ink, single cobalt link voltage with no second brand color, uppercase 14px / 500 eyebrows with 0.84px tracking, and 60px pill audio CTAs. The token references resolve cleanly. The one move worth borrowing if your product is news-or-podcast-shaped: the photography-led story-tile rhythm with a 1px hairline between rows. The one move to leave alone unless your brand actually owns a single accent color: the chromatic restraint — most products need at least a secondary semantic palette for status and category cues.
What makes it distinct
- Charcoal-not-black inkevery story headline and body line renders in #333333, never pure black; the contrast against white softens the broadcaster utility tone
- Single cobalt link voltage#0a61db is the only saturated color above the fold, carrying both link text and the audio-play pill buttons
- NPRSans as workhorse, NPRSerif as accentthe Gotham-derivative sans runs every headline, label, and chrome string; the serif appears only in body deks
- Uppercase eyebrow labels at 0.84px trackingsection names like Law, Politics, and Culture sit as 14px / 500 caps above each story tile
- 60px pill audio buttonsthe listen-and-duration CTAs use full pill rounding with the duration timestamp baked into the label
Live at npr.org
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
npr.orgExplore NPR
Pick what you want to see — mockups, colors, typography, layout, or the full component list.
Brand & Accent
Sparing, CTA-only voltage.
Surface
Page and card backgrounds.
Text
Headlines, body, captions, muted.
Borders & Hairlines
Dividers, outlines, structural rules.
NPR design system FAQ
Common questions about NPR's tokens, components, and how to use this DESIGN.md in your project.
Related reading
Specs, directories, and component libraries that pair with this design system.
Browse all design systems
The full directory of DESIGN.md files on shadcn.io, with live mockups for each.
NPR — official site
NPR's public marketing site — the source of truth for the live tokens captured in this file.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files — the format this page is built on.