Can I use the Notion DESIGN.md with Cursor, Claude Code, or Codex?

Yes. Copy the DESIGN.md file into your project root and reference it in your agent rules. For Cursor, add it to .cursor/rules. For Claude Code, include it as CLAUDE.md. For Codex, add it to your system prompt. The agent will read it and apply the Notion visual system to any UI it generates.

What is a DESIGN.md file?

A DESIGN.md file is a Markdown document that describes a product's visual design system — color palettes, typography, spacing, and component patterns — in a format that AI coding agents like Cursor, Claude Code, and Codex can read and follow when generating UI.

How do I add the Notion DESIGN.md to my project?

Download or copy the DESIGN.md file from this page and place it in your project root. Then instruct your AI agent: "Read the DESIGN.md file in this project and follow its design system when generating UI." The agent will pick it up automatically in Cursor, Claude Code, Codex, and most modern AI coding tools.

Notion DESIGN.md for AI coding agents

Dima Braven·May 14, 2026

Notion brings docs, wikis, project planning, and team knowledge into one connected AI workspace with flexible pages, databases, search, and automation.

saasproductivityai-workspacedesign-md

CursorClaude CodeCodexGoogle Stitch

# Design Language: The AI workspace that works for you. | Notion

> Extracted from `https://notion.so` on May 28, 2026
> 1656 elements analyzed

This document describes the complete design language of the website. It is structured for AI/LLM consumption — use it to faithfully recreate the visual design in any framework.

## Color Palette

### Primary Colors

| Role | Hex | RGB | HSL | Usage Count |
|------|-----|-----|-----|-------------|
| Primary | `#455dd3` | rgb(69, 93, 211) | hsl(230, 62%, 55%) | 2 |
| Secondary | `#0075de` | rgb(0, 117, 222) | hsl(208, 100%, 44%) | 31 |
| Accent | `#213183` | rgb(33, 49, 131) | hsl(230, 60%, 32%) | 1 |

### Neutral Colors

| Hex | HSL | Usage Count |
|-----|-----|-------------|
| `#000000` | hsl(0, 0%, 0%) | 2259 |
| `#f6f5f4` | hsl(30, 10%, 96%) | 388 |
| `#a39e98` | hsl(33, 6%, 62%) | 202 |
| `#ffffff` | hsl(0, 0%, 100%) | 172 |
| `#615d59` | hsl(30, 4%, 36%) | 48 |
| `#78736f` | hsl(27, 4%, 45%) | 14 |
| `#191918` | hsl(60, 2%, 10%) | 2 |
| `#c0c0c0` | hsl(0, 0%, 75%) | 1 |
| `#dddddd` | hsl(0, 0%, 87%) | 1 |

### Background Colors

Used on large-area elements: `#ffffff`, `#191918`, `#f6f5f4`, `#02093a`, `#ffc95e`, `#f77463`, `#62aef0`, `#2a9d99`, `#b18164`, `#f9f9f8`, `#f7f7f5`

For makers

Get your product in context

Add your tool/site or create the DESIGN.md first. Every listing is reviewed before publication.

Add your tool/site · $19 Create my DESIGN.md

See full pricing

Design System Overview

Notion brings docs, wikis, project planning, and team knowledge into one connected AI workspace with flexible pages, databases, search, and automation.

Notion’s current marketing site balances a broad product story with unusually calm hierarchy. Oversized editorial headlines establish the message, warm neutral surfaces keep dense product information approachable, and screenshots provide proof without competing with the narrative.

Editorial hierarchy

Large, tightly spaced headlines lead each section while compact supporting copy keeps complex workflows easy to scan.

Warm neutral foundation

Off-white surfaces, near-black text, and restrained blue accents create a softer alternative to generic enterprise SaaS styling.

Product proof in context

Illustration, interface screenshots, and use-case sections work together so the product feels capable without becoming visually dense.

What to study

How the navigation groups AI, product, solutions, resources, and enterprise paths.
How headline scale and whitespace simplify a product with many overlapping use cases.
How playful illustration is balanced with real interface screenshots and practical calls to action.

Browse more design and creative tools design systems or explore the full DESIGN.md directory.

Color System

Brand palette extracted from the design system. Click any swatch to copy the hex value.

Text / Primary

#455dd3

Accent

#0075de

Surface / Background

#213183

Border / Subtle

#000000

Color Tokens

Typography Specimen

NotionInter

Display

2.8rem / 700 / 1.04

The quick brown fox

Heading H1

2rem / 700 / 1.1

The quick brown fox jumps

Heading H2

1.5rem / 600 / 1.15

The quick brown fox jumps over

Heading H3

1.125rem / 600 / 1.2

The quick brown fox jumps over the lazy

Body

1rem / 400 / 1.5

The quick brown fox jumps over the lazy dog

Small / Caption

0.75rem / 400 / 1.5

The quick brown fox jumps over the lazy dog and sat down.

Monospace

const primary = "System";

Layout & Spacing Tokens

Spacing Scale

space-14px

space-28px

space-312px

space-416px

space-624px

space-832px

space-1248px

space-1664px

Border Radius

radius-none0px

radius-sm4px

radius-md8px

radius-lg16px

radius-xl24px

radius-full9999px

Elevation & Shadow

Flatshadow-none

XSshadow-xs

SMshadow-sm

MDshadow-md

LGshadow-lg

XLshadow-xl

Use with AI Coding Agents

Copy one of these prompts into your AI coding agent to apply the Notion design system to your project. The DESIGN.md file in your repo root is the source of truth.

# .cursor/rules (or DESIGN.md)
You are working in a project that uses the Notion design system.

Read the DESIGN.md file in this project root and follow it strictly when generating UI.
Match the brand's exact colors, typography, spacing scale, and border radius.
Do not create generic Tailwind UI — apply the visual language from DESIGN.md.

Key rules:
- Use the defined color palette, not arbitrary hex values
- Apply the correct font family and weight scale
- Follow spacing tokens (4/8/12/16/24/32px scale)
- Match component patterns: buttons, cards, inputs, badges as specified