Headspace DESIGN.md

Brands

Headspace is the warmest mental-health product on the internet, and its 2024 Italic Studio rebrand made that warmth structural rather than decorative. The page does not open on the clinical white of healthcare…

Raw DESIGN.md

At a glance

Group
Brands
Main color
#0061efBlue design systems
Font
Headspace Apercu

Colors in this file

  • #2d2c2b

    ink

  • #f9f4f2

    canvas

  • #ffffff

    surface

  • #0061ef

    primary

  • #ffce00

    gold

  • #ff7300

    orange

  • #44423f

    slate

  • #4b4c4d

    body

  • #ffa500

    amber

  • #000000

    ink-pure

Overview

Visual Theme & Atmosphere

Headspace is the warmest mental-health product on the internet, and its 2024 Italic Studio rebrand made that warmth structural rather than decorative. The page does not open on the clinical white of healthcare software — it opens on a soft, warm cream (#f9f4f2), the single most frequent background on the site, which gives every surface a calm, paper-like glow. Text sits in a near-black warm charcoal (#2d2c2b) for headlines and a softer grey (#4b4c4d) for body — never pure black for reading copy — so the page feels approachable instead of stark. The one saturated action color is Headspace Blue (#0061ef), reserved for the primary "Try for free" CTA, so the eye learns that blue means "do this."

What makes Headspace unmistakable is the orange. The brand has carried an orange smiley since its conception — originally inspired by the saffron robes of the Buddhist meditation tradition — and the rebrand expanded that single mascot into a full emotion-driven illustration and animation system that flexes "from stress, sadness, contentment, and every mood in between." On product surfaces this shows up as a family of warm hues: a hot smiley orange (#ff7300), a softer amber (#ffa500), and a bright gold (#ffce00) used on content-mode chips and color-block cards. Supporting emotional accents — a candy pink (#ffa1cc), a deep meditative purple (#3b197f), and a grounding teal-navy (#27455c) — round out a palette deliberately built to "destigmatise seeking care," contrasting healthcare's typical "dreary sea of blues and greys."

The typographic identity is the custom Headspace Apercu, a "Headspace-ified" cut of Colophon Foundry's Aperçu commissioned for the rebrand — its letterforms carry curves that echo the smile and are engineered to "flex from playful to clinical." Every headline runs at weight 700 with tight negative tracking (-1.92px at 64px, -1.44px at 48px), giving the page a confident, rounded-bold voice. Geometry is friendly and pill-forward: 32px-radius pill buttons, 24px-radius feature cards, and circular play controls. There are essentially no drop shadows — depth comes from warm tints and color blocks, never elevation.

Key Characteristics:

  • Warm cream canvas (#f9f4f2) instead of clinical white — the calm, paper-like base
  • Headspace Blue (#0061ef) reserved for the single primary "do this" action
  • Signature warm-orange family (#ff7300 / #ffa500 / gold #ffce00) carrying the smiley emotion system
  • Custom Headspace Apercu (Colophon) at weight 700 for every headline — rounded, friendly, bold
  • Near-black warm charcoal (#2d2c2b) for headings, soft grey (#4b4c4d) for body — never pure black
  • Tight negative tracking on headlines (-1.92px at 64px, scaling with size)
  • Pill-forward geometry — 32px pill buttons, 24px cards, circular play controls
  • Shadowless depth — warm tints and saturated color blocks instead of elevation

Primary tasks

  • Play a ten-minute meditation before going to sleep.
  • Choose a session by mode: sleep, meditate, move, or focus.
  • Compare subscription plans and pick the one to start.
  • Start clinician-led online therapy instead of only meditating.
  • Check in on your mood with the AI companion.

Brand Narrative

Headspace was founded in 2010 by Andy Puddicombe — a former Buddhist monk — and Rich Pierson, who met when Pierson sought out Puddicombe's meditation classes in London. Their shared premise was that meditation should be demystified and made accessible to ordinary people, stripped of esoteric framing: a few minutes a day, guided in plain language. That accessibility mission is the root of everything in the brand, including the orange smiley, which the company has run since its conception — a mascot reportedly inspired by the saffron robes worn in the Buddhist meditation tradition.

By the 2020s Headspace had grown from a meditation app into a comprehensive mental-health platform spanning sleep, mindfulness, mental-health coaching, an AI companion (Ebb), and clinician-led online therapy — serving members "from better sleep, to everyday stress, to supporting members with care for more complex issues like anxiety and depression," and partnering with over 4,000 organizations. The 2024 rebrand, led by Italic Studio (ITAL/C) with a custom typeface from Colophon Foundry, was built to carry that expansion: "We built on the foundation of the brand to evolve it, not re-invent it."

What Headspace refuses, visible in its design: the clinical aesthetic of legacy healthcare — the "dreary sea of blues and greys" the design team explicitly named as the thing to avoid — and the stigma that surrounds talking about mental health. What it embraces: a warm cream canvas, an emotion-driven illustration system that depicts "stress, sadness, contentment, and every mood in between," a single trustworthy blue for action, and a typeface whose curves echo a smile and "flex from playful to clinical" so one brand can hold both a bedtime story and a depression-care pathway.

Principles

  1. Approachable, not clinical. The brand exists to destigmatise seeking care. UI implication: open on warm cream not clinical white; name hard topics plainly; keep every CTA low-pressure.
  2. Emotion is the system. The smiley illustration set spans the full range of human feeling. UI implication: use the warm-orange family and emotion accents to carry mood; treat illustration/animation as core, not garnish.
  3. One action, one color. Headspace Blue (#0061ef) means "do this." UI implication: reserve the saturated blue exclusively for the primary CTA so the next step is never ambiguous.
  4. Playful and clinical in one voice. The typeface flexes both ways. UI implication: the same Headspace Apercu weight 700 serves a bedtime headline and a therapy-care page — let tone shift through copy and color, not type swaps.
  5. Calm through softness. Pills, rounded cards, warm tints, no shadows. UI implication: keep geometry soft and depth flat; let color blocks (not elevation) do the separating.

Personas

Personas below are fictional archetypes informed by publicly observable Headspace user segments (stressed professionals, people with sleep difficulty, members seeking therapy, organizations offering mental-health benefits), not individual people.

Maya Robinson, 28, Chicago. A marketing manager who opens Headspace for a 10-minute meditation before bed and the Sleepcasts when she can't switch off. Chose it because the warm, friendly tone made meditation feel doable rather than intimidating. Distrusts wellness brands that feel preachy.

David Okafor, 41, Atlanta. A father of two using Headspace through his employer's benefits to manage everyday stress and, recently, the online therapy pathway. Values that the app names anxiety directly without making it feel like a diagnosis. Appreciates the calm, uncluttered interface after a long day.

Priya Nair, 34, Seattle. A software engineer who uses the focus and Move-mode content during work and the Ebb AI companion to check in on her mood. Likes that the brand feels human and illustrated rather than clinical and data-heavy.

Janet Mills, 47, HR Director, Denver. Evaluates mental-health benefits for a 3,000-person company. Chose Headspace partly because its approachable brand reduces the stigma employees feel about using a mental-health benefit at all.

Colors

Primary

  • Headspace Blue (#0061ef): The single saturated action color. Hero and header "Try for free" CTA backgrounds, "Start your free trial", and saturated color-block feature cards. The system's "do this" signal.
  • Charcoal Ink (#2d2c2b): Primary heading color and the solid dark-button fill ("Try for $0", "Check your coverage"). A warm near-black that carries approachability instead of clinical contrast.

Neutral & Surface

  • Warm Cream (#f9f4f2): The dominant page background and the soft-pill secondary button fill. The calm, paper-like base of the whole system.
  • White (#ffffff): Card surfaces, input backgrounds, and text on saturated colors.
  • Body Grey (#4b4c4d): The default body / reading text color set on <body>.
  • Slate (#44423f): Secondary nav and link text; soft-button labels.
  • Pure Black (#000000): Maximum-contrast text on gold/yellow surfaces (plan cards, some hero H3s).

Brand Emotion Accents

  • Smiley Orange (#ff7300): The hot signature orange — content-mode chips ("Sleep"), circular play buttons. The robe-orange that anchors the brand.
  • Amber (#ffa500): Softer orange for "Meditate" / "Move" / "Focus" content chips.
  • Gold (#ffce00): Bright yellow for the selected subscription plan card and color-block feature cards.
  • Candy Pink (#ffa1cc): Emotional accent for illustration blocks and decorative bands.
  • Meditation Purple (#3b197f): Deep purple accent for sleep/calm-themed surfaces.
  • Teal-Navy (#27455c): Grounding deep teal-navy for darker illustration backgrounds.

Borders

  • Tan Hairline (#e2ded9): The warm card / chip outline (2px solid) used on the hero theme selectors.
  • Input Border (#d2d5de): Cool grey 1px border on email / form inputs.

Typography

Font Family

  • Primary: Headspace Apercu (custom Colophon cut), with sans-serif fallback — used for every element on the site: headlines, nav, body, and buttons. There is no separate body font.

Hierarchy

RoleSizeWeightLine HeightLetter SpacingNotes
Display Hero64px (4.00rem)7001.00 (64px)-1.92pxHero / big section headlines
Display Large52px (3.25rem)7001.10 (57.2px)-1.56pxLarge feature headlines
Display Medium48px (3.00rem)7001.00 (48px)-1.44pxSecondary section heads
Feature40px (2.50rem)7001.15 (46px)-1.2pxFeature-card / band titles
Sub-section32px (2.00rem)7001.20 (38.4px)-0.96pxSmaller section heads
Card Title24px (1.50rem)7001.33 (32px)-0.6pxFooter / card headings
Body Large18px (1.13rem)5001.44 (26px)normalIntro / lead paragraphs
Body16px (1.00rem)4001.15 (18.4px)normalStandard reading text
Button16px (1.00rem)7001.00normalPrimary button labels
Button Small14px (0.88rem)7001.00normalCompact header CTA

Principles

  • Bold everywhere it matters: Every headline is weight 700. Headspace does not whisper — its rounded-bold display voice is the brand's confidence.
  • Tracking tightens with size: -1.92px at 64px, -1.44px at 48px, -1.2px at 40px, -0.96px at 32px. Headlines compress into dense, friendly blocks; body text stays at normal tracking.
  • One typeface, every job: Headspace Apercu runs from 64px hero to 14px nav CTA. The curves that echo the smile are the brand's typographic DNA at every size.
  • Buttons are bold: Even at 14-16px, CTA labels are weight 700 — the action always reads as confident.

Layout

Spacing System

  • Base unit: 8px
  • Scale: 4px, 8px, 12px, 16px, 24px, 40px, 64px
  • Notable: Buttons sit at a consistent 48px height with 24px horizontal padding; hero CTAs grow to 62px height with 40px padding for emphasis

Grid & Container

  • Centered single-column hero anchored by a 64px Headspace Apercu headline
  • Feature bands alternate warm cream (#f9f4f2) with saturated color-block cards (blue / gold) at 24px radius
  • Theme selectors arranged as a row of outlined 8px-radius tiles beneath the hero
  • Content chips ("Sleep", "Meditate") in a horizontal scrolling row in the smiley orange family

Whitespace Philosophy

  • Calm over density: generous vertical rhythm between bands; the cream base keeps the page breathing.
  • Color as structure: sections separate by saturated color blocks and warm tints, not by borders or shadows.
  • Pill rhythm: the repeated 32px-radius pill and 24px-radius card create a soft, consistent cadence.

Border Radius Scale

  • Small (8px): theme-selector tiles, content chips, plan-card inner elements
  • Medium (12px): subscription plan cards
  • Large (24px): feature cards, pill tabs
  • Pill (32px): all primary / secondary buttons
  • Circle (50%): audio play/pause controls

Responsive Behavior

Breakpoints

NameWidthKey Changes
Mobile<640pxSingle column, hero headline compresses, chips scroll horizontally
Tablet640-1024pxModerate padding, 2-up feature cards
Desktop1024-1440pxFull layout, centered hero, multi-column color-block bands

Touch Targets

  • Buttons sit at a comfortable 48px height (hero CTAs 62px) with full pill geometry for unmistakable targets
  • Content chips at 34px height with 12px horizontal padding
  • Circular play controls at 48px diameter

Collapsing Strategy

  • Hero: 64px Headspace Apercu headline scales down on mobile, weight 700 maintained
  • Content chip row: horizontal scroll on narrow viewports
  • Color-block feature bands: multi-column → stacked single column
  • Cream / color-block sections maintain full-width treatment

Image Behavior

  • Illustration and animation assets (the smiley emotion system) carry no shadow at any size
  • Cards maintain 24px radius across breakpoints
  • Color-block card tops keep the asymmetric 24px 24px 0 0 radius

Elevation & Depth

LevelTreatmentUse
Flat (Level 0)No shadowPage background, inline text, most surfaces
Tint (Level 1)#f9f4f2 cream shiftCard / band separation without elevation
Color block (Level 2)Saturated fill (#0061ef, #ffce00)Feature emphasis through color, not shadow
Hairline (Level 3)2px solid #e2ded9 / 1px solid #d2d5deSelector tiles, input outlines

Shadow Philosophy: Headspace is a near-shadowless system. Live inspection found box-shadow: none across the hero, nav, headings, cards, and buttons. Depth and grouping are communicated through warm tinted surfaces (#f9f4f2), saturated color blocks (#0061ef, gold #ffce00), and thin warm hairlines (#e2ded9) — never elevation. This keeps the experience feeling soft, calm, and illustration-led rather than the heavy card-stack chrome of clinical health software. When emphasis is needed, the system reaches for color from the smiley palette, not a drop shadow.

Values kept in prose

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

  • shadow.none: none

Motion & Easing

Durations:

TokenValueUse
motion-fast140msHover, button press, focus
motion-standard240msCard / band reveal, sheet, dropdown
motion-slow360msPage-level transitions, hero illustration reveal

Easings:

TokenCurveUse
ease-entercubic-bezier(0.2, 0.6, 0.25, 1)Arriving — cards, sheets, illustrations
ease-exitcubic-bezier(0.4, 0.0, 1, 1)Dismissals
ease-gentlecubic-bezier(0.4, 0.0, 0.2, 1)Soft two-way transitions, breathing animations

Motion rules: Motion is the brand's living layer — the smiley illustration and animation system is retained specifically to "simplify complex concepts" and convey emotion. Animations are warm and gentle, never snappy or jarring: a breathing-guide bubble expands and contracts on a slow, calm cycle; content cards fade-in from below at motion-standard / ease-enter. The orange smiley's expression transitions are soft eases, never bounces with overshoot — the feeling is reassurance, not delight-for-its-own-sake. Under prefers-reduced-motion: reduce, all transitions collapse to instant and ambient animation freezes; the product stays fully functional and calm.

Components

Buttons

Primary (Headspace Blue)

  • Background: #0061ef
  • Text: #ffffff
  • Radius: 32px
  • Padding: 14px 24px
  • Height: 48px
  • Font: 14px Headspace Apercu weight 700
  • Use: Header / hero primary CTA ("Try for free", "Start your free trial")

Charcoal Solid

  • Background: #2d2c2b
  • Text: #ffffff
  • Radius: 32px
  • Padding: 14px 20px
  • Height: 48px
  • Font: 16px Headspace Apercu weight 700
  • Use: High-emphasis dark CTA ("Try for $0", "Check your coverage")

Soft Cream Pill

  • Background: #f9f4f2
  • Text: #44423f
  • Radius: 32px
  • Padding: 12px 24px
  • Height: 48px
  • Font: 18px Headspace Apercu weight 700
  • Use: Secondary action ("Get started", "Learn more", "Chat with Ebb")

Circular Play / Pause

  • Background: #2d2c2b
  • Text: #ffffff
  • Radius: 50%
  • Padding: 10px
  • Height: 48px
  • Use: Audio play/pause control — also appears in smiley orange (#ff7300)

Pill Tabs (Segmented Selector)

Active

  • Background: #2d2c2b
  • Text: #ffffff
  • Radius: 24px
  • Padding: 0 24px
  • Height: 48px
  • Font: 18px Headspace Apercu weight 700
  • Use: Selected mode in the "What kind of headspace" segmented selector

Inactive

  • Background: #f9f4f2
  • Text: #2d2c2b
  • Radius: 24px
  • Padding: 0 24px
  • Height: 48px
  • Use: Unselected segmented options ("Guided meditations", "Sleep resources")

Cards & Containers

Feature Card (Cream)

  • Background: #f9f4f2
  • Radius: 24px
  • Use: Warm-cream feature card, shadowless

Color-Block Card

  • Background: #0061ef
  • Text: #ffffff
  • Radius: 24px 24px 0 0
  • Use: Saturated color-block feature card top — blue and gold (#ffce00) variants

Theme Selector Card

  • Background: #ffffff
  • Text: #4b4c4d
  • Border: 2px solid #e2ded9
  • Radius: 8px
  • Padding: 8px 16px 8px 24px
  • Use: Hero "Stress less / Sleep soundly / Manage anxiety" outlined selector tiles

Subscription Plan Card (Selected)

  • Background: #ffce00
  • Text: #000000
  • Border: 1px solid #ffce00
  • Radius: 12px
  • Padding: 24px
  • Use: Selected plan on the subscriptions page (unselected is #ffffff with 1px solid #44423f)

Badges / Content Chips

Smiley Orange Chip

  • Background: #ff7300
  • Text: #ffffff
  • Radius: 8px
  • Padding: 8px 12px
  • Font: 14px Headspace Apercu weight 500
  • Use: Content-mode chip ("Sleep")

Amber Chip

  • Background: #ffa500
  • Text: #000000
  • Radius: 8px
  • Padding: 8px 12px
  • Font: 14px Headspace Apercu weight 500
  • Use: Content-mode chips ("Meditate", "Move", "Focus")

Inputs & Forms

Email / Float-Label Field

  • Background: #ffffff
  • Text: #000000
  • Border: 1px solid #d2d5de
  • Radius: 8px
  • Padding: 24px 16px 8px
  • Height: 58px
  • Font: 16px Headspace Apercu
  • Use: Email capture with floating label

Navigation

  • Background: #ffffff
  • Links: #44423f, 16px Headspace Apercu weight 400
  • Logo: orange Headspace smiley left-aligned
  • CTA: Headspace Blue "Try for free" pill right-aligned (32px radius)
  • Use: Top horizontal nav ("Meditation", "Sleep", "Mindfulness", "Online therapy")

Verified: 2026-06-17 (omd:add-reference CREATE — Tier 1 live inspect, 2 surfaces) Tier 1 sources: https://www.headspace.com (homepage, live computed style); https://www.headspace.com/subscriptions (subscriptions surface — plan cards, content chips); https://italic-studio.com/projects/headspace-rebrand/ (2024 rebrand case study — typeface + illustration system) Tier 2 sources: getdesign.md/headspace — 404 (not catalogued); styles.refero.design/?q=headspace — no dedicated Headspace style page surfaced (generic browse grid only) Conflicts unresolved: none

States

StateTreatment
Empty (no saved content)Warm cream (#f9f4f2) canvas. Single charcoal (#2d2c2b) line in friendly tone, with one Headspace Blue CTA to explore the library. Illustration, not clutter.
Empty (no results)Soft grey (#4b4c4d) single line explaining nothing matched, plus a path back. Calm, never an error-sounding "No data".
Loading (content fetch)Skeleton cards on cream surface at final 24px-radius dimensions. Flat pulse — no shadow shimmer, consistent with the shadowless system.
Loading (audio buffer)Inline spinner inside the circular play control; the charcoal/orange play button stays in place.
Error (playback / network failed)Inline message in charcoal with a plain-language explanation and a gentle retry. Names what to do next, never a bare "Something went wrong".
Error (form validation)Field-level message below the input in a warm tone; describes what's valid, not just "Required".
Success (subscription started)Brief calm confirmation; next-step content surfaced immediately below. No celebratory emoji barrage — warmth, not hype.
SkeletonCream (#f9f4f2) blocks at final dimensions, 24px radius, flat pulse.
DisabledReduced opacity on surface and label together; Headspace Blue actions fade rather than turn grey to preserve brand read.

Do's and Don'ts

Do

  • Use the custom Headspace Apercu at weight 700 for every headline — the rounded-bold voice is the brand
  • Open on warm cream (#f9f4f2), not clinical white — it sets the calm tone
  • Reserve Headspace Blue (#0061ef) for the single primary "do this" action
  • Use the warm-orange family (#ff7300 / #ffa500 / gold #ffce00) for the emotion-driven content and illustration system
  • Use warm charcoal (#2d2c2b) for headings and soft grey (#4b4c4d) for body — not pure black
  • Apply tight negative tracking on headlines (-1.92px at 64px)
  • Use pill geometry — 32px buttons, 24px cards, circular play controls
  • Separate sections with color blocks and warm tints, not shadows

Don't

  • Use clinical white or a "dreary sea of blues and greys" — the rebrand exists to reject that
  • Set headlines in a light weight — display is always weight 700
  • Spread Headspace Blue across many elements — keep it the single action color
  • Use drop shadows for depth — Headspace is shadowless; reach for color and tint
  • Use pure black (#000000) for body text — reserve warm charcoal #2d2c2b / grey #4b4c4d
  • Use a substitute geometric sans — Headspace Apercu's smile-echoing curves are essential
  • Use sharp / square corners on buttons — everything interactive is a pill
  • Treat the orange as decorative only — it is the emotional core of the system

Voice & Tone

Headspace's voice is warm, plain-spoken, and quietly encouraging — a friend who happens to be a clinician, never a wellness brand shouting affirmations. The signature line "Be kind to your mind" sets the register: gentle, human, second-person, zero hype. The 2024 rebrand explicitly aimed to "destigmatise seeking care by making talking about mental health feel approachable and normalised," and the copy reflects that — it names hard things (stress, anxiety, sleep, depression) plainly and offers a low-pressure next step.

ContextTone
Hero headlinesWarm, declarative, human. "Be kind to your mind." Never clinical, never hype.
Feature descriptionsBenefit-first, calm. "Live a healthier, happier, more well-rested life in just a few minutes a day."
CTAsLow-pressure invitations. "Try for free", "Get started", "Learn more".
Content labelsPlain and friendly. "Sleep", "Meditate", "Move", "Focus", "Wake Up".
Care / clinical copyApproachable but credible. Names anxiety and depression directly to normalise them.

Voice samples (verbatim from live surfaces):

  • "Be kind to your mind" — subscriptions hero headline (the brand's core line). (verified live 2026-06-17)
  • "Live a healthier, happier, more well-rested life in just a few minutes a day. Get the science-backed mental health app for every moment." — homepage meta description. (verified live 2026-06-17)
  • "The mental health app for every moment" — homepage section headline (category-expansion framing). (verified live 2026-06-17)

Forbidden register: clinical coldness, fear-based health urgency, toxic-positivity affirmations, undefined jargon, exclamation-heavy hype. The voice stays calm even when the topic is heavy.

Agent Prompt Guide

Quick Color Reference

  • Primary CTA: Headspace Blue (#0061ef)
  • Dark CTA: Charcoal Ink (#2d2c2b)
  • Background: Warm Cream (#f9f4f2)
  • Card surface: White (#ffffff)
  • Heading text: Charcoal Ink (#2d2c2b)
  • Body text: Body Grey (#4b4c4d)
  • Secondary text: Slate (#44423f)
  • Brand orange: Smiley Orange (#ff7300), Amber (#ffa500), Gold (#ffce00)
  • Emotion accents: Pink (#ffa1cc), Purple (#3b197f), Teal-Navy (#27455c)
  • Border: Tan (#e2ded9), Input (#d2d5de)

Example Component Prompts

  • "Create a hero on warm cream (#f9f4f2) background. Headline at 64px Headspace Apercu weight 700, line-height 1.0, letter-spacing -1.92px, color #2d2c2b. Primary CTA: #0061ef background, white text, 32px radius pill, 14px/700 — 'Try for free'. Secondary cream pill: #f9f4f2 background, #44423f text, 32px radius."
  • "Design a feature card: warm cream #f9f4f2 background, 24px radius, no shadow. Title 40px Headspace Apercu weight 700, letter-spacing -1.2px, #2d2c2b. Below it a color-block card top in #0061ef with 24px 24px 0 0 radius and white text."
  • "Build content-mode chips: smiley orange #ff7300 background, white text, 8px radius, 8px 12px padding, 14px/500 — 'Sleep'. Amber #ffa500 variants for 'Meditate', 'Move', 'Focus'."
  • "Create a segmented pill selector: active pill #2d2c2b fill with white 18px/700 label, 24px radius; inactive pills #f9f4f2 fill with #2d2c2b label."
  • "Design a subscription plan card: selected = gold #ffce00 fill, black text, 12px radius, 24px padding; unselected = white with 1px solid #44423f border."

Iteration Guide

  1. Headspace Apercu weight 700 for every headline; the curves echo the smile
  2. Warm cream (#f9f4f2) is the base, not white — this is the calm signal
  3. Headspace Blue (#0061ef) is the single action color — don't spread it
  4. Orange family (#ff7300/#ffa500/#ffce00) carries the emotion / illustration system
  5. No shadows — separate with color blocks and warm tints
  6. Pill geometry throughout — 32px buttons, 24px cards, circular play controls
  7. Text is warm charcoal #2d2c2b / grey #4b4c4d, never pure black for body
  8. Tight negative tracking on headlines, normal on body

Governance

Known Gaps

  • Contrast, category-chip. Text #ffffff on #ff7300 measures 2.73:1, below the WCAG AA 4.5:1 minimum for normal-size text. Recorded as measured, not adjusted.

Use it with your agent

Save the file as DESIGN.md in your project root, then ask your agent to follow it for UI work. Or let the agent fetch it over MCP.

Download

curl -o DESIGN.md https://www.uiskillbook.com/design-md/headspace.md

MCP server

https://www.uiskillbook.com/mcp

MCP tool call

get_design_md({ "slug": "headspace" })