Warp DESIGN.md

Design System Inspiration of Warp

Overview

Visual Theme & Atmosphere

Warp's website feels like sitting at a campfire in a deep forest — warm, dark, and alive with quiet confidence. Unlike the cold, blue-tinted blacks favored by most developer tools, Warp wraps everything in a warm near-black that feels like charred wood or dark earth. The text isn't pure white either — it's Warm Parchment (#faf9f6), a barely-perceptible cream that softens every headline and makes the dark canvas feel inviting rather than austere.

The typography is the secret weapon: Matter, a geometric sans-serif with distinctive character, deployed at Regular weight across virtually all text. The font choice is unusual for a developer tool — Matter has a softness and humanity that signals "this terminal is for everyone, not just greybeards." Combined with tight line-heights and controlled negative letter-spacing on headlines, the effect is refined and approachable simultaneously. Nature photography is woven between terminal screenshots, creating a visual language that says: this tool brings you closer to flow, to calm productivity.

The overall design philosophy is restraint through warmth. Minimal color (almost monochromatic warm grays), minimal ornamentation, and a focus on product showcases set against cinematic dark landscapes. It's a terminal company that markets like a lifestyle brand.

Key Characteristics:

• Warm dark background — not cold black, but earthy near-black with warm gray undertones
• Warm Parchment (#faf9f6) text instead of pure white — subtle cream warmth
• Matter font family (Regular weight) — geometric but approachable, not the typical developer-tool typeface
• Nature photography interleaved with product screenshots — lifestyle meets developer tool
• Almost monochromatic warm gray palette — no bold accent colors
• Uppercase labels with wide letter-spacing (2.4px) for categorization — editorial signaling
• Pill-shaped dark buttons (#353534, 50px radius) — restrained, muted CTAs

Primary tasks

• Run AI commands in blocks instead of a plain terminal
• Share a saved workflow with your team
• Work through a production debugging session in the terminal
• Code with multiple agents in one environment
• Download the terminal to try it for free

Brand Narrative

Warp was founded June 2020 in San Francisco by Zach Lloyd (Founder/CEO) — formerly Principal Engineer at Google and interim CTO at TIME (Warp — Wikipedia, Sequoia Capital — Transforming the Command Line at Warp Speed, Zach Lloyd — LinkedIn). Built natively in Rust for macOS, Windows, and Linux. Show HN: Warp launched 2022 (Hacker News — Show HN: Warp Rust-based terminal). Series B $50M (June 2023) led by Sequoia Capital; total funding ~$73M across seed, A, B per recent reporting (FinSMEs — Warp $50M Series B 2023-06). Now positioned as "The Agentic Development Environment" — the first ADE built for coding with multiple agents (live <title> 2026-05 confirms). Recently open-sourced the Agentic Development Environment (StreetInsider — Warp open-sources ADE with cloud agents, byteiota — 37K stars in days). The brand voice — warm dark canvas, wide letter-spacing uppercase, magazine-style chrome, oklch() color-space tokens — reflects "premium developer tool, not just another terminal." (NOTE: there's a separate Warp YC W23 company — payroll compliance for Y Combinator startups — distinct from this Warp terminal.)

Principles

1. Agentic-first. UI implication: AI agent integration first-class, not bolted on.
2. Warm and calm register. UI implication: never tech-flashy or aggressive.
3. Wide uppercase tracking 1.4-2.4px. UI implication: never tight uppercase.
4. Dark warm canvas. UI implication: not pure black; warm dark.
5. Magazine layout. UI implication: generous section padding, photography-considered.

Personas

Personas are fictional archetypes informed by Warp user segments (Mac-based engineers, terminal power users, AI-pair-programming adopters), not individual people.

Sergey Volkov, 36, Berlin. Senior engineer. Warp replaced iTerm2 for AI commands + blocks.

Sofia Park, 31, Seoul. Backend engineer. Warp Drive for shared workflows with team.

Marcus Webb, 41, San Francisco. Engineering manager. Warp for production debugging sessions.

Colors

Primary

• Warm Parchment (#faf9f6): Primary text color — a barely-cream off-white that softens every surface
• Earth Gray (#353534): Button backgrounds, dark interactive surfaces — warm, not cold
• Deep Void (near-black, page background): The warm dark canvas derived from the body background

Secondary & Accent

• Stone Gray (#868584): Secondary text, muted descriptions — warm mid-gray
• Ash Gray (#afaeac): Body text, button text — the workhorse reading color
• Purple-Tint Gray (#666469): Link text with subtle purple undertone — underlined links in content

Surface & Background

• Frosted Veil (rgba(255, 255, 255, 0.04)): Ultra-subtle white overlay for surface differentiation
• Mist Border (rgba(226, 226, 226, 0.35) / rgba(227, 227, 227, 0.337)): Semi-transparent borders for card containment
• Translucent Parchment (rgba(250, 249, 246, 0.9)): Slightly transparent primary surface, allowing depth

Neutrals & Text

• Warm Parchment (#faf9f6): Headlines, high-emphasis text
• Ash Gray (#afaeac): Body paragraphs, descriptions
• Stone Gray (#868584): Secondary labels, subdued information
• Muted Purple (#666469): Underlined links, tertiary content
• Dark Charcoal (#454545 / #353534): Borders, button backgrounds

Semantic & Accent

• Warp operates as an almost monochromatic system — no bold accent colors
• Interactive states are communicated through opacity changes and underline decorations rather than color shifts
• Any accent color would break the warm, restrained palette

Gradient System

• No explicit gradients on the marketing site
• Depth is created through layered semi-transparent surfaces and photography rather than color gradients

Typography

Font Family

• Display & Body: Matter Regular — geometric sans-serif with soft character. Fallbacks: Matter Regular Placeholder, system sans-serif
• Medium: Matter Medium — weight 500 variant for emphasis. Fallbacks: Matter Medium Placeholder
• Square: Matter SQ Regular — squared variant for select display contexts. Fallbacks: Matter SQ Regular Placeholder
• UI Supplement: Inter — used for specific UI elements. Fallbacks: Inter Placeholder
• Monospace Display: Geist Mono — for code/terminal display headings
• Monospace Body: Matter Mono Regular — custom mono companion. Fallbacks: Matter Mono Regular Placeholder

Hierarchy

Principles

• Regular weight dominance: Nearly all text uses weight 400 (Regular) — even headlines. Matter Medium (500) appears only for emphasis moments like card titles and buttons. This creates a remarkably even, calm typographic texture
• Uppercase as editorial signal: Small labels and categories use uppercase transform with wide letter-spacing (1.4px–2.4px), creating a magazine-editorial categorization system
• Warm legibility: The combination of Matter's geometric softness + warm text colors (#faf9f6) + controlled negative tracking creates text that reads as effortlessly human on dark surfaces
• No bold display: Zero use of bold (700+) weight anywhere — restraint is the philosophy

Layout

Spacing System

• Base unit: 8px
• Scale: 1px, 4px, 5px, 8px, 10px, 12px, 14px, 15px, 16px, 18px, 24px, 26px, 30px, 32px, 36px
• Section padding: 80px–120px vertical between major sections
• Card padding: 16px–32px internal spacing
• Component gaps: 8px–16px between related elements

Grid & Container

• Max width: ~1500px container (breakpoint at 1500px), centered
• Column patterns: Full-width hero, 2-column feature sections with photography, single-column testimonials
• Cinematic layout: Wide containers that let photography breathe

Whitespace Philosophy

• Vast and warm: Generous spacing between sections — the dark background creates a warm void that feels contemplative rather than empty
• Photography as whitespace: Nature images serve as visual breathing room between dense product information
• Editorial pacing: The layout reads like a magazine — each section is a deliberate page-turn moment

Border Radius Scale

• 4px: Small interactive elements — buttons, tags
• 5px–6px: Standard components — links, small containers
• 8px: Images, video containers, standard cards
• 10px: Video elements, medium containers
• 12px: Feature cards, large images
• 14px: Large containers, prominent cards
• 40px: Large rounded sections
• 50px: Pill buttons — primary CTAs
• 200px: Progress bars — full pill shape

Responsive Behavior

Breakpoints

Touch Targets

• Pill buttons: 50px radius with 10px padding — comfortable touch targets
• Nav links: 16px text with surrounding padding for accessibility
• Mobile CTAs: Full-width pills on mobile for easy thumb reach

Collapsing Strategy

• Navigation: Full horizontal nav → simplified mobile navigation
• Hero text: 80px display → 56px → 48px across breakpoints
• Feature sections: Side-by-side photography + text → stacked vertically
• Photography: Scales within containers, maintains cinematic aspect ratios
• Section spacing: Reduces proportionally — generous desktop → compact mobile

Image Behavior

• Nature photography scales responsively, maintaining wide cinematic ratios
• Terminal screenshots maintain aspect ratios within responsive containers
• Video elements scale with 10px radius maintained
• No art direction changes — same compositions across breakpoints

Elevation & Depth

Shadow Philosophy

Warp's elevation system is remarkably flat — almost zero shadow usage on the marketing site. Depth is communicated through:

• Semi-transparent borders instead of shadows — borders at 35% opacity create a ghostly containment
• Photography layering — images create natural depth without artificial shadows
• Surface opacity shifts — rgba(255, 255, 255, 0.04) overlays create barely-perceptible layer differences
• The effect is calm and grounded — nothing floats, everything rests

Decorative Depth

• Photography as depth: Nature images create atmospheric depth that shadows cannot
• No glass or blur effects: The design avoids trendy glassmorphism entirely
• Warm ambient: Any glow comes from the photography's natural lighting, not artificial CSS

Values kept in prose

Measured values the DESIGN.md token grammar cannot carry, kept verbatim:

• shadow.ambient: rgba(0,0,0,0.2) 0px 5px 15px

Motion & Easing

No motion duration or easing token is promoted. The capture bundle for this reference records no transition or animation property, and no official source consulted publishes a motion scale. The behaviour described below was observed; treat any exact duration or curve as a local extension until a component-level official source verifies it.

Standard cubic-bezier; calm easing. prefers-reduced-motion: reduce removes hover transitions.

---

Verified: 2026-05-08 (omd:migrate run 62 — Apple-tier) Tier 1 sources: https://warp.dev home + /pricing (live DOM via playwright — Primary oklch(0.97 0.01 84.6) Warp Cream + oklch(0.14 0.004 84.6) Warp Espresso text 3px / 36px / 4×16 / 14px·500; Outline 4px sub-tier; Billing toggle 9999px + oklab() translucent discipline. oklch() for solid + oklab() for translucent — most advanced color-space convention in corpus, surpassing Sanity's display-p3()). Tier 2 sources: styles.refero.design / getdesign.md — no record. Tier 2 (Philosophy/founders/funding): Wikipedia (Warp terminal), Sequoia Capital, LinkedIn (Lloyd ex-Google/TIME), HN (Show HN: Warp 2022), FinSMEs (2023-06 $50M Series B), Sacra, StreetInsider (OSS ADE), byteiota (37K stars). Style ref: claude (warm magazine register). Conflicts unresolved: none. Earlier addition: oklch()/oklab() color-space convention + 3px sharp Primary canonical (prior footer values appear to be from a different surface state).

Components

Buttons

Dark Pill

• Background: #353534
• Text: #afaeac (Ash Gray)
• Radius: 50px (pill)
• Padding: 10px
• Font: 16px / 400 / Matter
• Hover: subtle opacity/brightness shift
• Use: Primary CTA — warm, muted, understated

Frosted Tag

• Background: rgba(255, 255, 255, 0.16)
• Text: #000000
• Radius: 6px
• Padding: 1px 6px
• Font: 12px / 400 / Matter
• Use: Small inline tag-like button

Ghost

• Background: transparent
• Text: #afaeac
• Radius: 50px
• Padding: 10px
• Hover: underline decoration
• Use: Tertiary text-only action

Inputs

Default

• Background: #1a1a18
• Text: #faf9f6
• Border: 1px solid rgba(226, 226, 226, 0.35)
• Radius: 8px
• Padding: 10px 12px
• Font: 16px / 400 / Matter
• Placeholder: #868584 (Stone Gray)
• Focus: border brightness increase (no colored ring — monochromatic)
• Use: Inferred from §1-§2 baseline (no explicit DS variant in source) — minimal form presence on marketing site.

Cards

Photography Card

• Background: full-bleed nature imagery
• Radius: 8px (or 12px)
• Padding: 0px (image-led)
• Use: Nature photography with overlay text

Terminal Screenshot Card

• Background: #1a1a18
• Radius: 12px
• Padding: 0px (UI fills frame)
• Use: Product terminal UI in dark container

Bordered Card

• Background: #1a1a18
• Text: #faf9f6
• Border: 1px solid rgba(226, 226, 226, 0.35)
• Radius: 12px
• Padding: 24px
• Use: Containment card with semi-transparent border

Badges

Default

• Background: rgba(255, 255, 255, 0.16)
• Text: #000000 (or #faf9f6 on dark)
• Radius: 6px
• Padding: 1px 6px
• Font: 12px / 400 / Matter
• Use: Inferred from §1-§2 baseline (no explicit DS variant in source) — frosted tag re-used as badge.

Navigation

• Top nav: Dark background, warm parchment brand text, Matter Regular at 16px for links
• Link color: Stone Gray (#868584) for muted nav, Warm Parchment for active/hover
• CTA button: Dark pill (#353534) at nav end — restrained, not attention-grabbing
• Mobile: Collapses to simplified navigation
• Sticky: Nav stays fixed on scroll

Image Treatment

• Nature photography: Landscapes, forests, golden-hour scenes — completely unique for a developer tool
• Terminal screenshots: Product UI shown in realistic terminal window frames
• Mixed composition: Nature images and terminal screenshots are interleaved, creating a lifestyle-meets-tool narrative
• Full-bleed: Images often span full container width with 8px radius
• Video: Video elements present with 10px border-radius

Testimonial Section

• Social proof area ("Don't take our word for it") with quotes
• Muted styling consistent with overall restraint

States

Do's and Don'ts

Do

• Use warm off-white (#faf9f6) for text instead of pure white — the cream undertone is essential
• Keep buttons restrained and muted — dark fill (#353534) with muted text (#afaeac), no bright CTAs
• Apply Matter Regular (weight 400) for nearly everything — even headlines. Reserve Medium (500) for emphasis only
• Use uppercase labels with wide letter-spacing (1.4px–2.4px) for categorization
• Interleave nature photography with product screenshots — this is core to the brand identity
• Maintain the almost monochromatic warm gray palette — no bold accent colors
• Use semi-transparent borders (rgba(226, 226, 226, 0.35)) for card containment instead of shadows
• Keep negative letter-spacing on headlines (-0.4px to -2.4px) for Matter's compressed display treatment

Don't

• Use pure white (#ffffff) for text — it's always warm parchment (#faf9f6)
• Add bold accent colors (blue, red, green) — the system is deliberately monochromatic warm grays
• Apply bold weight (700+) to any text — Warp never goes above Medium (500)
• Use heavy drop shadows — depth comes from borders, photography, and opacity shifts
• Create cold or blue-tinted dark backgrounds — the warmth is essential
• Add decorative gradients or glow effects — the photography provides all visual interest
• Use tight, compressed layouts — the editorial spacing is generous and contemplative
• Mix in additional typefaces beyond the Matter family + Inter supplement

Voice & Tone

Warp's voice is agentic-development-warm and terminal-magazine. "The Agentic Development Environment" — terminal that's been redesigned for the AI agent era. Wide letter-spacing uppercase + warm dark canvas signal "well-designed magazine" rather than "tech-aggressive."

Voice samples

• Tagline: "The Agentic Development Environment"

Forbidden phrases. "Revolutionary terminal". Aggressive comparison framing.

Agent Prompt Guide

Quick Color Reference

• Primary Text: Warm Parchment (#faf9f6)
• Secondary Text: Ash Gray (#afaeac)
• Tertiary Text: Stone Gray (#868584)
• Button Background: Earth Gray (#353534)
• Border: Mist Border (rgba(226, 226, 226, 0.35))
• Background: Deep warm near-black (page background)

Example Component Prompts

• "Create a hero section on warm dark background with 80px Matter Regular heading in warm parchment (#faf9f6), line-height 1.0, letter-spacing -2.4px, and a dark pill button (#353534, 50px radius, #afaeac text)"
• "Design a feature card with semi-transparent border (rgba(226,226,226,0.35)), 12px radius, warm dark background, Matter Regular heading at 24px, and ash gray (#afaeac) body text at 18px"
• "Build a category label using Matter Regular at 12px, uppercase transform, letter-spacing 2.4px, stone gray (#868584) color — editorial magazine style"
• "Create a testimonial section with warm parchment quotes in Matter Regular 24px, attributed in stone gray (#868584), on dark background with minimal ornamentation"
• "Design a navigation bar with warm dark background, Matter Regular links at 16px in stone gray (#868584), hover to warm parchment (#faf9f6), and a dark pill CTA button (#353534) at the right"

Iteration Guide

When refining existing screens generated with this design system:

1. Verify text color is warm parchment (#faf9f6) not pure white — the warmth is subtle but essential
2. Ensure all buttons use the restrained dark palette (#353534) — no bright or colorful CTAs
3. Check that Matter Regular (400) is the default weight — Medium (500) only for emphasis
4. Confirm uppercase labels have wide letter-spacing (1.4px–2.4px) — tight uppercase feels wrong here
5. The overall tone should feel warm and calm, like a well-designed magazine — not aggressive or tech-flashy