Skip to content
Article

The Linear Dark UI Blueprint: Precise Design Rules for Claude Code and Cursor

How we engineered micro-border radiance, zinc-950 surfaces, and tabular numbers into enforceable system prompt constraints.

Designing for the Dark-First Era

Linear, Stripe, and Vercel set the gold standard for contemporary developer-tool UI: restrained dark palettes, subtle micro-borders, and surgical typography rhythm.

When developers try to get Claude Code or Cursor to replicate this aesthetic, models frequently confuse dark mode with solid pure black backgrounds and high-contrast white text, resulting in a harsh, unreadable interface.

Here is the exact architectural blueprint behind our Linear Dark UI skill.

1. The 4-Tier Surface Elevation Hierarchy

Never use pure #000000 for your entire canvas. A refined dark interface relies on subtle depth:

  • Canvas Base: zinc-950 (#09090b)
  • Card Containers: zinc-900 with 50% opacity (#121215)
  • Elevated Inputs & Modals: zinc-850 / zinc-800 (#18181b)
  • Active Hover Highlights: zinc-800 with 80% opacity

2. Micro-Border Radiance (The 1px Rule)

The signature feel of Linear comes from sub-pixel borders that catch ambient light:

  • Subtle structural border: 1px solid rgba(255, 255, 255, 0.08)
  • Top-edge highlight: subtle gradient stroke reflecting light from above
  • Outer glow: soft shadow with 0px blur and 1px spread to prevent clipping

3. Typography & Tabular Numerals

Typography in dark UI requires strict contrast control:

  • Headings: Crisp high-contrast white (#f4f4f5) with negative letter-spacing (-0.03em)
  • Body text: Muted zinc-400 (#a1a1aa) with relaxed line heights (1.6)
  • Data & Metrics: Always enable tabular numerals (tnum) to prevent jagged column jitter

How to Apply

Open the Linear Dark UI skill, choose your agent and follow its project installation instructions. Read the skill before use, then ask your agent to apply it and verify the result.

Try a concrete workflow

Review the Linear Dark UI skill and Anti-Generic UI Guardrails. Preview the free instructions, then compare the Founder Lifetime Pass if you need Pro workflows.