# Duolingo — Design Reference
> candy-bright classroom on white paper

**Source:** https://www.duolingo.com  
**Theme:** light  
**Category:** SaaS  
**Mood:** light, playful, friendly, colourful, illustrated, bold  
**Captured:** 2026-11-07

## Overview

An unapologetically cheerful product marketing surface: pure white ground, one loud grass-green, and chunky rounded geometry everywhere. Illustration does the emotional work — flat 3D characters, flags and tumbling UI chips float in generous white space while the type stays small, bold and tightly set. Nothing is decorative for its own sake; every block is a single illustration, a short headline, and one green button.

Technically it runs on two in-house faces: duolingo-sans for headings, body and button labels (400/700 only), and the fatter display face 'feather' for the 48px section headlines in green. The palette is tiny — #ffffff ground, #4b4b4b headings, #777777 body copy, #e5e5e5 hairlines — so the brand green #58cc02 and link blue #1cb0f6 carry all the signal. Radii are a flat 16px on buttons and cards (12px on small chips), borders are 2px hairlines rather than shadows, button labels are uppercase 15px/700 at 0.8px tracking, and sections are separated by very large vertical gaps (80–101px) rather than rules.

## Tokens — Colors

| Name | Value | Token | Role |
|---|---|---|---|
| Paper White | `#ffffff` | `--color-background` | Page ground and card fill across every section; dominant surface by a huge margin. |
| Owl Green | `#58cc02` | `--color-primary` | Primary CTA fill, logo, section headlines in 'feather', and the big green footer wave. |
| Macaw Blue | `#1cb0f6` | `--color-accent` | Secondary button label, inline links, math-tile accents. |
| Eel Grey | `#4b4b4b` | `--color-foreground` | Headlines (h1, card titles) and any high-emphasis text. |
| Wolf Grey | `#777777` | `--color-muted-foreground` | Body paragraphs, learner counts, course-strip labels, nav language selector. |
| Hare Grey | `#afafaf` | `--color-placeholder` | Lowest-emphasis text: footnotes, disabled labels, chevrons. |
| Swan Hairline | `#e5e5e5` | `--color-border` | 2px borders on cards, secondary buttons and the course-strip divider — used instead of shadows. |
| Polar Wash | `#f7f7f7` | `--color-muted` | Faint tinted surface behind flag/icon tiles and hover states on cards. |
| Midnight Super | `#1f1b4d` | `--color-surface-inverse` | Full-bleed dark band for the Super Duolingo promo section. |
| Mask Red | `#ff4b4b` | `--color-destructive` | Error/streak red seen in illustration chips and form errors. |
| Bee Yellow | `#ffc800` | `--color-warning` | Coin/XP gold in illustrations; reserved for reward and warning states. |

### Semantic roles

| Role | Value |
|---|---|
| background | `#ffffff` |
| surface | `#f7f7f7` |
| surface raised | `#ffffff` |
| border | `#e5e5e5` |
| text | `#4b4b4b` |
| text muted | `#777777` |
| primary | `#58cc02` |
| primary text | `#ffffff` |
| accent | `#1cb0f6` |
| success | `#58cc02` |
| warning | `#ffc800` |
| danger | `#ff4b4b` |

## Tokens — Typography

- **Body:** duolingo-sans (400, 700) — fallbacks: Nunito, Baloo 2, Helvetica Neue, sans-serif. Does almost everything: h1 at 32px/700, card titles at 17px/700, body at 17px/400, uppercase 15px/700 button and nav labels. Rounded terminals, generous x-height, only two weights.
- **Display:** feather (700) — fallbacks: Baloo 2, Nunito, sans-serif. Fatter brand display face reserved for 48px lowercase section headlines ('free. fun. effective.') set in #58cc02. Never used for body.

| Role | Size | Line height | Weight | Letter spacing | Family |
|---|---|---|---|---|---|
| Display | 48px | 1.1 | 700 | normal | display |
| H1 | 32px | 1.25 | 700 | normal | body |
| H2 | 24px | 1.25 | 700 | normal | body |
| Card Title | 17px | 1.2 | 700 | normal | body |
| Body | 17px | 1.41 | 400 | normal | body |
| Meta | 17px | 1.15 | 400 | normal | body |
| Button / Label (uppercase) | 15px | 1.33 | 700 | 0.8px | body |
| Caption | 13px | 1.4 | 400 | normal | body |

## Tokens — Spacing & Layout

- **Base unit:** 4px
- **Density:** spacious
- **Container max width:** 1080px
- **Section gap:** 96px
- **Card padding:** 24px
- **Scale:** 4px, 8px, 12px, 16px, 24px, 40px, 48px, 80px, 96px

## Tokens — Radius

| Element | Value |
|---|---|
| Icon chip / flag tile | 12px |
| Button (primary & secondary) | 16px |
| Course card | 16px |
| Phone / promo panel art | 16px |

## Tokens — Shadows

| Name | Value | Usage |
|---|---|---|
| Button lip | `0 4px 0 0 #58a700` | The signature hard 'pressable' bottom edge on the primary green button; darker shade of the fill, no blur. |
| Ghost lip | `0 2px 0 0 #e5e5e5` | Same trick on the white secondary button, using the hairline grey. |
| None | `none` | Cards and nav carry no blur shadows at all — separation is done with 2px #e5e5e5 borders and whitespace. |

## Components

### Primary CTA (Get Started) (button)

| Property | Value |
|---|---|
| background | `#58cc02` |
| color | `#ffffff` |
| border | `none` |
| radius | `16px` |
| padding | `14px 24px` |
| font size | `15px` |
| font weight | `700` |
| shadow | `0 4px 0 0 #58a700` |
| hover | `background #61e002; active: translateY(2px) and shadow 0 2px 0 0 #58a700` |

Label is uppercase with 0.8px tracking. Full width of its column in the hero (≈320px) and 100% width on mobile.

### Secondary CTA (I already have an account) (button)

| Property | Value |
|---|---|
| background | `#ffffff` |
| color | `#1cb0f6` |
| border | `2px solid #e5e5e5` |
| radius | `16px` |
| padding | `14px 24px` |
| font size | `15px` |
| font weight | `700` |
| shadow | `0 2px 0 0 #e5e5e5` |
| hover | `background #f7f7f7` |

Identical geometry to the primary so the two stack as a matched pair with a 12px gap; blue text is the only colour.

### Course card (card)

| Property | Value |
|---|---|
| background | `#ffffff` |
| color | `#4b4b4b` |
| border | `2px solid #e5e5e5` |
| radius | `16px` |
| padding | `24px` |
| font size | `17px` |
| font weight | `700` |
| shadow | `none` |
| hover | `background #f7f7f7; border-color #d8d8d8` |

Square-ish tile: 12px-radius flag/icon on top, 17px/700 title in #4b4b4b, 17px/400 learner count in #777777. Laid out on a 4-up grid with 16–24px gutters.

### Top bar (nav)

| Property | Value |
|---|---|
| background | `#ffffff` |
| color | `#777777` |
| border | `none` |
| radius | `0` |
| padding | `20px 40px` |
| font size | `15px` |
| font weight | `700` |
| shadow | `none` |
| hover | `color #4b4b4b` |

Transparent/white, no border, no backdrop blur. Green wordmark left; right side is a single uppercase 'SITE LANGUAGE: ENGLISH' dropdown with a chevron. On scroll a compact green GET STARTED button appears at the right.

### Course strip item (badge)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#777777` |
| border | `none` |
| radius | `12px` |
| padding | `12px` |
| font size | `15px` |
| font weight | `700` |
| shadow | `none` |
| hover | `color #4b4b4b` |

Horizontal carousel under the hero, separated by a 1px #e5e5e5 rule top and bottom: 12px-radius flag icon + uppercase label with 0.8px tracking, chevron arrows at each end.

### Text input (input)

| Property | Value |
|---|---|
| background | `#f7f7f7` |
| color | `#4b4b4b` |
| border | `2px solid #e5e5e5` |
| radius | `12px` |
| padding | `12px 16px` |
| font size | `17px` |
| font weight | `400` |
| shadow | `none` |
| hover | `border-color #d8d8d8; focus: border-color #1cb0f6, placeholder #afafaf` |

Signup fields use the same chunky 2px hairline as cards; focus is a blue border rather than a glow ring.

### Inline link (link)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#1cb0f6` |
| border | `none` |
| radius | `0` |
| padding | `0` |
| font size | `17px` |
| font weight | `700` |
| shadow | `none` |
| hover | `text-decoration underline` |

Links inside body copy are bold blue, never underlined at rest (e.g. 'research shows that it works').

## Layout

Single centred column of roughly 1080px on a pure white page, no visible grid lines or section backgrounds. The hero is a 50/50 split: illustration left, 32px/700 headline plus two stacked full-width buttons right, centred vertically in a near-full-viewport block. Feature sections alternate illustration/text sides with ~96px of air between them and a 48px green 'feather' headline over a short 17px grey paragraph. Two full-bleed interruptions break the white: the midnight Super Duolingo band and the green footer, entered through a curved wave edge. The register page swaps to a 4-column card grid under a centred 32px headline.

## Imagery

Entirely illustration — no photography. Flat vector characters with simple geometric bodies, thick shapes, no outlines, rendered in saturated primaries (green, blue, pink, orange, purple) and arranged in loose isometric clusters that tumble off-axis. Supporting art: pseudo-3D phones, floating rounded app-icon chips, coins and gems. Flags are 12px-radius rounded rectangles sitting on faint grey tiles. Everything sits on white with no drop shadows beyond the illustrations' own flat ones.

## Motion

Playful and physical: buttons depress 2–4px on active, collapsing their hard bottom lip. Section illustrations fade and rise ~16px on scroll into view. The course strip scrolls horizontally with chevron controls and eased snapping. Keep durations short (150–250ms) with a slight overshoot easing; no parallax or long reveals.

## Responsive

At phone width the page becomes a single centred column with ~24px side padding. The nav drops the language selector entirely and centres the green wordmark alone at the top. The hero stacks: illustration first at roughly 70% of the viewport width, then the headline which grows in relative weight (32px over three tight lines, centred, #4b4b4b), then the two buttons as 100%-width blocks separated by 12px and pinned near the bottom of the first screen. Feature sections stop alternating and always run illustration-above-text, with section gaps compressing from ~96px to ~48px. The course card grid collapses from four to two columns; the horizontal course strip stays a swipeable row but loses its chevrons.

## Do

- Keep the ground pure #ffffff and let generous empty space, not boxes, define sections.
- Set all button and nav labels in UPPERCASE duolingo-sans 15px/700 with 0.8px letter-spacing.
- Give the primary green button a hard 4px bottom lip in #58a700 and no blur shadow; press it down on :active.
- Use 2px #e5e5e5 borders with 16px radius for cards and ghost buttons instead of elevation.
- Reserve the 48px 'feather' display face for lowercase green section headlines only.
- Pair every content block with one flat vector illustration; text blocks should be short — one headline plus two or three lines of #777777 body.

## Don't

- Don't put green on large background areas except the footer wave and the CTA fill — it loses its signal.
- Don't introduce blurred drop shadows, gradients or glass effects on cards and nav; the style is flat with hard edges.
- Don't use body text darker than #4b4b4b or lighter than #777777 for paragraphs — the grey ladder is only three steps.
- Don't use photography, stock imagery or outlined icon sets alongside the flat mascot illustrations.
- Don't set long-form copy in 'feather' or below 15px; body stays at 17px/1.41.
- Don't make radii inconsistent — 16px for buttons and cards, 12px for small icon chips, nothing in between.

## Agent prompt

> Build a bright, illustration-led SaaS marketing page in Duolingo's register: pure #ffffff ground with no section backgrounds, a single ~1080px centred column, and ~96px of vertical air between blocks. Typography is duolingo-sans (fallback Nunito) in only 400 and 700 — h1 32px/700/1.25 in #4b4b4b, card titles 17px/700, body 17px/1.41 in #777777, captions 13px, and all buttons/nav labels UPPERCASE 15px/700 with 0.8px letter-spacing; reserve a fatter display face ('feather', fallback Baloo 2) for 48px lowercase section headlines coloured #58cc02. Colour is minimal and loud: brand green #58cc02 (CTA fill, headlines, footer wave), link blue #1cb0f6 (secondary button label and inline bold links), greys #4b4b4b / #777777 / #afafaf, hairline #e5e5e5, faint surface #f7f7f7, plus #1f1b4d for one full-bleed dark promo band and #ff4b4b / #ffc800 as semantic red and gold. Shape language: 16px radius on buttons and cards, 12px on icon/flag chips, 2px solid #e5e5e5 borders instead of shadows, and the signature pressable primary button — #58cc02 fill, white uppercase label, 14px 24px padding, box-shadow 0 4px 0 0 #58a700, translating down 2px on :active; the secondary is the same geometry in white with a #e5e5e5 border and #1cb0f6 text. Hero is a 50/50 split (flat vector mascot cluster left, headline plus two stacked full-width buttons right) that stacks to one centred column with 100%-width buttons on mobile; use only flat, outline-free vector illustrations of characters, coins and floating rounded app chips — never photography. Motion is short and physical: 150–250ms, button depress, 16px fade-up on scroll.

## CSS custom properties

```css
/* Duolingo — CSS custom properties. Generated from style.json */
:root {
  /* Palette */
  --color-background: #ffffff; /* Page ground and card fill across every section; dominant surface by a huge margin. */
  --color-primary: #58cc02; /* Primary CTA fill, logo, section headlines in 'feather', and the big green footer wave. */
  --color-accent: #1cb0f6; /* Secondary button label, inline links, math-tile accents. */
  --color-foreground: #4b4b4b; /* Headlines (h1, card titles) and any high-emphasis text. */
  --color-muted-foreground: #777777; /* Body paragraphs, learner counts, course-strip labels, nav language selector. */
  --color-placeholder: #afafaf; /* Lowest-emphasis text: footnotes, disabled labels, chevrons. */
  --color-border: #e5e5e5; /* 2px borders on cards, secondary buttons and the course-strip divider — used instead of shadows. */
  --color-muted: #f7f7f7; /* Faint tinted surface behind flag/icon tiles and hover states on cards. */
  --color-surface-inverse: #1f1b4d; /* Full-bleed dark band for the Super Duolingo promo section. */
  --color-destructive: #ff4b4b; /* Error/streak red seen in illustration chips and form errors. */
  --color-warning: #ffc800; /* Coin/XP gold in illustrations; reserved for reward and warning states. */

  /* Semantic roles */
  --background: #ffffff;
  --surface: #f7f7f7;
  --surface-raised: #ffffff;
  --border: #e5e5e5;
  --text: #4b4b4b;
  --text-muted: #777777;
  --primary: #58cc02;
  --primary-text: #ffffff;
  --accent: #1cb0f6;
  --success: #58cc02;
  --warning: #ffc800;
  --danger: #ff4b4b;

  /* Typography */
  --font-body: duolingo-sans, Nunito, 'Baloo 2', 'Helvetica Neue', sans-serif;
  --font-display: feather, 'Baloo 2', Nunito, sans-serif;
  --text-display: 48px;
  --text-display--line-height: 1.1;
  --text-display--letter-spacing: normal;
  --text-display--font-weight: 700;
  --text-h1: 32px;
  --text-h1--line-height: 1.25;
  --text-h1--letter-spacing: normal;
  --text-h1--font-weight: 700;
  --text-h2: 24px;
  --text-h2--line-height: 1.25;
  --text-h2--letter-spacing: normal;
  --text-h2--font-weight: 700;
  --text-card-title: 17px;
  --text-card-title--line-height: 1.2;
  --text-card-title--letter-spacing: normal;
  --text-card-title--font-weight: 700;
  --text-body: 17px;
  --text-body--line-height: 1.41;
  --text-body--letter-spacing: normal;
  --text-body--font-weight: 400;
  --text-meta: 17px;
  --text-meta--line-height: 1.15;
  --text-meta--letter-spacing: normal;
  --text-meta--font-weight: 400;
  --text-button-label-uppercase: 15px;
  --text-button-label-uppercase--line-height: 1.33;
  --text-button-label-uppercase--letter-spacing: 0.8px;
  --text-button-label-uppercase--font-weight: 700;
  --text-caption: 13px;
  --text-caption--line-height: 1.4;
  --text-caption--letter-spacing: normal;
  --text-caption--font-weight: 400;

  /* Spacing */
  --space-1: 4px;
  --space-2: 8px;
  --space-3: 12px;
  --space-4: 16px;
  --space-5: 24px;
  --space-6: 40px;
  --space-7: 48px;
  --space-8: 80px;
  --space-9: 96px;
  --container: 1080px;
  --section-gap: 96px;

  /* Radius */
  --radius-icon-chip-flag-tile: 12px;
  --radius-button-primary-secondary: 16px;
  --radius-course-card: 16px;
  --radius-phone-promo-panel-art: 16px;

  /* Shadows */
  --shadow-button-lip: 0 4px 0 0 #58a700;
  --shadow-ghost-lip: 0 2px 0 0 #e5e5e5;
  --shadow-none: none;
}
```

## Tailwind v4 theme

```css
/* Duolingo — Tailwind CSS v4 theme. Import after tailwindcss: @import "tailwindcss"; then paste this block. */
@theme {
  --color-background: #ffffff;
  --color-primary: #58cc02;
  --color-accent: #1cb0f6;
  --color-foreground: #4b4b4b;
  --color-muted-foreground: #777777;
  --color-placeholder: #afafaf;
  --color-border: #e5e5e5;
  --color-muted: #f7f7f7;
  --color-surface-inverse: #1f1b4d;
  --color-destructive: #ff4b4b;
  --color-warning: #ffc800;
  --color-background: #ffffff;
  --color-surface: #f7f7f7;
  --color-surface-raised: #ffffff;
  --color-border: #e5e5e5;
  --color-text: #4b4b4b;
  --color-text-muted: #777777;
  --color-primary: #58cc02;
  --color-primary-text: #ffffff;
  --color-accent: #1cb0f6;
  --color-success: #58cc02;
  --color-warning: #ffc800;
  --color-danger: #ff4b4b;
  --font-body: duolingo-sans, Nunito, 'Baloo 2', 'Helvetica Neue', sans-serif;
  --font-display: feather, 'Baloo 2', Nunito, sans-serif;
  --text-display: 48px;
  --text-display--line-height: 1.1;
  --text-display--letter-spacing: normal;
  --text-display--font-weight: 700;
  --text-h1: 32px;
  --text-h1--line-height: 1.25;
  --text-h1--letter-spacing: normal;
  --text-h1--font-weight: 700;
  --text-h2: 24px;
  --text-h2--line-height: 1.25;
  --text-h2--letter-spacing: normal;
  --text-h2--font-weight: 700;
  --text-card-title: 17px;
  --text-card-title--line-height: 1.2;
  --text-card-title--letter-spacing: normal;
  --text-card-title--font-weight: 700;
  --text-body: 17px;
  --text-body--line-height: 1.41;
  --text-body--letter-spacing: normal;
  --text-body--font-weight: 400;
  --text-meta: 17px;
  --text-meta--line-height: 1.15;
  --text-meta--letter-spacing: normal;
  --text-meta--font-weight: 400;
  --text-button-label-uppercase: 15px;
  --text-button-label-uppercase--line-height: 1.33;
  --text-button-label-uppercase--letter-spacing: 0.8px;
  --text-button-label-uppercase--font-weight: 700;
  --text-caption: 13px;
  --text-caption--line-height: 1.4;
  --text-caption--letter-spacing: normal;
  --text-caption--font-weight: 400;
  --radius-icon-chip-flag-tile: 12px;
  --radius-button-primary-secondary: 16px;
  --radius-course-card: 16px;
  --radius-phone-promo-panel-art: 16px;
  --shadow-button-lip: 0 4px 0 0 #58a700;
  --shadow-ghost-lip: 0 2px 0 0 #e5e5e5;
  --shadow-none: none;
  --container-site: 1080px;
}
```

## Theme tokens — light + dark

The shadcn-named layer DevDojo Sites speaks (`bg-background`, `text-foreground`, `bg-primary`, `rounded-medium`…). Paste into site.css after `@import "tailwindcss"` to restyle any site in this look.

```css
/* Duolingo — DevDojo theme tokens (light + dark). Generated from style.json. */
/* Drop into site.css after @import "tailwindcss": bg-background, text-foreground, bg-primary, border-border, rounded-medium… all read these. Dark mode: estimated — the site has no dark scheme, so the .dark half is a plausible twin of its palette. */
@custom-variant dark (&:where(.dark, .dark *));

:root {
    color-scheme: light;

    --background: #ffffff;
    --foreground: #4b4b4b;
    --card: #ffffff;
    --card-foreground: #4b4b4b;
    --popover: #ffffff; /* estimated */
    --popover-foreground: #4b4b4b; /* estimated */
    --primary: #58cc02;
    --primary-foreground: #ffffff;
    --secondary: #f7f7f7; /* estimated */
    --secondary-foreground: #4b4b4b;
    --muted: #f7f7f7; /* estimated */
    --muted-foreground: #777777;
    --accent: #1cb0f6;
    --accent-foreground: #ffffff; /* estimated */
    --destructive: #ff4b4b; /* estimated */
    --destructive-foreground: #ffffff; /* estimated */
    --border: #e5e5e5;
    --input: #e5e5e5;
    --ring: #1cb0f6; /* estimated */

    --radius-small: 12px;
    --radius-medium: 16px;
    --radius-large: 16px;
    --radius: var(--radius-medium);

    --font-body: duolingo-sans, Nunito, 'Baloo 2', 'Helvetica Neue', sans-serif;
    --font-display: feather, 'Baloo 2', Nunito, sans-serif;
}

.dark {
    color-scheme: dark;
    /* estimated from the light palette */

    --background: #1f1b4d;
    --foreground: #ffffff;
    --card: #2b2660;
    --card-foreground: #ffffff;
    --popover: #2b2660;
    --popover-foreground: #ffffff;
    --primary: #58cc02;
    --primary-foreground: #ffffff;
    --secondary: #2b2660;
    --secondary-foreground: #e5e5e5;
    --muted: #2b2660;
    --muted-foreground: #afafaf;
    --accent: #1cb0f6;
    --accent-foreground: #1f1b4d;
    --destructive: #ff4b4b;
    --destructive-foreground: #ffffff;
    --border: rgba(255,255,255,0.16);
    --input: rgba(255,255,255,0.16);
    --ring: #1cb0f6;
}

@theme inline {
    --color-background: var(--background);
    --color-foreground: var(--foreground);
    --color-card: var(--card);
    --color-card-foreground: var(--card-foreground);
    --color-popover: var(--popover);
    --color-popover-foreground: var(--popover-foreground);
    --color-primary: var(--primary);
    --color-primary-foreground: var(--primary-foreground);
    --color-secondary: var(--secondary);
    --color-secondary-foreground: var(--secondary-foreground);
    --color-muted: var(--muted);
    --color-muted-foreground: var(--muted-foreground);
    --color-accent: var(--accent);
    --color-accent-foreground: var(--accent-foreground);
    --color-destructive: var(--destructive);
    --color-destructive-foreground: var(--destructive-foreground);
    --color-border: var(--border);
    --color-input: var(--input);
    --color-ring: var(--ring);
    --radius-small: var(--radius-small);
    --radius-medium: var(--radius-medium);
    --radius-large: var(--radius-large);
    --font-body: var(--font-body);
    --font-display: var(--font-display);
}
```
