Make your AI a shadcn expert

Mastercard Design System

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

About Mastercard DESIGN.md

Curated by Dov AzencotUpdated Source mastercard.com

  • Fintech & Crypto
  • Banking & Payments

Mastercard's current visual language reads less like a payments network and more like a premium annual report. The base canvas is a warm putty-cream at #F3F0EE — not white, not gray, but a paper-toned surface that immediately distances the brand from sterile fintech defaults. Primary CTAs are Ink Black pills at #141413 with cream-colored labels rather than pure white, and the only place the brand's famous red and yellow appear is the locked logo mark itself. Service imagery is cropped to perfect circles connected by hand-drawn-feeling orange arcs, with a 56px white satellite CTA docked to each portrait's bottom-right edge like a moon.

This DESIGN.md captures the full system: seven palette groups covering canvas, ink, signal, link, and neutral tones; a MarkForMC type scale with the unusual weight-450 body and -2% tracking on every headline; an 8px spacing grid running from 8 through 128; and component specs for buttons, cards, nav pills, satellite CTAs, hero stadiums, orbital arcs, and the dark warm-black footer at #141413. The file follows the Google Labs DESIGN.md spec so it parses cleanly as YAML tokens alongside the prose.

Feed this file to Claude, Cursor, or Copilot and the agent will build pages that look like Mastercard rather than a generic fintech theme — cream canvas, 40px hero radii, circular portraits, weight-450 paragraphs, Signal Orange held back for consent flows. Reference the tokens directly when wiring Tailwind config or CSS variables. Mastercard is worth studying because it holds a rare tension: a 60-year-old payments network that reads as editorial without softening into lifestyle, achieved almost entirely through one canvas color, one type weight, and one radius commitment.

What makes it distinct

  1. Warm putty canvas (#F3F0EE) instead of whiteevery surface is tinted, never sterile, never jet-black
  2. Three-radius commitment20px buttons, 40px hero stadiums, 999px pills; the 8–12px middle ground is absent
  3. Body type at weight 450softer than 400, firmer than 500, a signature MarkForMC half-step few brands ship
  4. Signal Orange (#CF4500) is consent-onlyused for cookie banners and legal, never for marketing CTAs
  5. Orbital motifLight Signal Orange (#F37338) arcs trace connections between circular portraits with 56px white satellite CTAs

Live at mastercard.com

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

Screenshot of Mastercard's website at mastercard.commastercard.com

Explore Mastercard

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.

Other

Specialty colors.

Mastercard design system FAQ

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

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

Download DESIGN.md