# Material Design: design brief

> Systematic, tonal, adaptive.

Material Design is a website design language in the 06 Depth & Material family of [Design Atlas by H190K](https://designatlas.h190k.com/). This brief describes how the reference mockup is built: theme tokens for light and dark, typography, shape, page structure and motion. The mockup demonstrates the style on Pebble Notes, a notes and to-do app that syncs everywhere.

> [!IMPORTANT]
> **Concept mockup.** Pebble Notes is a fictional brand: every name, person, figure and logo on the page is invented, and icons, illustrations, charts and small details are illustrative stand-ins. The mockup shows the direction of the Material Design style (mood, typography, colour, layout), not a finished design or template. Final client websites are designed from scratch around the client's own brand, content and goals.

## Quick links

- Live mockup (light & dark toggle): https://designatlas.h190k.com/designs/material-design/
- Light preview: https://designatlas.h190k.com/previews/material-design-light.jpg
- Dark preview: https://designatlas.h190k.com/previews/material-design-dark.jpg
- Social card: https://designatlas.h190k.com/og/material-design.jpg
- Design spec (JSON): https://designatlas.h190k.com/designs/material-design.json
- This brief (Markdown): https://designatlas.h190k.com/designs/material-design.md
- Request this design from H190K: https://designatlas.h190k.com/contact/?design=material-design
- Reference guide (URL patterns, schema): https://designatlas.h190k.com/agents.md

## At a glance

| | |
| --- | --- |
| Family | 06 Depth & Material |
| Era | 2014 to now |
| Also known as | Material You, Material 3 |
| Example brand (fictional) | Pebble Notes, a notes and to-do app that syncs everywhere |
| Type | Roboto Flex Variable (body) |
| Corners | very rounded (~16px), with pill-shaped buttons/badges |
| Content width | 1180px |

## Description

Material Design is a complete design system built on tonal colour palettes, elevation, clear motion and consistent components. Its latest version, Material 3, adds personal dynamic colour, larger shapes and expressive type.

## Signature traits (keep these)

- Tonal colour roles
- Elevation through tone
- Rounded containers and FABs
- Consistent component set
- Roboto-style type scale
- Type pairing: Roboto Flex Variable for headings and body (or close equivalents)
- Corner language: very rounded (~16px), with pill-shaped buttons/badges
- Depth style: 0 1px 2px var(--md-shadow), 0 1px 3px 1px var(--md-shadow-2)
- A clear accent role (--md-primary: #6750a4 in light, #d0bcff in dark), used sparingly for CTAs and highlights
- Both a light and a dark theme driven by the same CSS custom-property names
- Content width around 1180px
- prefers-reduced-motion support for every animation

## Best for

- Android and cross-platform apps
- Productivity tools
- Large product ecosystems

## Colour

Theme switching: light tokens live on `:root`; dark values override them on `:root[data-theme='dark']` (the `<html>` element carries `data-theme="light"` or `"dark"`). Values below are resolved (any `var()` references expanded).

### Palette summary

| Role | Light | Dark |
| --- | --- | --- |
| Background | `#fef7ff` (`--md-surface`) | `#141218` (`--md-surface`) |
| Surface | `#f3edf7` (`--md-sc`) | `#211f26` (`--md-sc`) |
| Text | `#1d1b20` (`--md-on-surface`) | `#e6e0e9` (`--md-on-surface`) |
| Muted text | `#49454f` (`--md-on-surface-variant`) | `#cac4d0` (`--md-on-surface-variant`) |
| Border / line | `#79747e` (`--md-outline`) | `#938f99` (`--md-outline`) |
| Accent 1 | `#6750a4` (`--md-primary`) | `#d0bcff` (`--md-primary`) |
| Accent 2 | `#d0bcff` (`--md-inverse-primary`) | `#6750a4` (`--md-inverse-primary`) |
| Catalog swatch (bg / surface / accent) | `#fef7ff` `#e8def8` `#6750a4` | `#141218` `#2b2930` `#d0bcff` |

### All theme tokens (52)

| Token | Light | Dark |
| --- | --- | --- |
| `--md-primary` | `#6750a4` | `#d0bcff` |
| `--md-on-primary` | `#ffffff` | `#381e72` |
| `--md-primary-container` | `#eaddff` | `#4f378b` |
| `--md-on-primary-container` | `#21005d` | `#eaddff` |
| `--md-secondary` | `#625b71` | `#ccc2dc` |
| `--md-on-secondary` | `#ffffff` | `#332d41` |
| `--md-secondary-container` | `#e8def8` | `#4a4458` |
| `--md-on-secondary-container` | `#1d192b` | `#e8def8` |
| `--md-tertiary` | `#7d5260` | `#efb8c8` |
| `--md-tertiary-container` | `#ffd8e4` | `#633b48` |
| `--md-on-tertiary-container` | `#31111d` | `#ffd8e4` |
| `--md-error` | `#b3261e` | `#f2b8b5` |
| `--md-surface` | `#fef7ff` | `#141218` |
| `--md-on-surface` | `#1d1b20` | `#e6e0e9` |
| `--md-on-surface-variant` | `#49454f` | `#cac4d0` |
| `--md-outline` | `#79747e` | `#938f99` |
| `--md-outline-variant` | `#cac4d0` | `#49454f` |
| `--md-sc-lowest` | `#ffffff` | `#0f0d13` |
| `--md-sc-low` | `#f7f2fa` | `#1d1b20` |
| `--md-sc` | `#f3edf7` | `#211f26` |
| `--md-sc-high` | `#ece6f0` | `#2b2930` |
| `--md-sc-highest` | `#e6e0e9` | `#36343b` |
| `--md-inverse-surface` | `#322f35` | `#e6e0e9` |
| `--md-inverse-on-surface` | `#f5eff7` | `#322f35` |
| `--md-inverse-primary` | `#d0bcff` | `#6750a4` |
| `--md-shadow` | `rgba(0, 0, 0, 0.3)` | `rgba(0, 0, 0, 0.6)` |
| `--md-shadow-2` | `rgba(0, 0, 0, 0.15)` | `rgba(0, 0, 0, 0.35)` |
| `--md-scrim-dark` | `#000000` | same |
| `--pal-violet-c` | `#eaddff` | `#4f378b` |
| `--pal-violet-on` | `#21005d` | `#eaddff` |
| `--pal-violet-p` | `#6750a4` | `#d0bcff` |
| `--pal-violet-onp` | `#ffffff` | `#381e72` |
| `--pal-violet-q` | `#d0bcff` | `#6750a4` |
| `--pal-violet-r` | `#7d5260` | `#efb8c8` |
| `--pal-green-c` | `#b7f397` | `#205107` |
| `--pal-green-on` | `#042100` | `#b7f397` |
| `--pal-green-p` | `#386a20` | `#9cd67d` |
| `--pal-green-onp` | `#ffffff` | `#0c3900` |
| `--pal-green-q` | `#9cd67d` | `#386a20` |
| `--pal-green-r` | `#55624c` | `#bccbb0` |
| `--pal-blue-c` | `#d1e4ff` | `#00497d` |
| `--pal-blue-on` | `#001d36` | `#d1e4ff` |
| `--pal-blue-p` | `#0061a4` | `#9ecaff` |
| `--pal-blue-onp` | `#ffffff` | `#003258` |
| `--pal-blue-q` | `#9ecaff` | `#0061a4` |
| `--pal-blue-r` | `#6b5778` | `#d7bee4` |
| `--pal-orange-c` | `#ffdcbe` | `#6a3c00` |
| `--pal-orange-on` | `#2c1600` | `#ffdcbe` |
| `--pal-orange-p` | `#8b5000` | `#ffb870` |
| `--pal-orange-onp` | `#ffffff` | `#4a2800` |
| `--pal-orange-q` | `#ffb870` | `#8b5000` |
| `--pal-orange-r` | `#51643f` | `#b8cda0` |

## Typography

| Family | Role | Uses | Package | CSS stack |
| --- | --- | --- | --- | --- |
| Roboto Flex Variable | body | 1 | `@fontsource-variable/roboto-flex` (variable) | `'Roboto Flex Variable', Roboto, system-ui, sans-serif` |

Font packages (self-hosted via Fontsource): `@fontsource-variable/roboto-flex`.

Type scale (from the CSS, light theme):

| Element | Size | Weight | Line height | Letter spacing | Other |
| --- | --- | --- | --- | --- | --- |
| h1 | `57px` | `400` | `64px` | `-0.25px` | – |
| h2 | `36px` | `400` | `44px` | `0` | – |
| h3 | `24px` | `400` | `32px` | – | – |

## Shape and depth

- **Corner style:** very rounded (~16px), with pill-shaped buttons/badges
- **Border radii (most common first):** `50%`, `16px`, `28px`, `12px`, `2px`, `8px`, `999px`, `24px`, `36px`, `0`
- **Shadows (most common first; `var()` names are custom properties of the mockup, mostly the theme tokens above):**
  - `0 1px 2px var(--md-shadow), 0 1px 3px 1px var(--md-shadow-2)`
  - `0 1px 3px var(--md-shadow), 0 4px 8px 3px var(--md-shadow-2)`
  - `0 1px 2px var(--md-shadow), 0 2px 6px 2px var(--md-shadow-2)`
  - `0 0 0 2px #0b0b10`
  - `0 2px 6px var(--md-shadow-2), 0 24px 48px -12px var(--md-shadow-2)`
  - `0 88px 0 var(--md-outline)`
- **Borders (most common first):**
  - `1px solid var(--md-outline-variant)`
  - `1px solid var(--md-outline)`
  - `border-top: 1px solid var(--md-outline-variant)`
  - `1px solid color-mix(in srgb, currentColor 35%, transparent)`
  - `1px solid color-mix(in srgb, var(--md-on-primary) 60%, transparent)`
  - `2px solid currentColor`
- **Visual effects used:** mask-image (4), linear-gradient (3), radial-gradient (3), conic-gradient (1), inline SVG illustration (1), mix-blend-mode (1), outlines (1)

## Page structure

- **Content width:** 1180px (`.main > section { max-width: 1180px }`)
- **Breakpoints:** 1180px, 961px, 960px, 640px
- **Main navigation:** Overview · Features · Sync · Pricing
- **H1 in the mockup:** “Every thought, neatly in its place.” (fictional copy, replace it)

Heading outline of the mockup, in order (h1/h2, with h3s beneath). Use it for rhythm and section types, not as copy:

1. **[H1]** Every thought, neatly in its place.
2. Small tools that do one thing really well.
   - Voice to note · Lists that remember · Sketch and handwrite · Gentle reminders · Labels, not folders · Private by default
3. One note, four ways to fill it.
4. Your wallpaper picks the palette.
5. Write on one, read on all. In under a second.
6. People who switched, in their words.
7. Free for your thoughts. Plus for your whole life.
   - Free · Plus · Teams
8. Frequently asked
9. Start your first note in ten seconds.
   - Product · Company · Support

Top-level page blocks (landmarks in DOM order):

| # | Element | Class | Label / heading |
| --- | --- | --- | --- |
| 1 | header | `top-bar` | – |
| 2 | nav | `rail` | Sections |
| 3 | section | `hero` | Every thought, neatly in its place. |
| 4 | section | `logos` | Teams using Pebble |
| 5 | section | `features` | Small tools that do one thing really well. |
| 6 | section | `write` | One note, four ways to fill it. |
| 7 | section | `dyn` | Your wallpaper picks the palette. |
| 8 | section | `sync` | Write on one, read on all. In under a second. |
| 9 | section | `voices` | People who switched, in their words. |
| 10 | section | `pricing` | Free for your thoughts. Plus for your whole life. |
| 11 | section | `faq` | Frequently asked |
| 12 | section | `cta` | Start your first note in ten seconds. |
| 13 | footer | `footer` | Product |

## Motion

- **Marquee / ticker:** no
- **Keyframe animations:** `md-spin`, `m3-spin`
- **CSS transitions:** 11
- **Client-side script (interactions / scripted motion):** yes
- **Respects prefers-reduced-motion:** yes

## Keep vs. replace

The mockup is a concept for Pebble Notes, a fictional brand. The design language (tokens, type, shape, rhythm, motion) is the reusable part; its name, copy, figures, people, logos, icons and illustrations are not.

**Design language (the signature traits above, plus):**

- The colour roles and their light/dark relationship (palette summary above)
- The type pairing: Roboto Flex Variable for headings and body
- The shape language: radii, shadow recipe, border weights and visual effects
- The page rhythm and density, and the motion character

**Brand-specific (replace for a real brand):**

- The fictional brand name, logo and logo mark
- All copy: headlines, body text, navigation labels, testimonials, FAQs, legal text
- All figures, prices, statistics, dates, locations and people
- Illustrations, icons, charts and imagery (they are illustrative stand-ins; commission or create originals for the client)
- Logo walls and partner names (invented companies)
- Colours, where the client already has brand colours: map them onto the same token roles (background, surface, text, muted, accent) and re-check contrast in both themes
- Section order and count, to match the client’s real content and goals

---

Part of [Design Atlas by H190K](https://designatlas.h190k.com/), a catalog of website design languages by Hasan Albehadili (H190K). Catalog index: https://designatlas.h190k.com/designs/index.json · Reference guide: https://designatlas.h190k.com/agents.md · LLM context: https://designatlas.h190k.com/llms.txt, https://designatlas.h190k.com/llms-full.txt. Generated 2026-11-16T02:13:46.191Z.
