# Headspace — Style Reference
> Warm Modern Playfulness — like a friendly, brightly lit studio full of soft shapes and uplifting colors.
**Theme:** light
Headspace's design system radiates a calm, approachable, and playfully optimistic mood, achieved through a vibrant primary blue, a warm, soft neutral palette, and abundant negative space. Rounded forms and a clean sans-serif typeface contribute to a friendly and user-centric feel. The frequent use of accent colors, especially yellow and various purples, in illustrations and iconography creates visual interest and distinguishes different content areas.
## Tokens — Colors
| Name | Value | Token | Role |
|------|-------|-------|------|
| Sky Connect | `#0061ef` | `--color-sky-connect` | Primary interactive elements (buttons, links, active states) — a bold commitment to guidance and support amidst the softer palette. |
| Sunshine Burst | `#ffce00` | `--color-sunshine-burst` | Accent for illustrations, banners, and hero backgrounds — injects energetic warmth and optimism. |
| Deep Plum | `#3b197f` | `--color-deep-plum` | Accent for illustrations and thematic sections — provides a rich, grounding counterpoint to brighter accents. |
| Ocean Glimmer | `#00a4ff` | `--color-ocean-glimmer` | Accent for iconography and illustrations, suggesting clarity and serenity. |
| Blush Petal | `#ffa1cc` | `--color-blush-petal` | Accent in illustrations, adding softness and a touch of playfulness. |
| Forest Calm | `#02873` | `--color-forest-calm` | Accent in illustrations, symbolizing growth and tranquility. |
| Inkwell Gray | `#4b4c4d` | `--color-inkwell-gray` | Dominant body text, strong headings, button text — balances the soft background with clear readability. |
| True Black | `#000000` | `--color-true-black` | Highest contrast text, input text — used sparingly for emphasis. |
| Charcoal Tone | `#2d2c2b` | `--color-charcoal-tone` | Darker button backgrounds, secondary text, accents in illustrations — creates depth without harshness. |
| Cloud Whisper | `#f9f4f2` | `--color-cloud-whisper` | Light background surfaces, subtle button backgrounds — a warm, inviting default for section backgrounds and off-white elements. |
| Stone Slate | `#44423f` | `--color-stone-slate` | Text on lighter backgrounds for softer contrast, icon fills. |
| Pure White | `#ffffff` | `--color-pure-white` | Card backgrounds, selected elements, high-contrast text on dark backgrounds. |
| Pale Ash | `#e2ded9` | `--color-pale-ash` | Subtle borders, button outlines, subtle shadows — defines soft separation. |
| Light Stone | `#d0d0d0` | `--color-light-stone` | Input borders, light outlines on cards. |
## Tokens — Typography
### Headspace Apercu — The primary typeface for all text content. Its clean, humanist sans-serif forms contribute to the approachable and friendly tone. Weight 700 is reserved for main headings, 500 for subheadings and important labels, and 400 for body text; specific letter-spacing adjustments at larger sizes create an open, legible feel. · `--font-headspace-apercu`
- **Substitute:** system-ui, sans-serif
- **Weights:** 400, 500, 700
- **Sizes:** 12px, 14px, 16px, 18px, 20px, 24px, 29px, 32px, 40px, 48px, 52px, 56px, 64px, 72px
- **Line height:** 1.00, 1.10, 1.13, 1.15, 1.20, 1.29, 1.30, 1.32, 1.33, 1.38, 1.44, 1.50
- **Letter spacing:** -0.0300em, -0.0250em, -0.0100em
- **Role:** The primary typeface for all text content. Its clean, humanist sans-serif forms contribute to the approachable and friendly tone. Weight 700 is reserved for main headings, 500 for subheadings and important labels, and 400 for body text; specific letter-spacing adjustments at larger sizes create an open, legible feel.
### Type Scale
| Role | Size | Line Height | Letter Spacing | Token |
|------|------|-------------|----------------|-------|
| caption | 12px | 1.5 | — | `--text-caption` |
| body-sm | 14px | 1.44 | — | `--text-body-sm` |
| body | 16px | 1.38 | — | `--text-body` |
| subheading | 18px | 1.33 | — | `--text-subheading` |
| heading-sm | 24px | 1.32 | -0.48px | `--text-heading-sm` |
| heading | 32px | 1.29 | -0.8px | `--text-heading` |
| heading-lg | 40px | 1.2 | -1px | `--text-heading-lg` |
| display | 48px | 1.15 | -1.2px | `--text-display` |
## Tokens — Spacing & Shapes
**Base unit:** 4px
**Density:** comfortable
### Spacing Scale
| Name | Value | Token |
|------|-------|-------|
| 4 | 4px | `--spacing-4` |
| 8 | 8px | `--spacing-8` |
| 12 | 12px | `--spacing-12` |
| 16 | 16px | `--spacing-16` |
| 20 | 20px | `--spacing-20` |
| 24 | 24px | `--spacing-24` |
| 32 | 32px | `--spacing-32` |
| 40 | 40px | `--spacing-40` |
| 48 | 48px | `--spacing-48` |
| 56 | 56px | `--spacing-56` |
| 60 | 60px | `--spacing-60` |
| 64 | 64px | `--spacing-64` |
| 80 | 80px | `--spacing-80` |
| 84 | 84px | `--spacing-84` |
| 96 | 96px | `--spacing-96` |
| 100 | 100px | `--spacing-100` |
### Border Radius
| Element | Value |
|---------|-------|
| cards | 16px |
| pills | 800px |
| buttons | 24px |
| default | 8px |
| largeButtons | 32px |
### Shadows
| Name | Value | Token |
|------|-------|-------|
| subtle | `rgba(65, 61, 69, 0.2) 0px 2px 0px 0px` | `--shadow-subtle` |
### Layout
## Components
### Primary Action Button
**Role:** CTA
Filled button with 'Sky Connect' background (#0061ef), 'Pure White' text, and a `32px` border-radius. Padding 14px vertical, 20px horizontal. Features a subtle `rgba(65, 61, 69, 0.2) 0px 2px 0px 0px` shadow for soft depth.
### Ghost Button
**Role:** Secondary Action
Outlined button with 'Cloud Whisper' background (#f9f4f2), 'Charcoal Tone' text (#2d2c2b), and a `24px` border-radius. Padding 0px vertical, 24px horizontal. Border `1px solid Charcoal Tone`.
### Tab Button
**Role:** Navigation/Filter
Button with 'Pure White' background (#ffffff), 'Inkwell Gray' text (#4b4c4d), and an `8px` border-radius. Padding 8px vertical, 16px-24px horizontal. Border `1px solid Pale Ash` (#e2ded9).
### Dark Square Button
**Role:** Iconic/Informative
Square-shaped button with 'Charcoal Tone' background (#2d2c2b) and 'Pure White' text, likely for icons. Features a large `50%` (`800px` equivalent) border-radius making it circular, and 0px padding. Used for distinctive, usually smaller, interactive elements.
### Email Subscription Input
**Role:** Form Entry
Input field with 'Pure White' background (#ffffff), 'True Black' text (#000000), and an `8px` border-radius. Padding 24px top, 8px bottom, 16px horizontal. Border `1px solid Light Stone` (#d0d0d0).
### Content Card
**Role:** Information display
Container with 'Pure White' background (#ffffff), `28px` border-radius, `rgba(65, 61, 69, 0.2) 0px 2px 0px 0px` shadow, and `16px-24px` padding. Used for grouping related content, like the 'Mental health app' or 'Online therapy' blocks.
### Accent Banner
**Role:** Promotional strip
Full-width bar with a 'Sunshine Burst' (#ffce00) background, containing a 'Charcoal Tone' text link `HSA/FSA eligible: save with pre-tax dollars`. Used at the very top of the page for prominent announcements.
### Feature Pill Button
**Role:** Categorization/Navigation
Pill-shaped button with 'Charcoal Tone' background (#44423f) for icons/text like 'AI guidance', with 'Pure White' text. Has `50%` border-radius (800px equivalent) giving it a pill shape, and specific padding varying by content.
## Do's and Don'ts
### Do
- Prioritize 'Sky Connect' (#0061ef) for all primary call-to-action buttons and active navigation states.
- Apply 'Cloud Whisper' (#f9f4f2) for most large section backgrounds to maintain a soft, inviting atmosphere.
- Use border-radius `24px` for general buttons and `32px` for prominent CTA buttons to reinforce the soft, friendly aesthetic.
- Utilize 'Inkwell Gray' (#4b4c4d) as the primary text color for body copy and headings for optimal readability on light backgrounds.
- Ensure headings and body text use the Headspace Apercu font with careful application of letter-spacing adjustments: -0.0300em, -0.0250em, -0.0100em at larger sizes.
- Incorporate the subtle `rgba(65, 61, 69, 0.2) 0px 2px 0px 0px` shadow on buttons and cards to provide soft visual lift without heavy contrast.
- Use `8px` and `16px` as primary `elementGap` values for consistent spacing between UI elements.
### Don't
- Avoid harsh, high-contrast shadows or sharp corners, as they contradict the brand's soft and approachable aesthetic.
- Do not use highly saturated colors for large text blocks; reserve them for accents, illustrations, and interactive elements.
- Refrain from using excessively small or tight letter-spacing for body text; the system clearly favors open and legible typography.
- Do not introduce new typefaces; stick to Headspace Apercu and its defined weights.
- Avoid full-bleed imagery without defined edges or masking; prefer contained, rounded elements or abstract backgrounds.
- Do not use dark backgrounds for entire sections, except where explicitly indicated for specific brand moments (e.g., hero, unless data suggests otherwise).
- Limit the use of 'True Black' (#000000) to critical input text or select emphasis, defaulting to 'Inkwell Gray' (#4b4c4d) for most text.
## Elevation
- **Primary Action Button:** `rgba(65, 61, 69, 0.2) 0px 2px 0px 0px`
- **Content Card:** `rgba(65, 61, 69, 0.2) 0px 2px 0px 0px`
## Imagery
Imagery primarily consists of flat, geometric illustrations and product screenshots of the app. Illustrations are often brand-colored, utilizing a palette of 'Sunshine Burst', 'Deep Plum', 'Ocean Glimmer', and 'Blush Petal' to create a whimsical, abstract, and calming feeling. They are typically contained within rounded shapes or serve as background elements. Product screenshots are shown as device mockups, presented cleanly with rounded corners on 'Pure White' or subtly-shaded backgrounds, emphasizing the app's interface. Icons are filled, monoline, and often use accent colors, appearing friendly and guidance-oriented. The visual density is balanced, with imagery generally supporting text content rather than dominating it, creating an approachable and informative experience.
## Layout
The site employs a max-width centered layout for most content, providing generous white space around elements, contributing to a calm and focused experience. The hero section often features a centered headline over a 'Cloud Whisper' background, sometimes with a full-width accent banner at the very top. Content sections predominantly alternate light backgrounds with white card elements, or feature large content blocks with a `Cloud Whisper` or `Pure White` background. A distinct pattern of 2-column text+image sections is observed, with some feature sections using a loose grid of tab-like buttons. Navigation is a consistent sticky top-bar, and the footer is information-rich with a multi-column layout.
## Agent Prompt Guide
### Quick Color Reference
- **Text (Inkwell Gray):** #4b4c4d
- **Background (Cloud Whisper):** #f9f4f2
- **CTA (Sky Connect):** #0061ef
- **Border (Pale Ash):** #e2ded9
- **Accent (Sunshine Burst):** #ffce00
### 3-5 Example Component Prompts
1. **Create a hero section:** 'Cloud Whisper' background. Headline 'Sleep better all with Headspace' (font Headspace Apercu, 56px, weight 700, Inkwell Gray #4b4c4d, letter-spacing -1.4px). Subtext '1,000+ meditations...' (font Headspace Apercu, 18px, weight 400, Inkwell Gray #4b4c4d). Primary button 'Try for free' centered below (Sky Connect #0061ef background, Pure White #ffffff text, 32px radius, 14px 20px padding, shadow rgba(65, 61, 69, 0.2) 0px 2px 0px 0px).
2. **Generate a content card:** 'Pure White' #ffffff background, 16px border-radius, padding 20px all around, shadow rgba(65, 61, 69, 0.2) 0px 2px 0px 0px. Title 'Mental health app with expert-led meditations and tools' (Headspace Apercu, 29px, weight 700, Inkwell Gray #4b4c4d). Contains an illustration using Sunshine Burst #ffce00 and Deep Plum #3b197f.
3. **Design a secondary action button:** 'Cloud Whisper' #f9f4f2 background, Charcoal Tone #2d2c2b text, 24px border-radius, 1px solid Charcoal Tone border. Padding 0px vertical, 24px horizontal. Text 'Try for $0'.
4. **Create an input field for email signup:** 'Pure White' #ffffff background, 8px border-radius, 1px solid Light Stone #d0d0d0 border. Placeholder text (Headspace Apercu, 16px, weight 400, Inkwell Gray #4b4c4d). Padding 24px top, 8px bottom, 16px left/right. Alongside a Primary Action Button 'Subscribe' (Sky Connect #0061ef, Pure White #ffffff text, 32px radius).
5. **Render a feature pill button:** 'Charcoal Tone' #44423f background, 'Pure White' #ffffff text, 800px border-radius (for pill shape). Text 'AI guidance' (Headspace Apercu, 14px, weight 500).
## Similar Brands
- **Calm** — Shares a focus on mental well-being, using a calming, approachable color palette and clean, modern typography.
- **Waking Up** — Employs simple, clean layouts with strong typography and a focus on content hierarchy for a guided, educational experience.
- **Breethe** — Utilizes soft, muted colors, friendly illustrations, and a user-centric design to create a welcoming and supportive digital environment.
- **Noom** — Combines a sense of playfulness with a scientific approach, using vibrant accents against a largely neutral background and clean lines.
## Quick Start
### CSS Custom Properties
```css
:root {
/* Colors */
--color-sky-connect: #0061ef;
--color-sunshine-burst: #ffce00;
--color-deep-plum: #3b197f;
--color-ocean-glimmer: #00a4ff;
--color-blush-petal: #ffa1cc;
--color-forest-calm: #02873;
--color-inkwell-gray: #4b4c4d;
--color-true-black: #000000;
--color-charcoal-tone: #2d2c2b;
--color-cloud-whisper: #f9f4f2;
--color-stone-slate: #44423f;
--color-pure-white: #ffffff;
--color-pale-ash: #e2ded9;
--color-light-stone: #d0d0d0;
/* Typography — Font Families */
--font-headspace-apercu: 'Headspace Apercu', ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
/* Typography — Scale */
--text-caption: 12px;
--leading-caption: 1.5;
--text-body-sm: 14px;
--leading-body-sm: 1.44;
--text-body: 16px;
--leading-body: 1.38;
--text-subheading: 18px;
--leading-subheading: 1.33;
--text-heading-sm: 24px;
--leading-heading-sm: 1.32;
--tracking-heading-sm: -0.48px;
--text-heading: 32px;
--leading-heading: 1.29;
--tracking-heading: -0.8px;
--text-heading-lg: 40px;
--leading-heading-lg: 1.2;
--tracking-heading-lg: -1px;
--text-display: 48px;
--leading-display: 1.15;
--tracking-display: -1.2px;
/* Typography — Weights */
--font-weight-regular: 400;
--font-weight-medium: 500;
--font-weight-bold: 700;
/* Spacing */
--spacing-unit: 4px;
--spacing-4: 4px;
--spacing-8: 8px;
--spacing-12: 12px;
--spacing-16: 16px;
--spacing-20: 20px;
--spacing-24: 24px;
--spacing-32: 32px;
--spacing-40: 40px;
--spacing-48: 48px;
--spacing-56: 56px;
--spacing-60: 60px;
--spacing-64: 64px;
--spacing-80: 80px;
--spacing-84: 84px;
--spacing-96: 96px;
--spacing-100: 100px;
/* Layout */
/* Border Radius */
--radius-lg: 8px;
--radius-xl: 12px;
--radius-2xl: 16px;
--radius-3xl: 24px;
--radius-3xl-2: 32px;
--radius-full: 112px;
--radius-full-2: 800px;
/* Named Radii */
--radius-cards: 16px;
--radius-pills: 800px;
--radius-buttons: 24px;
--radius-default: 8px;
--radius-largebuttons: 32px;
/* Shadows */
--shadow-subtle: rgba(65, 61, 69, 0.2) 0px 2px 0px 0px;
}
```
### Tailwind v4
```css
@theme {
/* Colors */
--color-sky-connect: #0061ef;
--color-sunshine-burst: #ffce00;
--color-deep-plum: #3b197f;
--color-ocean-glimmer: #00a4ff;
--color-blush-petal: #ffa1cc;
--color-forest-calm: #02873;
--color-inkwell-gray: #4b4c4d;
--color-true-black: #000000;
--color-charcoal-tone: #2d2c2b;
--color-cloud-whisper: #f9f4f2;
--color-stone-slate: #44423f;
--color-pure-white: #ffffff;
--color-pale-ash: #e2ded9;
--color-light-stone: #d0d0d0;
/* Typography */
--font-headspace-apercu: 'Headspace Apercu', ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
/* Typography — Scale */
--text-caption: 12px;
--leading-caption: 1.5;
--text-body-sm: 14px;
--leading-body-sm: 1.44;
--text-body: 16px;
--leading-body: 1.38;
--text-subheading: 18px;
--leading-subheading: 1.33;
--text-heading-sm: 24px;
--leading-heading-sm: 1.32;
--tracking-heading-sm: -0.48px;
--text-heading: 32px;
--leading-heading: 1.29;
--tracking-heading: -0.8px;
--text-heading-lg: 40px;
--leading-heading-lg: 1.2;
--tracking-heading-lg: -1px;
--text-display: 48px;
--leading-display: 1.15;
--tracking-display: -1.2px;
/* Spacing */
--spacing-4: 4px;
--spacing-8: 8px;
--spacing-12: 12px;
--spacing-16: 16px;
--spacing-20: 20px;
--spacing-24: 24px;
--spacing-32: 32px;
--spacing-40: 40px;
--spacing-48: 48px;
--spacing-56: 56px;
--spacing-60: 60px;
--spacing-64: 64px;
--spacing-80: 80px;
--spacing-84: 84px;
--spacing-96: 96px;
--spacing-100: 100px;
/* Border Radius */
--radius-lg: 8px;
--radius-xl: 12px;
--radius-2xl: 16px;
--radius-3xl: 24px;
--radius-3xl-2: 32px;
--radius-full: 112px;
--radius-full-2: 800px;
/* Shadows */
--shadow-subtle: rgba(65, 61, 69, 0.2) 0px 2px 0px 0px;
}
```
Vibrant, rounded play-world. All…
Vibrant Data Clarity – like a…
calm clinical canvas
Blush Playground: A soft, inviting…

violet-tinted laboratory under…
Rounded digital canvas.
Serene teal workspace
Violet-tinged sunrise on white…
white canvas, vibrant accents
organic science lab
Digital Sandbox with Soft…
Misty Forest Canvas — a serene,…
Clinical clarity on white canvas

Crisp paper on a clean desk. A…
Calm workspace, grounded neutrals

organized desktop, clean and bright

Sky Blueprint on Bright Paper –…
Luminous radial gradient
Vibrant whiteboard sketch. Bright…
Clean canvas, purposeful accents