// may the 4th be with you⚔️
Back to designs

DESIGN.md · explainx registry

Linear

### Linear - Project management for engineers. - Ultra-minimal, precise, purple accent - description: "A near-black product-focused marketing canvas built around #010102 (the deepest dark surface of any tool in this collection),

Productivity & SaaS#design-md#awesome-design-md#productivity-saas#linear-app
Get a custom design.md for your product
DESIGN.md (markdown body)

Overview

Linear's marketing canvas is the deepest dark surface in this collection — {colors.canvas} is #010102, essentially pure black with a faint blue tint. On top sits a four-step surface ladder ({colors.surface-1} through {colors.surface-4}) for cards, panels, and lifted tiles, with hairline borders running from {colors.hairline} (#23252a) up through {colors.hairline-strong} and {colors.hairline-tertiary}. Light gray text ({colors.ink} #f7f8f8) carries the body and headlines.

The single chromatic accent is Linear lavender-blue {colors.primary} (#5e6ad2) — used on the brand mark, focus rings, and the primary CTA button. A lighter hover state ({colors.primary-hover} #828fff) and a focus-tinted variant ({colors.primary-focus} #5e69d1) extend the same hue. Linear avoids saturated greens, oranges, reds, etc. on the marketing canvas — the only semantic color is {colors.semantic-success} (#27a644) for status pills and the rare success indicator.

Display type runs Linear's custom sans (with SF Pro Display fallback) at weight 500–700 with negative letter-spacing scaling from -3.0px at 80px down to 0 at body. The body family is Linear's text cut, and a Linear Mono is reserved for code snippets in product screenshots.

The page rhythm is dense product screenshots — Linear's marketing leads with high-fidelity captures of the product UI (issue list, project view, dashboard) framed in {colors.surface-1} panels with {rounded.xl} 16px corners. The chrome is intentionally minimal so the app screenshots can do the heavy lifting.

Key Characteristics:

  • Dark-canvas marketing system{colors.canvas} (#010102) is the deepest dark in this collection.
  • Lavender-blue brand accent ({colors.primary} #5e6ad2) — used scarcely on brand mark, focus, and the primary CTA.
  • Four-step surface ladder (canvas → surface-1 → surface-2 → surface-3 → surface-4) carries hierarchy without shadow.
  • Display tracking pulls aggressively negative (-3.0px at 80px); body holds at -0.05px.
  • Cards use {rounded.lg} 12px corners with 1px hairline borders — never pill, rarely 16px.
  • Product UI screenshots dominate the page. The marketing chrome is a dark frame for the app.
  • No second chromatic color. No atmospheric gradients. No spotlight cards.

Colors

Source pages: linear.app (home), /intake, /pricing, /contact/sales, /build.

Brand & Accent

  • Lavender-Blue ({colors.primary}): The signature Linear accent — primary CTA, brand mark, link emphasis.
  • Lavender Hover ({colors.primary-hover}): Lighter lavender (#828fff) — hovered state of the primary CTA.
  • Lavender Focus ({colors.primary-focus}): Focus-ring tint (#5e69d1) — focused inputs, focused buttons.
  • Brand Secure ({colors.brand-secure}): Muted lavender-gray (#7a7fad) — used in "Linear Security" surfaces.

Surface

  • Canvas ({colors.canvas}): Default page background — #010102, near-pure black with a faint blue tint.
  • Surface 1 ({colors.surface-1}): One step above canvas — feature cards, pricing cards, product screenshot panels.
  • Surface 2 ({colors.surface-2}): Two steps above — featured pricing card, hovered cards.
  • Surface 3 ({colors.surface-3}): Three steps above — line-tertiary backgrounds, sub-nav.
  • Surface 4 ({colors.surface-4}): Four steps above — bg-level-3, deepest lifted surface.
  • Hairline ({colors.hairline}): 1px borders on cards and dividers.
  • Hairline Strong ({colors.hairline-strong}): Stronger 1px borders — input focus rings.
  • Hairline Tertiary ({colors.hairline-tertiary}): Tertiary borders for nested surfaces.
  • Inverse Canvas ({colors.inverse-canvas}): Pure white — surface of the inverse pill CTA on a small set of section openers.
  • Inverse Surface 1 ({colors.inverse-surface-1}): One step above inverse canvas.
  • Inverse Surface 2 ({colors.inverse-surface-2}): Two steps above inverse canvas.

Text

  • Ink ({colors.ink}): All headlines and emphasized body type — light gray #f7f8f8.
  • Ink Muted ({colors.ink-muted}): Secondary type at #d0d6e0 — meta info on hero panels.
  • Ink Subtle ({colors.ink-subtle}): Tertiary type at #8a8f98 — deselected pricing tabs, footer columns.
  • Ink Tertiary ({colors.ink-tertiary}): Quaternary at #62666d — disabled, footnotes.

Semantic

  • Success Green ({colors.semantic-success}): Status pills, success indicators. The only semantic color on marketing.
  • Overlay ({colors.semantic-overlay}): Pure black overlay scrim for modals.

Typography

Font Family

  • Linear Display — Linear's custom display sans; fallback SF Pro Display, -apple-system, system-ui, Segoe UI, Roboto. Carries display-xl through subhead.
  • Linear Text — Linear's custom text sans (a slightly different cut tuned for body sizes); same fallback stack. Carries body sizes, button labels, captions.
  • Linear Mono — Linear's custom mono; fallback ui-monospace, SF Mono, Menlo. Used for code snippets in product screenshots and for status / ID tokens.

The marketing surface treats Display and Text as one continuous voice; the family change is silent.

Hierarchy

TokenSizeWeightLine HeightLetter SpacingUse
{typography.display-xl}80px6001.05-3.0pxLargest hero headline
{typography.display-lg}56px6001.10-1.8pxSection opener headlines
{typography.display-md}40px6001.15-1.0pxSub-section headlines
{typography.headline}28px6001.20-0.6pxPricing tier titles, CTA banner heading
{typography.card-title}22px5001.25-0.4pxFeature card title
{typography.subhead}20px4001.40-0.2pxLead body, intro paragraphs
{typography.body-lg}18px4001.50-0.1pxHero subhead, lead paragraphs
{typography.body}16px4001.50-0.05pxDefault body
{typography.body-sm}14px4001.500Card body, footer columns
{typography.caption}12px4001.400Captions, meta, status
{typography.button}14px5001.200All button labels
{typography.eyebrow}13px5001.300.4pxSection eyebrow (slight positive tracking)
{typography.mono}13px4001.500Linear Mono for code in product screenshots

Principles

  • Aggressive negative tracking on display (-3.0px at 80px ≈ 4% of size).
  • Single voice from display to body. Display-xl at 600 → body at 400 — same family, narrower weights.
  • Eyebrow uses positive tracking (+0.4px) — contrast against the negative-tracked display marks the eyebrow as taxonomy.
  • Mono only in code contexts. Linear Mono lives inside product screenshots — not on marketing chrome.

Note on Font Substitutes

Linear's custom typeface isn't publicly distributed; the documented fallback SF Pro Display, -apple-system, system-ui is the recommended substitute on macOS. For cross-platform implementation, Inter at weight 500 / 600 / 700 is the closest free substitute. Geist Sans is also viable. For mono, JetBrains Mono or Geist Mono at weight 400 closely approximates Linear Mono.

Layout

Spacing System

  • Base unit: 4px.
  • Tokens (front matter): {spacing.xxs} 4px · {spacing.xs} 8px · {spacing.sm} 12px · {spacing.md} 16px · {spacing.lg} 24px · {spacing.xl} 32px · {spacing.xxl} 48px · {spacing.section} 96px.
  • Card interior padding: {spacing.lg} 24px on feature/pricing cards; {spacing.xl} 32px on testimonial cards; {spacing.xxl} 48px on CTA banners.
  • Pill button padding: 8px vertical · 14px horizontal — Linear's compact button spec.
  • Form input padding: 8px vertical · 12px horizontal.

Grid & Container

  • Max content width sits around 1280px.
  • Card grids are 3-up at desktop, 2-up at tablet, 1-up at mobile.
  • Pricing tier grid is 3-up; comparison strip below shows checkmarks per tier.
  • Product screenshot panels span full content width — they're the protagonist.

Whitespace Philosophy

The dark canvas IS the whitespace. Sections separate by lift onto surface-1 panels, not by gaps in white. Within a panel, generous {spacing.lg} 24px gaps between content blocks; {spacing.section} 96px between sections.

Elevation & Depth

LevelTreatmentUse
0 (flat)No shadow, no borderDefault for body type, hero text, footer
1 (charcoal lift){colors.surface-1} background on canvas, 1px {colors.hairline}Default cards, product panels
2 (surface-2 lift){colors.surface-2} background, 1px {colors.hairline-strong}Featured pricing card, hovered cards
3 (surface-3 lift){colors.surface-3} backgroundSub-nav, dropdown menus
4 (focus ring)2px {colors.primary-focus} outline at 50% opacityFocused input, focused button

Linear's depth is carried by surface ladder + hairline borders. The brand resists drop shadows on dark almost entirely.

Decorative Depth

  • Product UI screenshots dominate as decorative depth.
  • No atmospheric gradients, no spotlight cards.
  • Subtle white edge highlight on the top edge of lifted panels — gives the dark surface a faint "pixel rendered" feel.

Shapes

Border Radius Scale

TokenValueUse
{rounded.xs}4pxSmall chips, status badges
{rounded.sm}6pxInline tags
{rounded.md}8pxAll buttons, form inputs
{rounded.lg}12pxPricing cards, feature cards, testimonial cards
{rounded.xl}16pxProduct screenshot panels
{rounded.xxl}24pxOversized CTA banners (rare)
{rounded.pill}9999pxPricing tab toggles, status pills
{rounded.full}9999pxAvatar circles

Photography & Illustration Geometry

  • Product UI screenshots dominate; they sit in {rounded.xl} 16px tiles with {spacing.lg} 24px outer padding.
  • Customer logo tiles render at small sizes (~24px logo height) on {colors.canvas} with no border.
  • Avatar circles in testimonial cards use {rounded.full} at 32–40px sizes.

Components

Buttons

button-primary — Lavender CTA. The default primary CTA across all pages.

  • Background {colors.primary}, text {colors.on-primary}, type {typography.button}, padding 8px 14px, rounded {rounded.md}.
  • Pressed state lives in button-primary-pressed (background shifts to {colors.primary-focus}).
  • Hover state lives in button-primary-hover (background shifts to {colors.primary-hover} lighter lavender).

button-secondary — Charcoal button. Used for secondary CTAs ("Sign in", "Read changelog").

  • Background {colors.surface-1}, text {colors.ink}, type {typography.button}, padding 8px 14px, rounded {rounded.md}. 1px {colors.hairline} border.

button-tertiary — Plain text button.

  • Background {colors.canvas}, text {colors.ink}, type {typography.button}, rounded {rounded.md}, padding 8px 14px.

button-inverse — White-on-dark inverse CTA.

  • Background {colors.inverse-canvas}, text {colors.inverse-ink}, type {typography.button}, rounded {rounded.md}, padding 8px 14px.

Pricing Tabs

pricing-tab-default + pricing-tab-selected — Pill-toggle on /pricing.

  • Default: {colors.canvas} background, {colors.ink-subtle} text, rounded {rounded.pill}, padding 6px 14px.
  • Selected: {colors.surface-2} background, {colors.ink} text — selected = surface lift.

Cards & Containers

pricing-card — Each tier on /pricing.

  • Background {colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.lg}, padding 24px. 1px {colors.hairline} border.

pricing-card-featured — Recommended tier — surface lift to surface-2.

  • Background {colors.surface-2}, otherwise identical structure.

feature-card — Generic feature highlight tile.

  • Background {colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.lg}, padding 24px.

product-screenshot-card — The dominant card type — frames a high-fidelity Linear app UI screenshot.

  • Background {colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.xl}, padding 24px.

testimonial-card — Customer quote with avatar + name + role.

  • Background {colors.surface-1}, text {colors.ink}, type {typography.body-lg}, rounded {rounded.lg}, padding 32px.

customer-logo-tile — Small tile in the customer marquee.

  • Background {colors.canvas}, text {colors.ink-subtle}, type {typography.caption}, rounded {rounded.xs}, padding 16px.

cta-banner — Closing CTA panel near page bottom.

  • Background {colors.surface-1}, text {colors.ink}, type {typography.headline}, rounded {rounded.lg}, padding 48px.

Inputs & Forms

text-input + text-input-focused — Form fields on /contact/sales and signup overlays.

  • Background {colors.surface-1}, text {colors.ink}, type {typography.body}, rounded {rounded.md}, padding 8px 12px.
  • Focused state retains the same surface; the focus ring is a 2px {colors.primary-focus} outline at 50% opacity.

Status & Build Page

changelog-row — Each row in /build (changelog page) listing version, date, and changes.

  • Background {colors.canvas}, text {colors.ink}, type {typography.body}, rounded {rounded.xs}, padding 24px 0. 1px {colors.hairline} bottom rule.

status-badge — Small status pill.

  • Background {colors.surface-2}, text {colors.ink-muted}, type {typography.caption}, rounded {rounded.pill}, padding 2px 8px.

Navigation

top-nav — Sticky dark bar with the Linear wordmark left, primary nav links centered, and a button-secondary ("Sign in") + button-primary ("Get started") pair right.

  • Background {colors.canvas}, text {colors.ink}, type {typography.body-sm}, height 56px.

Footer

footer — Dense link grid on {colors.canvas} with the Linear wordmark left.

  • Background {colors.canvas}, text {colors.ink-subtle}, type {typography.caption}, padding 64px 32px.

Do's and Don'ts

Do

  • Reserve {colors.canvas} (#010102) as the system's anchor surface — the faint blue tint is intentional.
  • Use {colors.primary} lavender ONLY for: brand mark, primary CTA, focus ring, link emphasis.
  • Use the four-step surface ladder for hierarchy. Avoid skipping levels.
  • Pair display weight 600 with body weight 400 — Linear resists 700+ display weights.
  • Apply negative letter-spacing aggressively on display.
  • Use product UI screenshots as the protagonist of every section.
  • Compose CTAs as {rounded.md} 8px corners.

Don't

  • Don't ship a light-mode marketing page.
  • Don't use lavender as a section background or card fill.
  • Don't introduce a second chromatic accent (orange, pink, green for marketing).
  • Don't add atmospheric gradients or spotlight cards.
  • Don't pill-round CTAs.
  • Don't use #000000 true black as the canvas.
  • Don't combine multiple bright accents in product screenshot mockups.

Responsive Behavior

Breakpoints

NameWidthKey Changes
Desktop-XL1440pxDefault desktop layout
Desktop1280pxCard grid 3-up maintained
Tablet1024pxCard grid 3-up → 2-up
Mobile-Lg768pxPricing comparison becomes accordion; nav hamburger
Mobile480pxSingle-column; display-xl scales 80px → ~36px

Touch Targets

  • CTAs hold ≥40px tap height across viewports.
  • Pricing tab pills hold ≥36px tap height; touch viewports grow to ≥44px.
  • Form inputs hold ≥44px tap target on touch.

Collapsing Strategy

  • Top nav: links collapse to hamburger below 768px.
  • Card grids: 3-up → 2-up at 1024px → 1-up below 768px.
  • Pricing comparison: per-tier accordion below 768px.
  • Display type: {typography.display-xl} 80px scales toward {typography.display-md} 40px on mobile.

Image Behavior

  • Product UI screenshots maintain aspect ratio and never crop.
  • Customer logos in the marquee may collapse from 6-up to 3-up below 768px.

Iteration Guide

  1. Focus on ONE component at a time and reference it by its components: token name.
  2. When introducing a section, decide first which surface lift it lives on.
  3. Default body to {typography.body} at weight 400.
  4. Run npx @google/design.md lint DESIGN.md after edits.
  5. Add new variants as separate component entries.
  6. Treat lavender as scarce: brand mark, primary CTA, focus, link emphasis.
  7. Lead every section with a product UI screenshot.

Known Gaps

  • The four-step surface ladder values are extracted directly from Linear's --color-bg-level-3, --color-line-tint, etc. CSS variables; they are Linear's canonical surface spec.
  • Form-field error and validation styling is not visible on the inspected pages.
  • Light mode is not documented because the marketing site does not ship a light theme.
  • Linear's actual product UI uses a richer color-tag palette (red, orange, yellow, green, blue, purple) for issue priorities and project labels — those colors live in the in-product surfaces shown in mockups.
  • The custom display, text, and mono families are proprietary; an open-source substitute is acceptable.

Usage

  1. Copy DESIGN.md into your project or paste it into your IDE agent chat.
  2. Ask your assistant to follow the tokens for color, typography, spacing, and component styling.
  3. When collaborating, share the file directly—or tap “Copy page link” below so teammates open the same snapshot.

Common questions

What is Linear on explainx.ai?
### Linear - Project management for engineers. - Ultra-minimal, precise, purple accent - description: "A near-black product-focused marketing canvas built around #010102 (the deepest dark surface of any tool in this collection), Listed under category “Productivity & SaaS”. Explainx.ai mirrors the full DESIGN.md document so assistants can cite stable tokens and prose in one place.
What is DESIGN.md?
DESIGN.md blends YAML design tokens—colors, typography, spacing, radii—with markdown that explains intent. Google documents this pattern for agent-driven UI work under Stitch (stitch.withgoogle.com).
How do I use this with ChatGPT, Cursor, Claude Code, or another IDE agent?
Paste the DESIGN.md into your repo root or attach it to the agent conversation, then ask explicitly for layouts, spacing, palette, type scale, and component tone that follow the document. Refresh from this listing when upstream authors publish changes.
Where is the source repo?
Maintainers link to github.com/VoltAgent/awesome-design-md. Community listings on explainx.ai may reference popular aesthetic names for inspiration; that does not imply official endorsement by any trademark holder.
How current is this DESIGN.md?
Explainx snapshots the file at import time. Recorded last update on this listing: May 4, 2026.
Need a fresh DESIGN.md from scratch?
Use the ExplainX DESIGN.md generator to describe your product and audience; it returns Stitch-style YAML plus narrative guidance you can publish or submit to the registry afterward.

Still exploring the format? Browse the full DESIGN.md registry or draft a new system with our DESIGN.md generator.

Community listing for AI design workflows—not necessarily affiliated with any brand referenced in the name or summary. For context on the format, see Google Stitch.