Make your AI a shadcn expert

BBC Design System

The BBC's newsroom-as-homepage captured as a DESIGN.md file.

About BBC DESIGN.md

Curated by Dov AzencotUpdated Source bbc.com

  • News & Publishing

The BBC's homepage does something almost no other news publisher attempts. The marketing-as-newsroom surface is a content-grid of headline cards, video tiles, and editorial blocks — a 28px Reith Serif h1 anchoring the lead story at the top-left, a 4-column grid of secondary headline cards beneath, a "Wars in Pictures" two-tile spread mid-page, a five-thumbnail "Most Watched" video row, a feature block, and a "Most Read" article column anchoring the right rail. Where most news brands ship a chrome-heavy hero (Bloomberg's terminal green, the New York Times' masthead with section navigation rail, the Guardian's blue editorial banner), BBC strips the chrome to two voices: Reith Serif for every headline and body paragraph, Reith Sans for every label and chrome surface. The page floor is pure white, the ink is true black, and the structural rhythm reads as a print broadsheet rather than as a SaaS marketing page.

The DESIGN.md file packages the system into a machine-readable spec for React and AI tools. Inside: nine color tokens — true black, three near-black ink tiers, three near-white surface tones, an inherited browser link blue, and a single mid-grey hairline divider tone; fifteen typography tokens spanning Reith Serif at four headline sizes and Reith Sans at five chrome sizes (including the distinctive 15px weight-800 0.75-tracked uppercase section label that runs above every content block); one captured radius value (50% circular) used on avatar and icon-button containers; eight spacing values clustered around 8px (the dominant gap value with 127 occurrences), 12px (65 occurrences), and 16-24px outer card padding; and sixteen component definitions covering the lead-story hero card, the secondary headline card, the video tile, the live-news badge, the uppercase section label, the squared register CTA, and the typography-only article body.

Feed this file to Claude or Cursor and the agent reproduces the BBC's specific moves: content-grid as the structural device rather than a chrome hero, two-family Reith Serif and Sans typographic split with the tight negative-tracking signature on every headline, uppercase Reith Sans at weight 800 with 0.75px tracking for every section header, squared cards bordered by 1px hairline dividers with no shadow, and the inherited browser link blue as the only chromatic accent. The token references resolve cleanly — `{colors.ink}` for any black, `{colors.canvas}` for any white, `{typography.serif-h2}` for the lead-story headline, `{typography.label-caps}` for the section header — so the AI never has to invent a value. The one move worth borrowing only if you have a Reith-equivalent commissioned typeface to back it: the discipline of running serif headlines and sans chrome in unusually tight tracking. Most newsrooms need a third family to bridge between display and label work; BBC does it with two.

What makes it distinct

  1. Two-family typographic splitReith Serif carries every headline and body paragraph, Reith Sans carries every label, button, and uppercase section header at tracked 0.75px
  2. Content-grid as systemthe marketing surface is a card grid of news, video, and feature blocks, each squared with a 1px hairline border and no shadow
  3. Display weight 500the 28px serif h1 and 18px serif h2 both sit at medium with negative letter-spacing, not bold; the editorial print-broadsheet treatment
  4. Pink-and-black brand chrome below the visible foldthe BBC color signature lives in section-header labels and live-news badges that the broadsheet content-grid quietly carries
  5. Inherited browser link bluethe only chromatic accent on the captured chrome is #0000ee, retained from default unvisited-link styling rather than a designed brand color

Live at bbc.com

A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.

Screenshot of BBC's website at bbc.combbc.com

Explore BBC

Pick what you want to see — mockups, colors, typography, layout, or the full component list.

Surface

Page and card backgrounds.

Text

Headlines, body, captions, muted.

Borders & Hairlines

Dividers, outlines, structural rules.

BBC design system FAQ

Common questions about BBC'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 BBC in your project

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

Download DESIGN.md