Skip to content

Notion Design System

Notion's purple #5645d4 CTA, navy #0a1530 hero and Notion Sans as a DESIGN.md file, with a large component set for React, Next.js and AI tools.

Primary color
#5645d4
Typeface
Notion Sans
Shape
Mixed
Base radius
8px
Colors
47
Type tokens
17
Components
50
Spacing values
12

About Notion DESIGN.md

Curated by Dov Azencot, updated May 12, 2026. Source notion.com (opens in a new tab).

Notion's design system reads as a workspace, not a marketing site. The homepage opens with "Meet the night shift." centered over a deep navy band ("#0a1530") decorated with brand-colored sticky-note dots and mesh wire illustrations — atmosphere rather than chrome. The dominant action is a single purple pill button at "#5645d4", and a real "Ramp HQ" kanban mockup floats below the buttons with a 24px diffuse drop shadow. The voice is confident and illustration-rich without leaning maximalist.

This DESIGN.md packages the whole spec into one machine-readable file. Inside: 47 colors tokens grouped into brand purples, a 10-color brand spectrum, 9 pastel card tints, surface, hairline, text, and semantic scales; 17 typography tokens running Notion Sans (Inter-based) from 80px hero-display down to 11px micro-uppercase; 8 corner radii from 4px chips to 24px feature cards; 12 spacing tokens up to 120px hero gutters; and 50+ components covering buttons, pastel feature cards (peach, rose, mint, lavender, sky, yellow, cream), inputs, pill and segmented tabs, badges, the 4-tier pricing comparison, the embedded workspace mockup, FAQ accordions, and the multi-column footer. Format follows the Google Labs DESIGN.md spec.

A working React developer feeds this file to Claude, Cursor, or Copilot and gets components that match Notion's discipline — rectangular 8px buttons, 12px-rounded cards, purple reserved for one CTA per page, navy bands paired with sticky-note decoration — instead of a generic shadcn theme. Reference the tokens directly inside Tailwind config, CSS variables, or your own component library. The system is worth studying for one reason: it proves that "all-in-one workspace" branding can be illustration-rich and colorful without resorting to gradient bling or pill-button-everywhere uniformity.

What makes it distinct

5 highlights

  1. Signature purple voltage#5645d4 reserved for the dominant 'Get Notion free' CTA, never decorative
  2. Deep navy #0a1530 hero band with scattered sticky-note dots and mesh wire illustrations
  3. Nine pastel card tintsPeach, rose, mint, lavender, sky, yellow, cream, gray, plus bold yellow #f9e79f
  4. Rectangular 8px buttons, not pillsSober-editorial geometry distinguishes it from Stripe and Linear
  5. Live workspace mockup card embedded in the hero with a 24px diffuse drop shadow

Live at notion.com

Notion in production, as captured. Scroll the window to see the whole page.

Notion's website at notion.com

47 colors

Notion's system runs on #5645d4 as its primary voltage, used in 3 of 50 components. Type is set in Notion Sans across 17 tokens from 11px to 80px, weights 400–600. Shape language is mixed across 50 components, blending pills, soft rounds, and squarer corners.

Brand & Accent

Sparing, CTA-only voltage · 17

Surface

Page and card backgrounds · 3

Text

Headlines, body, captions · 8

Borders & Hairlines

Dividers, outlines, rules · 3

Semantic

Status, errors, success, links · 3

Other

Specialty colors · 13

17 type tokens

Set in Notion Sans across 17 tokens, from 11px to 80px, weights 400–600. Shown in its own stack: where the font isn't installed, the fallback the file names stands in.

  • hero-display80px · weight 600 · lh 1.05 · tracking -2pxThe quick brown fox jumps over the lazy dog
  • display-lg56px · weight 600 · lh 1.1 · tracking -1pxThe quick brown fox jumps over the lazy dog
  • heading-148px · weight 600 · lh 1.15 · tracking -0.5pxThe quick brown fox jumps over the lazy dog
  • heading-236px · weight 600 · lh 1.2 · tracking -0.5pxThe quick brown fox jumps over the lazy dog
  • heading-328px · weight 600 · lh 1.25The quick brown fox jumps over the lazy dog
  • heading-422px · weight 600 · lh 1.3The quick brown fox jumps over the lazy dog
  • heading-518px · weight 600 · lh 1.4The quick brown fox jumps over the lazy dog
  • subtitle18px · weight 400 · lh 1.5The quick brown fox jumps over the lazy dog
  • body-md16px · weight 400 · lh 1.55The quick brown fox jumps over the lazy dog
  • body-md-medium16px · weight 500 · lh 1.55The quick brown fox jumps over the lazy dog
  • body-sm14px · weight 400 · lh 1.5The quick brown fox jumps over the lazy dog
  • body-sm-medium14px · weight 500 · lh 1.5The quick brown fox jumps over the lazy dog
  • caption13px · weight 400 · lh 1.4The quick brown fox jumps over the lazy dog
  • caption-bold13px · weight 600 · lh 1.4The quick brown fox jumps over the lazy dog
  • micro12px · weight 500 · lh 1.4The quick brown fox jumps over the lazy dog
  • micro-uppercase11px · weight 600 · lh 1.4 · tracking 1pxThe quick brown fox jumps over the lazy dog
  • button-md14px · weight 500 · lh 1.3The quick brown fox jumps over the lazy dog

Radii and spacing

8 corner radii and 12 spacing values. Shape language: mixed, on a 8px base radius.

Radii8

  • xs4px
  • sm6px
  • md8px
  • lg12px
  • xl16px
  • xxl20px
  • xxxl24px
  • full9999px

Spacing12

  • xxs4px
  • xs8px
  • sm12px
  • md16px
  • lg20px
  • xl24px
  • xxl32px
  • xxxl40px
  • section-sm48px
  • section64px
  • section-lg96px
  • hero120px

50 components

Each rendered from its tokens (color, type, radius, padding) on Notion's own canvas.

  • Button Primary
    Button Primarybutton-primary
  • Button Primary Pressed
    Button Primary Pressedbutton-primary-pressed
  • Button Primary Disabled
    Button Primary Disabledbutton-primary-disabled
  • Button Dark
    Button Darkbutton-dark
  • Button Secondary
    Button Secondarybutton-secondary
  • Button On Dark
    Button On Darkbutton-on-dark
  • Button Secondary On Dark
    Button Secondary On Darkbutton-secondary-on-dark
  • Button Ghost
    Button Ghostbutton-ghost
  • Button Link
    Button Linkbutton-link
  • Card Base
    Card Basecard-base
  • Card Feature
    Card Featurecard-feature
  • Card Feature Yellow Bold
    Card Feature Yellow Boldcard-feature-yellow-bold
  • Card Feature Peach
    Card Feature Peachcard-feature-peach
  • Card Feature Rose
    Card Feature Rosecard-feature-rose
  • Card Feature Mint
    Card Feature Mintcard-feature-mint
  • Card Feature Sky
    Card Feature Skycard-feature-sky
  • Card Feature Lavender
    Card Feature Lavendercard-feature-lavender
  • Card Feature Yellow
    Card Feature Yellowcard-feature-yellow
  • Card Feature Cream
    Card Feature Creamcard-feature-cream
  • Card Agent Tile
    Card Agent Tilecard-agent-tile
  • Card Template
    Card Templatecard-template
  • Card Startup Perk
    Card Startup Perkcard-startup-perk
  • Pricing Card
    Pricing Cardpricing-card
  • Pricing Card Featured
    Pricing Card Featuredpricing-card-featured
  • Type here…
    Text Inputtext-input
  • Type here…
    Text Input Focusedtext-input-focused
  • Search Pill
    Search Pillsearch-pill
  • Pill Tab
    Pill Tabpill-tab
  • Pill Tab Active
    Pill Tab Activepill-tab-active
  • Segmented Tab
    Segmented Tabsegmented-tab
  • Segmented Tab Active
    Segmented Tab Activesegmented-tab-active
  • Badge Purple
    Badge Purplebadge-purple
  • Badge Pink
    Badge Pinkbadge-pink
  • Badge Orange
    Badge Orangebadge-orange
  • Badge Tag Purple
    Badge Tag Purplebadge-tag-purple
  • Badge Tag Orange
    Badge Tag Orangebadge-tag-orange
  • Badge Tag Green
    Badge Tag Greenbadge-tag-green
  • Badge Popular
    Badge Popularbadge-popular
  • Promo Banner
    Promo Bannerpromo-banner
  • Hero Band Dark
    Hero Band Darkhero-band-dark
  • Workspace Mockup Card
    Workspace Mockup Cardworkspace-mockup-card
  • Cta Banner Light
    Cta Banner Lightcta-banner-light
  • Comparison Table
    Comparison Tablecomparison-table
  • Comparison Row
    Comparison Rowcomparison-row
  • Testimonial Card
    Testimonial Cardtestimonial-card
  • Logo Wall Item
    Logo Wall Itemlogo-wall-item
  • Faq Accordion Item
    Faq Accordion Itemfaq-accordion-item
  • Stat Row
    Stat Rowstat-row
  • Footer Region
    Footer Regionfooter-region
  • Footer Link
    Footer Linkfooter-link

The system, in use

Notion's tokens on the kind of product it builds.

Marketing heroThe homepage: its nav, a headline and the main call to action.
Notion
Get started

Plan, build and ship in one place

Bring your team's work together, from the first idea to the final release.

Get startedBook a demo
NotionA
Active users12,489
Projects342
Tasks done8,921
Avg. response1.8h
ActivityLast 30 days

Notion design system FAQ

Notion's tokens, its components and how to use this DESIGN.md in your project.

Use Notion in your project

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

Download DESIGN.md
  1. Download the DESIGN.md

    One machine-readable file: every color, type, radius, spacing, and component token of Notion.

  2. Feed it to your AI tool

    Drop it into Claude, Cursor, or GitHub Copilot. The agent writes React components and Tailwind classes that match Notion's visual language.

  3. Reference the tokens directly

    Or paste the values into your Tailwind config, CSS variables, or component library: every color, size and radius is a quoted, ready-to-copy value.

Read the full DESIGN.md overview, rationale, do’s and don’ts

Overview

Notion presents itself as the all-in-one workspace through a confident, illustration-rich brand voice. The homepage opens with "Meet the night shift." rendered centered over a deep navy hero band ("#0a1530"), decorated with brand-colored sticky-note dots and mesh wire illustrations scattered around the headline. The signature purple pill primary CTA ("#5645d4") "Get Notion free" sits at the visual center, paired with an outlined "Request a demo" secondary. Below the buttons, a real Notion workspace UI mockup card (the "Ramp HQ" kanban board) breaks out of the hero band with a deep diffuse drop shadow.

Below the hero, the page cycles through a distinctive sequence of feature sections: a dense sticky-note "Keep work moving 24/7" panel with red/blue/green/purple/teal status icons; a bold yellow ("#f9e79f") "Ask your on-demand assistants" banner card flanked by orange/rose/mint pastel feature tiles showing assistant UI mockups; and a "Bring all your work together" 3-column grid with brand-colored mockups (sky-blue tutorial card, light Notion calendar, brown/rust testimonial slate). The pricing page renders 4 tiers (Free / Plus / Business / Enterprise) horizontally with one tier featured (purple-bordered) and a dense feature comparison table running below.

The system uses a Notion-Sans typeface (Inter-based) across every UI surface — humanist-geometric character that pairs naturally with the colorful illustrations. Buttons are 8px rectangles, NOT pills — distinguishing Notion's sober rectangular geometry from competitors that use pills universally. Cards use 12px corner rounding consistently.

Key Characteristics:

  • Deep navy hero band ("#0a1530") with scattered sticky-note dots + mesh wire decorative illustrations
  • Signature purple pill ("#5645d4") primary CTA — Notion's recognizable "Get Notion free" button color
  • Real Notion workspace UI mockup card embedded in the hero with deep drop shadow
  • Bold yellow feature banner ("#f9e79f") for high-emphasis content sections
  • Pastel feature card palette (peach, rose, mint, lavender, sky, yellow) echoing the live product database properties
  • Notion-Sans (Inter-based) across every UI surface
  • 8px-rounded buttons (NOT pills), 12px-rounded cards — sober editorial geometry
  • 4-tier pricing comparison with dense feature table
  • Centered hero layout (different from the left-aligned norm of most B2B SaaS)

Known Gaps

  • Specific dark-mode token values not surfaced beyond hero bands
  • Animation/transition timings not extracted; recommend 150–200ms ease
  • Form validation success state not explicitly captured
  • Pastel-tint mapping (which feature uses which tint) is observation-based — the actual brand library may have more entries

More systems like this

Airtable, Amie, Anytype and 50 more in Productivity & SaaS: each brand's colors, type and components in one file your AI agent builds from.

Build it with Pro

The DESIGN.md files are free. Pro adds 6,000+ blocks, premium templates and the MCP server, so your AI editor builds in your system for you.

4.9/5 out of 5 · 150+ reviewsfrom 150+ founders and developers.

  • Secure checkout via Stripe
  • Code lives in your repo
  • Keep what you've shipped if you cancel
  • License terms

4.9 out of 5 from 150+ developers

Your system, built for you

Every block, template and icon, installed by your AI agent in your design system. The DESIGN.md files stay free.

Get Pro