WhatsApp Mobile — decoded design system
WhatsApp Mobile's design system, decoded live by Mozaika: measured color roles, type scale, buttons with real hover/focus states, motion and the brand's own tokens.
This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/decode/whatsapp.com.
Decoded design system
WhatsApp Mobile's decoded design system: background #FFFFFF, text #1C1E21, accent #005B5B, link #111B21, primary #005B5B; type scale h1 80px / h2 60px / body 18px; 8px spacing base; 12px base radius. The single interactive/action color is #25D366 — used only on interactive or must-notice elements (buttons, links, key highlights), never on large fills.
Color roles
| Role | Value |
|---|---|
| bg | #FFFFFF |
| surface | #F1F1F1 |
| border | #DCDDDD |
| text | #1C1E21 |
| text_muted | #727375 |
| primary | #005B5B |
| accent | #005B5B |
| link | #111B21 |
| button_bg | #25D366 |
| button_text | #1C1E21 |
Using these colors
- Action color
#25D366— the single interactive color; only on things you click or must notice, never large fills. primary,accentare all#005B5B— one role, not several (the action color).- accent
#005B5B— accent for emphasis — keep it rare on the page. - link
#111B21— inline text links and link-styled controls.
Typography
- Heading: WhatsApp Sans Var
- Body: WhatsApp Sans Var
- h1: 80px
- h2: 60px
- body: 18px
Spacing
- base unit: 8px
- scale: 4px, 6px, 8px, 13px, 16px, 20px, 24px, 28px, 32px, 40px
Radii
- base: 12px
- button: 50px
Motion
Micro-interactions run at 330ms (dominant) with cubic-bezier(0.33, 0, 0, 1).
- durations: 330ms · 1000ms · 500ms
- easings:
cubic-bezier(0.33, 0, 0, 1)·linear - animated properties: color, border-color, background-color
Button states (measured)
- primary focus: outline
1px auto rgb(16, 16, 16)
Layout (measured)
- container max-width:
1080px - nav: 80px fixed
- common grid: 2 columns
Motion choreography (measured)
Load order: div._wauiAnimationWrapper__c×4 → div._wauiAnimationWrapper__c×4
Scroll reveal: 10 elements rest at opacity 0, translateY(120px), animate in over 1s cubic-bezier(0.33, 0, 0, 1).
Responsive (measured)
- breakpoints: 520px · 768px · 1024px · 1096px · 1176px · 1200px
- mobile (390px): hero 44px · nav inline
Install it
Drop this measured system into any shadcn/Tailwind project in one command:
npx shadcn add mozaika.design/r/decode/whatsapp.com
Or as a Meta Astryx theme — a ready defineTheme file with the measured hover/press states baked in:
curl -o src/themes/whatsapp.theme.ts https://mozaika.design/api/astryx/decode/whatsapp.com.ts
registry item · astryx theme · or query it over MCP: get_design_system("WhatsApp Mobile")
Export: DESIGN.md
# WhatsApp Mobile — Design System > light, consumer, high — deep decode (measured live) ## Colors | Role | Value | |------|-------| | bg | `#FFFFFF` | | surface | `#F1F1F1` | | border | `#DCDDDD` | | text | `#1C1E21` | | text_muted | `#727375` | | primary | `#005B5B` | | accent | `#005B5B` | | link | `#111B21` | | button_bg | `#25D366` | | button_text | `#1C1E21` | **Using these colors** - **Action color** `#25D366` — the single interactive color; it appears only on things you click or must notice (buttons, key highlights), never on large fills or backgrounds. - `primary`, `accent` are all `#005B5B` — one role, not several. - **accent** `#005B5B` — accent for emphasis — keep it rare on the page. - **link** `#111B21` — inline text links and link-styled controls. - **Page coverage** (full-page screenshot pixels): `#FCF5EB` 32.6% · `#272C27` 22% · `#4D483D` 16.3% · `#7A634F` 15.7% ## Typography - Heading: **WhatsApp Sans Var** _(free fallback: Newsreader)_ - Body: **WhatsApp Sans Var** _(free fallback: Newsreader)_ | Role | Size / weight · line-height · tracking | |------|------------------------------------------| | hero | 80px / 400 · lh 80px | | h2 | 60px / 400 · lh 60px | | h3 | 48px / 400 · lh 48px | | body | 18px / 400 · lh 25px | | small | 16px / 500 · lh 16px | - Weight ladder: 400 · 500 — use these exact measured weights, not the 400/600 defaults. > **Fonts —** WhatsApp Sans Var may be proprietary — safe free fallback: Newsreader (Google Fonts). ## Spacing - base unit: 8px (inferred from the measured scale) - measured scale: 4px, 6px, 8px, 13px, 16px, 20px, 24px, 28px, 32px, 40px — snap all gaps/padding to these ## Radius - base: 12px - button: 50px - card: 50px ## Buttons | Button | Fill / text | Border | Radius | Padding | Font | Shadow | |--------|-------------|--------|--------|---------|------|--------| | primary | `#25D366` / `#1C1E21` | 1px solid rgb(28, 30, 33) | 50px | 16px 28px 16px 28px | 400 16px | none | | secondary | `#FFFFFF` / `#1C1E21` | 1px solid rgb(28, 30, 33) | 50px | 16px 28px 16px 28px | 400 16px | none | **States (measured, not guessed)** - primary focus: outline `1px auto rgb(16, 16, 16)` - transition: `color 0.33s linear` ## Motion - durations: 330ms (dominant) · 1000ms · 500ms - easings: `cubic-bezier(0.33, 0, 0, 1)` (dominant) · `linear` - animated properties: color, border-color, background-color Micro-interactions use the dominant duration + easing; nothing on the page animates slower than the longest duration above — don't invent springier motion. ## Layout (measured) - container max 1080px · common grid: 2-col - nav: 80px fixed · bg #FCF5EB | Section (y) | Height | Cols | Gap | Pad y | Split | |---|---|---|---|---|---| | 80 | 760 | — | — | 0/0 | — | | 840 | 291 | — | — | 0/0 | — | | 1131 | 304 | — | — | 0/0 | — | | 1435 | 266 | — | — | 0/0 | — | | 1701 | 802 | — | — | 0/0 | — | | 2503 | 620 | 2 | 32 | 0/0 | 58/42 | | 3123 | 846 | — | — | 0/0 | — | | 3969 | 826 | — | — | 0/0 | — | ## Motion choreography (measured) Load order: `div._wauiAnimationWrapper__c`×4 @0ms → `div._wauiAnimationWrapper__c`×4 @0ms - scroll reveal: 10 elements rest at opacity 0, translateY(120px), animate in over 1s cubic-bezier(0.33, 0, 0, 1) (10 revealed during the drive). Rebuild the timeline, not just the durations — order, delays and staggers above are the choreography. ## Components (measured) - link: #1C1E21 · no underline ## Responsive (measured) - breakpoints: 520px · 768px · 1024px · 1096px · 1176px · 1200px - mobile (390px): hero 44px · body 12px · nav: inline ## How to apply Paste the Tailwind `@theme` (or CSS variables) as your base, then build each section to its spec — verify every color, radius, and font against these tokens. Hover/focus states, shadows and motion timings above are measured from the live page — match them exactly, don't re-guess them. --- > **Decoded with Mozaika** — measured live, not guessed. Full decoded design system + one-command install: mozaika.design/decode/whatsapp.com
An automated reading of WhatsApp Mobile's publicly-visible CSS (colors, fonts, spacing, motion) — not affiliated with whatsapp.com. No screenshots stored. Removal requests: hello@mozaika.design.