Skip to content

Cursor Design System

Cursor's design system as a DESIGN.md file. Cream canvas #f7f7f4, Cursor Orange #f54e00, CursorGothic, JetBrains Mono, 25 components. For React, Next.js, and AI tools.

Add shadcn.io to your AI agent. · Pro It installs blocks, icons and templates in your design system from a prompt, with Pro.

Set up MCP
Primary
#f54e00
Typeface
CursorGothic
Shape
Mixed
Base radius
8px
Colors
22
Type tokens
14
Components
25
Spacing values
9

About

About Cursor DESIGN.md

Curated by Dov Azencot · Updated May 12, 2026 · Source cursor.com (opens in a new tab)

Cursor is the AI-first code editor that decided its marketing site should not look like a code editor. The base canvas is warm cream (#f7f7f4) rather than the obligatory dark-IDE black, and the body ink (#26251e) is a warm near-black rather than pure #000. The brand voltage is one color — Cursor Orange (#f54e00) — used scarcely on primary CTAs and the wordmark. The signature visual moment is the AI-action timeline: five pastel pills (peach, mint, blue, lavender, gold) marking agent stages inside the editor mockups. Display runs at weight 400 with -2.16px letter-spacing on the 72px hero, a quietly-confident magazine voice rather than the heavy SaaS bombast.

This page packages that system into a single DESIGN.md file following the Google Labs spec. Inside: 22 colors tokens (brand, surface, hairline, text, the five timeline pastels, and semantics), 15 typography styles with CursorGothic as the single family plus JetBrains Mono on every code surface, 8 corner-radius tokens topping out at the 8px CTA standard, a 9-step spacing scale anchored at the 80px section rhythm, and 25 components from the hero band through the IDE mockup, feature cards, timeline pills, pricing tiers, and the cream footer.

Hand the file to Claude, Cursor, or Copilot and the agent reproduces the brand's restraint — cream canvas, warm ink, single-voltage orange, weight-400 display — rather than defaulting to a generic dark-IDE theme. Or reference the tokens directly: every hex, font, radius, and spacing value is quoted YAML you can paste into Tailwind config, CSS variables, or a shadcn theme. The system is worth studying because it does the hardest thing in dev-tools branding: it stays calm.

What makes it distinct

5

  1. Editorial cream canvas (#f7f7f4)not the dark IDE atmosphere every other AI code editor defaults to
  2. Display weight stays at 400magazine voice with -2.16px tracking on the 72px hero, never bold
  3. Single accent voltageCursor Orange (#f54e00) reserved for CTAs and the wordmark, used scarcely
  4. Five-pastel AI timeline palettepeach, mint, blue, lavender, gold scoped strictly to in-product agent stages
  5. Hairline-only depthno drop shadows anywhere; cards float on 1px borders and white-on-cream contrast

cursor.com

Live at cursor.com

A snapshot of the brand in production. Scroll the frame to see the whole page.

Cursor's website at cursor.com

Colors

22 colors

Cursor's system runs on #f54e00 as its primary voltage, used in 1 of 25 components. Type is set in CursorGothic across 14 tokens from 11px to 72px, weights 400–600. Shape language is mixed across 25 components, blending pills, soft rounds, and squarer corners.

Brand & Accent

Sparing, CTA-only voltage · 2

Surface

Page and card backgrounds · 4

Text

Headlines, body, captions · 7

Borders & Hairlines

Dividers, outlines, rules · 3

Semantic

Status, errors, success, links · 2

Other

Specialty colors · 4

Typography

14 type tokens

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

  • display-mega72px · weight 400 · lh 1.1 · tracking -2.16pxThe quick brown fox jumps over the lazy dog
  • display-lg36px · weight 400 · lh 1.2 · tracking -0.72pxThe quick brown fox jumps over the lazy dog
  • display-md26px · weight 400 · lh 1.25 · tracking -0.325pxThe quick brown fox jumps over the lazy dog
  • display-sm22px · weight 400 · lh 1.3 · tracking -0.11pxThe quick brown fox jumps over the lazy dog
  • title-md18px · weight 600 · lh 1.4The quick brown fox jumps over the lazy dog
  • title-sm16px · weight 600 · lh 1.4The quick brown fox jumps over the lazy dog
  • body-md16px · weight 400 · lh 1.5The quick brown fox jumps over the lazy dog
  • body-tracked16px · weight 400 · lh 1.5 · tracking 0.08pxThe quick brown fox jumps over the lazy dog
  • body-sm14px · weight 400 · 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-uppercase11px · weight 600 · lh 1.4 · tracking 0.88pxThe quick brown fox jumps over the lazy dog
  • code13px · weight 400 · lh 1.5The quick brown fox jumps over the lazy dog
  • button14px · weight 500 · lh 1The quick brown fox jumps over the lazy dog
  • nav-link14px · weight 500 · lh 1.4The quick brown fox jumps over the lazy dog

Layout

Radii and spacing

8 corner radii and 9 spacing values. Shape language: mixed.

Radii

  • none0px
  • xs4px
  • sm6px
  • md8px
  • lg12px
  • xl16px
  • pill9999px
  • full9999px

Spacing

  • xxs4px
  • xs8px
  • sm12px
  • base16px
  • md20px
  • lg24px
  • xl32px
  • xxl48px
  • section80px

Components

25 components

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

  • Top Nav
    top-navTop Nav
  • Button Primary
    button-primaryButton Primary
  • Button Primary Active
    button-primary-activeButton Primary Active
  • Button Secondary
    button-secondaryButton Secondary
  • Button Tertiary Text
    button-tertiary-textButton Tertiary Text
  • Button Download
    button-downloadButton Download
  • Hero Band
    hero-bandHero Band
  • Ide Mockup Card
    ide-mockup-cardIde Mockup Card
  • Ide Pane
    ide-paneIde Pane
  • Feature Card
    feature-cardFeature Card
  • Comparison Card
    comparison-cardComparison Card
  • Timeline Pill Thinking
    timeline-pill-thinkingTimeline Pill Thinking
  • Timeline Pill Grep
    timeline-pill-grepTimeline Pill Grep
  • Timeline Pill Read
    timeline-pill-readTimeline Pill Read
  • Timeline Pill Edit
    timeline-pill-editTimeline Pill Edit
  • Timeline Pill Done
    timeline-pill-doneTimeline Pill Done
  • Code Block
    code-blockCode Block
  • Pricing Tier Card
    pricing-tier-cardPricing Tier Card
  • Pricing Tier Featured
    pricing-tier-featuredPricing Tier Featured
  • Type here…
    text-inputText Input
  • Badge Pill
    badge-pillBadge Pill
  • Cta Band
    cta-bandCta Band
  • Testimonial Card
    testimonial-cardTestimonial Card
  • Footer
    footerFooter
  • Footer Link
    footer-linkFooter Link

In use

The system, in use

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

Build something people actually use.

A short paragraph of marketing copy that previews how the brand's display tier and body tier read together. Two sentences is usually enough.

Get startedLearn more
Marketing heroHeadline, sub-copy, primary CTA — the universal homepage opener.

FAQ

Cursor design system FAQ

Common questions about Cursor's tokens, components, and how to use this DESIGN.md in your project.

Read next

Specs, directories, and component libraries that pair with this design system.

Use it

Use Cursor in your project

One machine-readable file. Drop it into Claude, Cursor, 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 Cursor.

  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 Cursor'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

Cursor's marketing site reads as a quietly-confident developer brand that believes in editorial calm over IDE-darkness. The base canvas is warm cream ({colors.canvas} — #f7f7f4) holding warm near-black ink ({colors.ink} — #26251e) for body and display alike. The single brand voltage is Cursor Orange ({colors.primary} — #f54e00) reserved for primary CTAs and the wordmark — used scarcely.

Type runs CursorGothic as the single sans family. Display sits at weight 400 with negative letter-spacing — a magazine-editorial voice rather than tech-bombastic. JetBrains Mono carries every code surface (and code surfaces are roughly half the page).

The brand's strongest visual signature is the AI-timeline pill palette: five pastel pills (peach {colors.timeline-thinking}, mint {colors.timeline-grep}, blue {colors.timeline-read}, lavender {colors.timeline-edit}, gold {colors.timeline-done}) marking AI-action stages inside in-product timeline visualizations. Used only in product UI — never as system action colors.

Key Characteristics:

  • Warm cream canvas, not white. Ink is warm (#26251e), not pure black.
  • Single CTA color: {colors.primary} (Cursor Orange #f54e00). Used scarcely.
  • Display weight stays at 400 — never bold. Magazine voice.
  • AI timeline pastels: 5 dedicated tokens for in-product agent action stages.
  • Compact 8px CTA radius — developer dialect.
  • Hairline-only depth; no drop shadows.
  • 80px section rhythm.

Known Gaps

  • CursorGothic is a licensed typeface; Inter is the substitute.
  • Animation timings (timeline pill entrance, IDE pane reveal) out of scope.
  • In-app surfaces (code editor, chat panel, agent timeline) only partially captured via marketing IDE mockups.
  • Form validation states beyond focus not visible on captured surfaces.

Developer Tools & IDEs

More systems like this

More DESIGN.md files in Developer Tools & IDEs.

Pricing

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.

Billed once a year in USD. Cancel anytime.

Individual

For personal projects & open source

$32instead of $49/mo

$389 billed yearly

  • How many people can use the license.Seats: 1 seat
  • Client work, SaaS products and anything you charge for.Commercial use: Personal & open source only
  • Production-ready React sections: hero, pricing, features, dashboards and more.Pro blocks: 6,000+ blocks
  • Complete multi-page sites you can ship as they are.Templates: All 14 templates
  • React icons from every major library, installable with one command.React icons: 294k+ icons
  • Presets that restyle every block, in light and dark.Themes: All 59 themes
  • Lets your AI editor search, preview and install blocks for you.MCP server: Basic usage
  • Priority requests are answered first.Support: Standard

Team

Most popular

For freelancers, agencies & startups

$66instead of $99/mo

$789 billed yearly · ≈ $13/dev/mo

Everything in Individual, plus

  • How many people can use the license.Seats: Up to 5 seats
  • Client work, SaaS products and anything you charge for.Commercial use: Included
  • Lets your AI editor search, preview and install blocks for you.MCP server: High usage
  • Priority requests are answered first.Support: Priority

Organization

For companies with larger teams

$132instead of $199/mo

$1,589 billed yearly

Everything in Team, plus

  • How many people can use the license.Seats: Unlimited seats
  • Lets your AI editor search, preview and install blocks for you.MCP server: Unlimited usage
  • Secure checkout via Stripe
  • Code lives in your repo
  • Keep what you've shipped if you cancel
  • License terms

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