Make your AI a shadcn expert

The Wall Street Journal Design System

WSJ.com as a DESIGN.md file.

About The Wall Street Journal DESIGN.md

Curated by Dov AzencotUpdated Source wsj.com

  • News & Publishing

The Wall Street Journal's homepage reads less like a website and more like a broadsheet that learned to scroll. The canvas is a warm cream-paper white ("#fcfbf7") rather than pure browser white, the ink is a near-black ("#1a1a1a") that softens slightly against the cream, and the entire chrome is paced by Hoefler & Co.'s Escrow Condensed for decks and Exchange for body. WSJ Red — "#bf242a" — never paints a button or a fill; it appears only as a 1px rule above each story, as the UPPERCASE rubric color marking "U.S. ECONOMY" or "MARKETS", and as the Hot/Live indicator dot. The primary CTA is a square-cornered black pill labelled "Subscribe" — a refusal of the rounded-button convention every other consumer publisher in 2026 follows.

This DESIGN.md file packages the homepage into a structured spec. Inside: 22 color tokens organised around a cream-and-ink neutral scale (canvas "#fcfbf7", ink "#1a1a1a", three graded grays for byline and timestamp work, hairline "#e2e0d9" for the structural rule), WSJ Red "#bf242a" as a print-derived label and rule color, chromatic market semantics (markets-down "#d0021b", markets-up "#1c8c40", link blue "#005a9c"), and a paper-edge stack of cream tints; 11 typography tokens covering Escrow Condensed 30–48px decks, Exchange 16px body, Retina Narrow 10–12px UPPERCASE rubrics, and a 14px timestamp tier; a 6-step radius scale dominated by "0px" square corners; a 9-step spacing scale built on 4/8/12px units; and 18 component specifications. The format follows the Google Labs DESIGN.md specification.

Feed the file to Claude, Cursor, or GitHub Copilot and the agent reproduces WSJ's broadsheet-on-a-screen voice — cream canvas, ink near-black, Escrow Condensed for decks above Exchange body, Retina Narrow UPPERCASE rubrics, WSJ Red as a hairline rule rather than a button fill, square-corner Subscribe CTA, and chromatic market semantics. Reference the tokens directly to paste hex values into Tailwind config, or use the spec as an audit checklist against any financial-news surface that needs to feel like a wire service rather than a SaaS landing. Where most consumer publishers commit the first viewport to a 64–107px display shout, WSJ holds the lead story at "30–48px" Escrow Condensed and lets a single red 1px rule do the work that other publishers ask a colored hero band to do — that restraint is the design.

What makes it distinct

  1. Cream-paper canvas#fcfbf7 instead of pure white, the off-white tint that signals broadsheet rather than browser chrome
  2. WSJ Red as a hairline rule#bf242a paints UPPERCASE section labels and the 1px rule above each story, never a button fill
  3. Escrow Condensed for decks, Exchange for bodytwo Hoefler & Co. families carry the entire editorial hierarchy with no third display face
  4. Square-corner Subscribe pillthe primary CTA sits at 0px radius on a black fill, refusing the rounded-button convention
  5. Retina Narrow UPPERCASE rubrics10–12px weight 600 with 0.5–1.2px positive tracking, the print-inherited kicker that marks every section

Live at wsj.com

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

Screenshot of The Wall Street Journal's website at wsj.comwsj.com

Explore The Wall Street Journal

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.

Semantic

Status, errors, success, inline links.

Other

Specialty colors.

The Wall Street Journal design system FAQ

Common questions about The Wall Street Journal'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 The Wall Street Journal in your project

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

Download DESIGN.md