Make your AI a shadcn expert

NPR Design System

NPR's design system as a DESIGN.md file.

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

  1. Charcoal-not-black inkevery story headline and body line renders in #333333, never pure black; the contrast against white softens the broadcaster utility tone
  2. Single cobalt link voltage#0a61db is the only saturated color above the fold, carrying both link text and the audio-play pill buttons
  3. NPRSans as workhorse, NPRSerif as accentthe Gotham-derivative sans runs every headline, label, and chrome string; the serif appears only in body deks
  4. Uppercase eyebrow labels at 0.84px trackingsection names like Law, Politics, and Culture sit as 14px / 500 caps above each story tile
  5. 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.

Screenshot of NPR's website at npr.orgnpr.org

Explore 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.

Specs, directories, and component libraries that pair with this design system.

Use NPR in your project

One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.

Download DESIGN.md