Back to Gallery
Star
Language

DESIGN.md

Design System Inspiration of Warp

1. 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

2. Color Palette & Roles

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

3. Typography Rules

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

Role Font Size Weight Line Height Letter Spacing Notes
Display Hero Matter Regular 80px 400 1.00 -2.4px Maximum compression, hero impact
Section Display Matter Regular 56px 400 1.20 -0.56px Feature section headings
Section Heading Matter Regular 48px 400 1.20 -0.48px to -0.96px Alternate heading weight
Feature Heading Matter Regular 40px 400 1.10 -0.4px Feature block titles
Sub-heading Large Matter Regular 36px 400 1.15 -0.72px Sub-section headers
Card Display Matter SQ Regular 42px 400 1.00 0px Squared variant for special display
Sub-heading Matter Regular 32px 400 1.19 0px Content sub-headings
Body Heading Matter Regular 24px 400 1.20 -0.72px to 0px Bold content intros
Card Title Matter Medium 22px 500 1.14 0px Emphasized card headers
Body Large Matter Regular 20px 400 1.40 -0.2px Primary body text, relaxed
Body Matter Regular 18px 400 1.30 -0.18px Standard body paragraphs
Nav/UI Matter Regular 16px 400 1.20 0px Navigation links, UI text
Button Text Matter Medium 16px 500 1.20 0px Button labels
Caption Matter Regular 14px 400 1.00 1.4px Uppercase labels (transform: uppercase)
Small Label Matter Regular 12px 400 1.35 2.4px Uppercase micro-labels (transform: uppercase)
Micro Matter Regular 11px 400 1.20 0px Smallest text elements
Code UI Geist Mono 16px 400 1.00 0px Terminal/code display
Code Body Matter Mono Regular 16px 400 1.00 -0.2px Code content
UI Supplement Inter 16px 500 1.00 -0.2px Specific UI elements

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

4. Component Stylings

Buttons

  • Dark Pill: #353534 background, Ash Gray (#afaeac) text, pill shape (50px radius), 10px padding. The primary CTA — warm, muted, understated
  • Frosted Tag: rgba(255, 255, 255, 0.16) background, black text (rgb(0, 0, 0)), rectangular (6px radius), 1px 6px padding. Small inline tag-like buttons
  • Ghost: No visible background, text-only with underline decoration on hover
  • Hover: Subtle opacity or brightness shift — no dramatic color changes

Cards & Containers

  • Photography Cards: Full-bleed nature imagery with overlay text, 8px–12px border-radius
  • Terminal Screenshot Cards: Product UI embedded in dark containers with rounded corners (8px–12px)
  • Bordered Cards: Semi-transparent border (rgba(226, 226, 226, 0.35)) for containment, 12px–14px radius
  • Hover: Minimal — content cards don't dramatically change on hover, maintaining the calm aesthetic

Inputs & Forms

  • Minimal form presence on the marketing site
  • Dark background inputs with warm gray text
  • Focus: Border brightness increase, no colored rings (consistent with the monochromatic palette)

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

5. Layout Principles

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

6. Depth & Elevation

Level Treatment Use
Level 0 (Flat) No shadow, dark background Page canvas, most surfaces
Level 1 (Veil) rgba(255, 255, 255, 0.04) overlay Subtle surface differentiation
Level 2 (Border) rgba(226, 226, 226, 0.35) 1px border Card containment, section separation
Level 3 (Ambient) rgba(0, 0, 0, 0.2) 0px 5px 15px (inferred from design) Image containers, floating elements

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

7. 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

8. Responsive Behavior

Breakpoints

Name Width Key Changes
Mobile <810px Single column, stacked sections, hero text reduces to ~48px, hamburger nav
Tablet 810px–1500px 2-column features begin, photography scales, nav links partially visible
Desktop >1500px Full cinematic layout, 80px hero display, side-by-side photography + text

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

9. 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