Bold & expressive · Education
Neo Memphis design system template
Playful Memphis geometry for kids and education: chunky Fredoka headlines, thick ink outlines, hard offset shadows and a confetti palette of tomato, sun yellow, mint and sky. Built for learning apps, school tools and family products.
- WCAG AA verified
- Light + dark
- Tokens = preview
- Fredoka
Level 4 · Fractions
Pizza time: share it fairly
Cut the pizza into equal slices and feed the hungry robots.
Every lesson is a five-minute game with a clear goal and a sticker at the end.
No ads, no chat with strangers, and a parent dashboard for screen time.
Aligned to the curriculum for ages 5 to 10 in maths, reading and science.
Personality. Neo Memphis is a classroom wall rather than a lecture hall. Every surface is outlined in a 2.5px ink stroke and lifted by a hard, un-blurred offset shadow, so buttons and cards look like cut-out stickers. Fredoka headlines are round and friendly, Nunito body text stays readable for early readers, and the palette is four saturated confetti colors on warm cream. Squiggles, dots, triangles and half-circles are used as decoration, always behind content and never in the reading path. Dark mode becomes a night-sky indigo with the same sticker outlines in cream.
2.5px ink outlines on every interactive surface with a 4px hard offset shadow and zero blur
Sticker press: buttons travel 4px down-right on press until the shadow disappears
Memphis confetti shapes (squiggle, dots, triangle, half-circle) scattered behind hero and empty states
Each subject owns a color: maths tomato, reading sun yellow, science mint, art sky
Rounded Fredoka headlines at weight 600 with a slight -0.01em tracking
Color. 21 roles, both modes.
background
#fff6df
foreground
#1b1530
card
#ffffff
cardForeground
#1b1530
muted
#ffeabd
mutedForeground
#5b4f66
primary
#d62839
primaryForeground
#ffffff
secondary
#b9e8d6
secondaryForeground
#0f3a2d
accent
#ffd23f
accentForeground
#1b1530
border
#1b1530
input
#1b1530
ring
#2b59d9
destructive
#a8182a
destructiveForeground
#ffffff
success
#0e7a54
successForeground
#ffffff
warning
#ffb020
warningForeground
#241800
Type. Fredoka · Nunito · Space Mono
The file. Drop it in your repo.
1---2name: "Neo Memphis"3slug: "neo-memphis"4schema: "freedesignmd/v2"5description: "Playful Memphis geometry for kids and education: chunky Fredoka headlines, thick ink outlines, hard offset shadows and a confetti palette of tomato, sun yellow, mint and sky. Built for learning apps, school tools and family products."6source: "https://freedesignmd.com/system/neo-memphis"7aesthetic: "expressive"8industry: "education"9default_mode: "light"10fonts:11 display: "Fredoka"12 body: "Nunito"13 mono: "Space Mono"14 google_fonts_url: "https://fonts.googleapis.com/css2?family=Fredoka:wght@500;600;700&family=Nunito:wght@400;600;700&family=Space+Mono:wght@400;700&display=swap"15colors:16 light:17 background: "#fff6df"18 foreground: "#1b1530"19 card: "#ffffff"20 cardForeground: "#1b1530"21 muted: "#ffeabd"22 mutedForeground: "#5b4f66"23 primary: "#d62839"24 primaryForeground: "#ffffff"25 secondary: "#b9e8d6"26 secondaryForeground: "#0f3a2d"27 accent: "#ffd23f"28 accentForeground: "#1b1530"29 border: "#1b1530"30 input: "#1b1530"31 ring: "#2b59d9"32 destructive: "#a8182a"33 destructiveForeground: "#ffffff"34 success: "#0e7a54"35 successForeground: "#ffffff"36 warning: "#ffb020"37 warningForeground: "#241800"38 dark:39 background: "#1c1740"40 foreground: "#fff3d6"41 card: "#2a2360"42 cardForeground: "#fff3d6"43 muted: "#352d78"44 mutedForeground: "#cdc3ee"45 primary: "#ff6b7a"46 primaryForeground: "#2a0610"47 secondary: "#2d6b5c"48 secondaryForeground: "#e2fff3"49 accent: "#ffd23f"50 accentForeground: "#1b1530"51 border: "#fff3d6"52 input: "#fff3d6"53 ring: "#7fb2ff"54 destructive: "#ff8b94"55 destructiveForeground: "#2e0508"56 success: "#4fdca5"57 successForeground: "#042418"58 warning: "#ffc54d"59 warningForeground: "#241800"60chart:61 light: ["#d62839", "#ffb020", "#1fa584", "#2b59d9", "#8a4fd6"]62 dark: ["#ff6b7a", "#ffc54d", "#4fdca5", "#7fb2ff", "#c39bff"]63type:64 display: { font: display, size: 80, size_mobile: 45, leading: 1, weight: 700, tracking: "-0.01em" }65 h1: { font: display, size: 52, size_mobile: 35, leading: 1.05, weight: 600, tracking: "-0.01em" }66 h2: { font: display, size: 34, size_mobile: 27, leading: 1.15, weight: 600, tracking: "0em" }67 h3: { font: display, size: 22, size_mobile: 22, leading: 1.25, weight: 600, tracking: "0em" }68 body: { font: body, size: 17, size_mobile: 17, leading: 1.6, weight: 400, tracking: "0em" }69 small: { font: body, size: 15, size_mobile: 15, leading: 1.5, weight: 600, tracking: "0em" }70 label: { font: body, size: 13, size_mobile: 13, leading: 1.3, weight: 700, tracking: "0.04em", uppercase: true }71 mono: { font: mono, size: 13, size_mobile: 13, leading: 1.5, weight: 400, tracking: "0em" }72spacing: [4, 8, 12, 16, 24, 32, 40, 56, 80, 112]73radius: { sm: "8px", md: "14px", lg: "20px", xl: "28px", full: "9999px" }74shadow:75 light:76 sm: "3px 3px 0 #1b1530"77 md: "5px 5px 0 #1b1530"78 lg: "8px 8px 0 #1b1530"79 dark:80 sm: "3px 3px 0 #0d0a26"81 md: "5px 5px 0 #0d0a26"82 lg: "8px 8px 0 #0d0a26"83motion:84 duration_ms: { instant: 80, fast: 140, base: 240, slow: 520 }85 easing: { standard: "cubic-bezier(0.3, 0, 0.2, 1)", out: "cubic-bezier(0.34, 1.56, 0.64, 1)", in: "cubic-bezier(0.5, 0, 1, 1)" }86 reveal: { distance_px: 20, stagger_ms: 70 }87layout: { max_width: 1140, columns: 12, gutter: 24, section_y: 96, section_y_mobile: 56, measure: "56ch" }88---89 90# Neo Memphis, DESIGN.md91 92> Playful Memphis geometry for kids and education: chunky Fredoka headlines, thick ink outlines, hard offset shadows and a confetti palette of tomato, sun yellow, mint and sky. Built for learning apps, school tools and family products.93 94## How to use this file95 961. Save this file as `DESIGN.md` in the project root and paste the `tokens.css` block (section 10) into your global stylesheet, or import `https://freedesignmd.com/system/neo-memphis.css`, which also contains every component class.972. **Claude Code:** add `Before any UI work, read @DESIGN.md and use only its tokens and component recipes.` to `CLAUDE.md`.983. **Cursor:** create `.cursor/rules/design.mdc` with `alwaysApply: true` and the line `Follow @DESIGN.md for every color, font, radius, shadow, spacing and duration.`994. **Lovable:** paste section 10 into `src/index.css` and add this file to Project Knowledge; ask for changes by role name (`primary`, `muted-foreground`), never by hex.1005. Default mode is **light**: dark mode is `class="dark"` on `<html>` (both modes are fully specified). Use semantic names only (`bg-primary`, `text-muted-foreground`, `.btn-primary`, `var(--radius-lg)`); if a value is not in this file, it does not belong in the UI.101 102## 1. Overview & personality103 104Neo Memphis is a classroom wall rather than a lecture hall. Every surface is outlined in a 2.5px ink stroke and lifted by a hard, un-blurred offset shadow, so buttons and cards look like cut-out stickers. Fredoka headlines are round and friendly, Nunito body text stays readable for early readers, and the palette is four saturated confetti colors on warm cream. Squiggles, dots, triangles and half-circles are used as decoration, always behind content and never in the reading path. Dark mode becomes a night-sky indigo with the same sticker outlines in cream.105 106**At a glance**107 108- Aesthetic: Bold & expressive · Industry: Education · Default mode: light109- Type: Fredoka (display) · Nunito (body) · Space Mono (mono)110- Brand color (`primary`): `#d62839` light · `#ff6b7a` dark, on primary, text is `#ffffff` / `#2a0610`111- Corners: 8px / 14px / 20px / 28px · Container 1140px · Base motion 240ms112 113**Signature moves**114 115- 2.5px ink outlines on every interactive surface with a 4px hard offset shadow and zero blur116- Sticker press: buttons travel 4px down-right on press until the shadow disappears117- Memphis confetti shapes (squiggle, dots, triangle, half-circle) scattered behind hero and empty states118- Each subject owns a color: maths tomato, reading sun yellow, science mint, art sky119- Rounded Fredoka headlines at weight 600 with a slight -0.01em tracking120 121## 2. Color122 123Roles follow shadcn/ui naming, so `primary` is always the brand / main-action color and `foreground` is always body text. Every text pair below is WCAG AA (≥ 4.5:1) in both modes.124 125### Light mode (`:root`)126 127| Role | CSS variable | Value | Contrast | Usage |128|---|---|---|---|---|129| `background` | `--background` | `#fff6df` | | Page canvas |130| `foreground` | `--foreground` | `#1b1530` | 16.30:1 on background | Body text and headings on background |131| `card` | `--card` | `#ffffff` | | Cards, panels, popovers |132| `cardForeground` | `--card-foreground` | `#1b1530` | 17.55:1 on card | Text on card |133| `muted` | `--muted` | `#ffeabd` | | Subtle fills: table headers, code, skeletons |134| `mutedForeground` | `--muted-foreground` | `#5b4f66` | 6.44:1 on muted | Secondary text, captions, placeholders |135| `primary` | `--primary` | `#d62839` | | Brand color: primary buttons, links, focus, active states |136| `primaryForeground` | `--primary-foreground` | `#ffffff` | 4.97:1 on primary | Text and icons on primary |137| `secondary` | `--secondary` | `#b9e8d6` | | Secondary buttons and quiet fills |138| `secondaryForeground` | `--secondary-foreground` | `#0f3a2d` | 9.36:1 on secondary | Text on secondary |139| `accent` | `--accent` | `#ffd23f` | | Hover and selected backgrounds (rows, menu items, ghost buttons) |140| `accentForeground` | `--accent-foreground` | `#1b1530` | 12.15:1 on accent | Text on accent |141| `border` | `--border` | `#1b1530` | | Dividers and card outlines |142| `input` | `--input` | `#1b1530` | | Input borders |143| `ring` | `--ring` | `#2b59d9` | | Focus ring |144| `destructive` | `--destructive` | `#a8182a` | | Errors and destructive actions |145| `destructiveForeground` | `--destructive-foreground` | `#ffffff` | 7.42:1 on destructive | Text on destructive |146| `success` | `--success` | `#0e7a54` | | Positive status |147| `successForeground` | `--success-foreground` | `#ffffff` | 5.34:1 on success | Text on success |148| `warning` | `--warning` | `#ffb020` | | Caution status |149| `warningForeground` | `--warning-foreground` | `#241800` | 9.52:1 on warning | Text on warning |150| `chart-1…5` | `--chart-1…5` | `#d62839` `#ffb020` `#1fa584` `#2b59d9` `#8a4fd6` | | Data series, in this order |151 152### Dark mode (`.dark`)153 154| Role | CSS variable | Value | Contrast | Usage |155|---|---|---|---|---|156| `background` | `--background` | `#1c1740` | | Page canvas |157| `foreground` | `--foreground` | `#fff3d6` | 15.28:1 on background | Body text and headings on background |158| `card` | `--card` | `#2a2360` | | Cards, panels, popovers |159| `cardForeground` | `--card-foreground` | `#fff3d6` | 12.63:1 on card | Text on card |160| `muted` | `--muted` | `#352d78` | | Subtle fills: table headers, code, skeletons |161| `mutedForeground` | `--muted-foreground` | `#cdc3ee` | 7.03:1 on muted | Secondary text, captions, placeholders |162| `primary` | `--primary` | `#ff6b7a` | | Brand color: primary buttons, links, focus, active states |163| `primaryForeground` | `--primary-foreground` | `#2a0610` | 6.75:1 on primary | Text and icons on primary |164| `secondary` | `--secondary` | `#2d6b5c` | | Secondary buttons and quiet fills |165| `secondaryForeground` | `--secondary-foreground` | `#e2fff3` | 5.89:1 on secondary | Text on secondary |166| `accent` | `--accent` | `#ffd23f` | | Hover and selected backgrounds (rows, menu items, ghost buttons) |167| `accentForeground` | `--accent-foreground` | `#1b1530` | 12.15:1 on accent | Text on accent |168| `border` | `--border` | `#fff3d6` | | Dividers and card outlines |169| `input` | `--input` | `#fff3d6` | | Input borders |170| `ring` | `--ring` | `#7fb2ff` | | Focus ring |171| `destructive` | `--destructive` | `#ff8b94` | | Errors and destructive actions |172| `destructiveForeground` | `--destructive-foreground` | `#2e0508` | 8.21:1 on destructive | Text on destructive |173| `success` | `--success` | `#4fdca5` | | Positive status |174| `successForeground` | `--success-foreground` | `#042418` | 9.53:1 on success | Text on success |175| `warning` | `--warning` | `#ffc54d` | | Caution status |176| `warningForeground` | `--warning-foreground` | `#241800` | 11.07:1 on warning | Text on warning |177| `chart-1…5` | `--chart-1…5` | `#ff6b7a` `#ffc54d` `#4fdca5` `#7fb2ff` `#c39bff` | | Data series, in this order |178 179## 3. Typography180 181Load fonts with:182 183```html184<link rel="preconnect" href="https://fonts.googleapis.com" />185<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />186<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Fredoka:wght@500;600;700&family=Nunito:wght@400;600;700&family=Space+Mono:wght@400;700&display=swap" />187```188 189| Role | Font | Size (390px → 1440px) | Line height | Weight | Tracking | Style | Class |190|---|---|---|---|---|---|---|---|191| `display` | Fredoka | 45px → 80px | 1 | 700 | -0.01em | – | `.type-display` |192| `h1` | Fredoka | 35px → 52px | 1.05 | 600 | -0.01em | – | `.type-h1` |193| `h2` | Fredoka | 27px → 34px | 1.15 | 600 | 0em | – | `.type-h2` |194| `h3` | Fredoka | 22px | 1.25 | 600 | 0em | – | `.type-h3` |195| `body` | Nunito | 17px | 1.6 | 400 | 0em | – | `.type-body` |196| `small` | Nunito | 15px | 1.5 | 600 | 0em | – | `.type-small` |197| `label` | Nunito | 13px | 1.3 | 700 | 0.04em | uppercase | `.type-label` |198| `mono` | Space Mono | 13px | 1.5 | 400 | 0em | – | `.type-mono` |199 200- `h1`–`h3` elements map to the roles of the same name; `display` is for one hero headline per page.201- Fluid sizes use `clamp()` between the two values (see `--type-*-size` in tokens.css).202- Only the weights in this table are loaded; never use other weights.203 204## 4. Spacing & layout205 206Spacing is a 4px scale. Use these steps only (`--space-N` = N × 4px):207 208| Token | `--space-1` | `--space-2` | `--space-3` | `--space-4` | `--space-6` | `--space-8` | `--space-10` | `--space-14` | `--space-20` | `--space-28` |209|---|---|---|---|---|---|---|---|---|---|---|210| px | 4 | 8 | 12 | 16 | 24 | 32 | 40 | 56 | 80 | 112 |211 212- Container: max 1140px, 24px side gutters (`.container`).213- Grid: 12 columns, 24px gap.214- Sections: 96px vertical padding on desktop, 56px on mobile (`.section`).215- Long text: max 56ch per line (`.prose`).216- Content sits in 1140px with confetti shapes allowed to bleed 80px outside the container.217- Lesson screens are one task per screen: a 560px column with a progress bar pinned at the top.218- Cards tilt between -1.5deg and 1.5deg in grids of three; tilt resets on hover.219 220## 5. Shape & elevation221 222| Radius | Value | Use |223|---|---|---|224| `--radius-sm` | 8px | badges, checkboxes, small chips |225| `--radius-md` | 14px | buttons, inputs, tabs (= shadcn `--radius`) |226| `--radius-lg` | 20px | cards, panels, menus |227| `--radius-xl` | 28px | dialogs, hero media, large surfaces |228| `--radius-full` | 9999px | avatars, pills, toggles |229 230| Shadow | Mode | Value |231|---|---|---|232| `--shadow-sm` | light | `3px 3px 0 #1b1530` |233| `--shadow-md` | light | `5px 5px 0 #1b1530` |234| `--shadow-lg` | light | `8px 8px 0 #1b1530` |235| `--shadow-sm` | dark | `3px 3px 0 #0d0a26` |236| `--shadow-md` | dark | `5px 5px 0 #0d0a26` |237| `--shadow-lg` | dark | `8px 8px 0 #0d0a26` |238 239`sm` = resting card · `md` = hover / raised · `lg` = dialogs and popovers. Nothing else casts a shadow.240 241## 6. Motion242 243**Sticker pop.** Elements land like stickers: scale from 0.92 to 1 with a small overshoot on the `out` curve, while confetti shapes drift 6px over `slow`. Buttons press by moving 4px down-right as their hard shadow collapses.244 245| Token | Value | Use |246|---|---|---|247| `--duration-instant` | 80ms | press feedback, toggles |248| `--duration-fast` | 140ms | hover, focus, color changes |249| `--duration-base` | 240ms | menus, tabs, popovers, cards lifting |250| `--duration-slow` | 520ms | dialogs and scroll reveals |251| `--ease-standard` | `cubic-bezier(0.3, 0, 0.2, 1)` | state changes |252| `--ease-out` | `cubic-bezier(0.34, 1.56, 0.64, 1)` | entrances and reveals |253| `--ease-in` | `cubic-bezier(0.5, 0, 1, 1)` | exits |254 255- Scroll reveal (`.reveal` → `.reveal.is-in` via IntersectionObserver): rise 20px and fade over `--duration-slow` with `--ease-out`; siblings stagger by 70ms (`--reveal-index`).256- Use no durations other than the four above.257- `prefers-reduced-motion: reduce` → no transforms, reveals show immediately (included in tokens.css).258 259## 7. Components260 261Every component reads only variables from section 10, so light and dark mode work with no extra code. These are the exact rules (also in `https://freedesignmd.com/system/neo-memphis.css`). In React/shadcn projects, put the same declarations on the matching shadcn component variants.262 263### Button264 265```html266<button class="btn btn-primary">Save</button> <!-- btn-secondary · btn-outline · btn-ghost -->267```268 269```css270.btn {271 display: inline-flex;272 align-items: center;273 justify-content: center;274 gap: 8px;275 height: 52px;276 padding: 0 26px;277 font-family: var(--font-display);278 font-size: 18px;279 font-weight: 600;280 letter-spacing: 0em;281 border-radius: var(--radius-full);282 border: 2.5px solid var(--foreground);283 white-space: nowrap;284 cursor: pointer;285 text-decoration: none;286 transition: background-color var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard), color var(--duration-fast) var(--ease-standard), box-shadow var(--duration-fast) var(--ease-standard), transform var(--duration-fast) var(--ease-standard);287}288.btn-primary {289 background: var(--primary);290 color: var(--primary-foreground);291 box-shadow: var(--shadow-sm);292}293.btn-primary:hover:not(:disabled) {294 transform: translate(-1px, -1px);295 box-shadow: 5px 5px 0 var(--foreground);296}297.btn-primary:active:not(:disabled) {298 transform: translate(3px, 3px);299 box-shadow: 0 0 0 var(--foreground);300}301.btn-secondary {302 background: var(--accent);303 color: var(--accent-foreground);304 box-shadow: var(--shadow-sm);305}306.btn-secondary:hover:not(:disabled) {307 transform: translate(-1px, -1px);308 box-shadow: 5px 5px 0 var(--foreground);309}310.btn-secondary:active:not(:disabled) {311 transform: translate(3px, 3px);312 box-shadow: 0 0 0 var(--foreground);313}314.btn-outline {315 background: var(--card);316 color: var(--foreground);317 box-shadow: var(--shadow-sm);318}319.btn-outline:hover:not(:disabled) {320 background: var(--secondary);321 color: var(--secondary-foreground);322}323.btn-outline:active:not(:disabled) {324 transform: translate(3px, 3px);325 box-shadow: 0 0 0 var(--foreground);326}327.btn-ghost {328 background: transparent;329 color: var(--foreground);330 border-color: transparent;331}332.btn-ghost:hover:not(:disabled) {333 background: var(--muted);334 border-color: var(--foreground);335}336.btn-ghost:active:not(:disabled) {337 background: var(--accent);338}339.btn:focus-visible {340 outline: 3px solid var(--ring);341 outline-offset: 4px;342}343.btn:disabled, .btn[aria-disabled="true"] {344 opacity: 0.5;345 cursor: not-allowed;346 box-shadow: none;347 transform: none;348}349```350 351### Input352 353```html354<input class="input" placeholder="you@company.com" /> <!-- aria-invalid="true" for errors -->355```356 357```css358.input {359 display: block;360 width: 100%;361 height: 52px;362 padding: 0 18px;363 font-family: var(--font-sans);364 font-size: 17px;365 color: var(--foreground);366 background: var(--card);367 border: 2.5px solid var(--input);368 border-radius: var(--radius-md);369 outline: none;370 transition: border-color var(--duration-fast) var(--ease-standard), box-shadow var(--duration-fast) var(--ease-standard), background-color var(--duration-fast) var(--ease-standard);371}372.input::placeholder {373 color: var(--muted-foreground);374 opacity: 1;375}376.input:hover:not(:disabled):not(:focus) {377 border-color: var(--primary);378}379.input:focus, .input:focus-visible {380 border-color: var(--ring);381 box-shadow: 4px 4px 0 var(--ring);382}383.input[aria-invalid="true"] {384 border-color: var(--destructive);385 box-shadow: 0 0 0 3px color-mix(in oklab, var(--destructive) 22%, transparent);386}387.input:disabled {388 opacity: 0.5;389 cursor: not-allowed;390 background: var(--muted);391}392```393 394### Card395 396```html397<article class="card">…</article> <!-- add card-interactive when the whole card is a link -->398```399 400```css401.card {402 background: var(--card);403 color: var(--card-foreground);404 border: 2.5px solid var(--border);405 border-radius: var(--radius-lg);406 box-shadow: var(--shadow-md);407 padding: 24px;408 transition: border-color var(--duration-base) var(--ease-out), box-shadow var(--duration-base) var(--ease-out), transform var(--duration-base) var(--ease-out), background-color var(--duration-base) var(--ease-out);409}410.card-interactive:hover {411 transform: translate(-2px, -2px) rotate(-0.5deg);412 box-shadow: var(--shadow-lg);413}414```415 416### Badge417 418```html419<span class="badge badge-soft" data-tone="success">Paid</span> <!-- badge-solid · badge-outline; tones: primary (default) · success · warning · destructive -->420```421 422```css423.badge {424 --tone: var(--primary);425 --tone-foreground: var(--primary-foreground);426 display: inline-flex;427 align-items: center;428 gap: 6px;429 height: 28px;430 padding: 0 12px;431 border-radius: var(--radius-full);432 font-family: var(--font-sans);433 font-size: 12px;434 font-weight: 700;435 letter-spacing: 0.04em;436 text-transform: uppercase;437 line-height: 1;438 white-space: nowrap;439}440.badge[data-tone="success"] {441 --tone: var(--success);442 --tone-foreground: var(--success-foreground);443}444.badge[data-tone="warning"] {445 --tone: var(--warning);446 --tone-foreground: var(--warning-foreground);447}448.badge[data-tone="destructive"] {449 --tone: var(--destructive);450 --tone-foreground: var(--destructive-foreground);451}452.badge-solid {453 background: var(--tone);454 color: var(--tone-foreground);455 border: 1px solid var(--tone);456}457.badge-soft {458 background: color-mix(in oklab, var(--tone) 24%, var(--card));459 color: var(--foreground);460 border: 1px solid color-mix(in oklab, var(--tone) 40%, transparent);461}462.badge-outline {463 background: transparent;464 color: var(--foreground);465 border: 1px solid var(--border);466}467```468 469### Navigation bar470 471```html472<nav class="nav"><a class="nav-link" aria-current="page">Home</a><a class="nav-link">Docs</a></nav>473```474 475```css476.nav {477 display: flex;478 align-items: center;479 gap: 4px;480 height: 72px;481 padding: 0 24px;482 background: var(--background);483 border-bottom: 2.5px solid var(--foreground);484}485.nav-link {486 padding: 6px 12px;487 border-radius: var(--radius-full);488 font-family: var(--font-display);489 font-size: 16px;490 font-weight: 600;491 letter-spacing: 0em;492 color: var(--muted-foreground);493 text-decoration: none;494 transition: color var(--duration-fast) var(--ease-standard), background-color var(--duration-fast) var(--ease-standard), border-color var(--duration-fast) var(--ease-standard);495}496.nav-link:hover {497 color: var(--foreground);498 background: var(--muted);499}500.nav-link[aria-current="page"] {501 color: var(--primary-foreground);502 background: var(--primary);503}504```505 506### Tabs507 508```html509<div class="tabs" role="tablist"><button class="tab" role="tab" aria-selected="true">Overview</button>…</div>510```511 512```css513.tabs {514 display: flex;515 gap: 8px;516}517.tab {518 height: 44px;519 padding: 0 16px;520 border: 2px solid var(--foreground);521 border-radius: 0;522 background: var(--card);523 color: var(--foreground);524 cursor: pointer;525 font-family: var(--font-display);526 font-size: 16px;527 font-weight: 600;528 letter-spacing: 0em;529 transition: color var(--duration-base) var(--ease-standard), background-color var(--duration-base) var(--ease-standard), border-color var(--duration-base) var(--ease-standard), box-shadow var(--duration-base) var(--ease-standard);530}531.tab:hover:not([aria-selected="true"]) {532 background: var(--accent);533 color: var(--accent-foreground);534}535.tab[aria-selected="true"] {536 background: var(--foreground);537 color: var(--background);538 box-shadow: 4px 4px 0 var(--primary);539}540```541 542### Table543 544```html545<table class="table"><thead><tr><th>…</th></tr></thead><tbody><tr><td>…</td></tr></tbody></table>546```547 548```css549.table {550 width: 100%;551 border-collapse: collapse;552 font-size: 15px;553 font-variant-numeric: tabular-nums;554}555.table th {556 text-align: left;557 height: 40px;558 padding: 0 16px;559 font-family: var(--font-sans);560 font-size: 14px;561 font-weight: 700;562 text-transform: uppercase;563 letter-spacing: 0.06em;564 background: var(--foreground);565 color: var(--background);566}567.table td {568 height: 52px;569 padding: 0 16px;570 border-bottom: 2px solid var(--border);571 color: var(--foreground);572 transition: background-color var(--duration-fast) var(--ease-standard);573}574.table tbody tr:hover td {575 background: var(--accent);576 color: var(--accent-foreground);577}578```579 580### Dialog / modal581 582```html583<div class="dialog-overlay"><div class="dialog" role="dialog" aria-modal="true">…</div></div>584```585 586```css587.dialog-overlay {588 position: fixed;589 inset: 0;590 background: rgba(27,21,48,0.6);591 display: grid;592 place-items: center;593 padding: 24px;594}595.dialog {596 width: min(500px, 100%);597 background: var(--card);598 color: var(--card-foreground);599 border: 2.5px solid var(--border);600 border-radius: var(--radius-xl);601 box-shadow: var(--shadow-lg);602 padding: 32px;603}604```605 606### Text link607 608```html609<a class="link" href="…">Read more</a>610```611 612```css613.link {614 color: var(--foreground);615 text-decoration: underline;616 text-decoration-color: var(--primary);617 text-decoration-thickness: 3px;618 text-underline-offset: 4px;619 transition: color var(--duration-fast) var(--ease-standard), text-decoration-color var(--duration-fast) var(--ease-standard);620}621.link:hover {622 background: var(--accent);623 text-decoration-color: var(--foreground);624}625```626 627## 8. Imagery & iconography628 629**Imagery.** Flat cut-paper illustration with 2.5px ink outlines: friendly animals, number and letter characters, and chunky objects, filled with the four confetti colors. Photography, when needed, is of real classrooms cropped into circles, triangles or arches with the same ink outline and offset shadow. No gradients, no realistic 3D.630 631**Icons.** 28px chunky icons at 2.5px stroke with round caps, filled with a flat confetti color inside the outline. Subject icons: a plus sign for maths, an open book for reading, a flask for science, a brush for art.632 633## 9. Do / Don't634 635**Do**636 637- Outline every interactive surface at 2.5px in `foreground` and give it a hard offset shadow with no blur638- Give each subject one confetti color and reuse it for icons, progress and badges639- Keep body copy at 17px with 1.6 line height so early readers can track lines640- Make correct answers pop with `success` and a sticker burst; wrong answers shake once and offer a hint641- Place confetti shapes behind content and keep them out of the reading path642 643**Don't**644 645- Don't blur shadows; softness breaks the sticker look646- Don't use more than three confetti colors in one view647- Don't use `destructive` red on a child's mistakes; use `warning` and a hint instead648- Don't put text over confetti shapes; contrast is only guaranteed on `card` and `background`649- Don't use thin outlines or hairlines; 2.5px is the minimum stroke650 651## 10. tokens.css652 653Drop-in, shadcn/ui-compatible. Works with Tailwind v4 as-is (the `@theme inline` block creates `bg-primary`, `text-muted-foreground`, `font-heading`, `text-display`, `rounded-ui-lg`, `shadow-ui-md`…). Plain CSS projects can ignore the `@theme` block.654 655```css656/* Neo Memphis, tokens.css657 * https://freedesignmd.com/system/neo-memphis658 * shadcn/ui-compatible variables. Light on :root, dark on .dark.659 * Default mode: light.660 */661@import url("https://fonts.googleapis.com/css2?family=Fredoka:wght@500;600;700&family=Nunito:wght@400;600;700&family=Space+Mono:wght@400;700&display=swap");662 663:root {664 --font-display: "Fredoka", ui-sans-serif, system-ui, -apple-system, sans-serif;665 --font-sans: "Nunito", ui-sans-serif, system-ui, -apple-system, sans-serif;666 --font-mono: "Space Mono", ui-monospace, SFMono-Regular, Menlo, monospace;667 --type-display-size: clamp(45px, 32.00px + 3.333vw, 80px);668 --type-display-leading: 1;669 --type-display-weight: 700;670 --type-display-tracking: -0.01em;671 --type-h1-size: clamp(35px, 28.69px + 1.619vw, 52px);672 --type-h1-leading: 1.05;673 --type-h1-weight: 600;674 --type-h1-tracking: -0.01em;675 --type-h2-size: clamp(27px, 24.40px + 0.667vw, 34px);676 --type-h2-leading: 1.15;677 --type-h2-weight: 600;678 --type-h2-tracking: 0em;679 --type-h3-size: 22px;680 --type-h3-leading: 1.25;681 --type-h3-weight: 600;682 --type-h3-tracking: 0em;683 --type-body-size: 17px;684 --type-body-leading: 1.6;685 --type-body-weight: 400;686 --type-body-tracking: 0em;687 --type-small-size: 15px;688 --type-small-leading: 1.5;689 --type-small-weight: 600;690 --type-small-tracking: 0em;691 --type-label-size: 13px;692 --type-label-leading: 1.3;693 --type-label-weight: 700;694 --type-label-tracking: 0.04em;695 --type-mono-size: 13px;696 --type-mono-leading: 1.5;697 --type-mono-weight: 400;698 --type-mono-tracking: 0em;699 --space-1: 4px;700 --space-2: 8px;701 --space-3: 12px;702 --space-4: 16px;703 --space-6: 24px;704 --space-8: 32px;705 --space-10: 40px;706 --space-14: 56px;707 --space-20: 80px;708 --space-28: 112px;709 --radius: 14px;710 --radius-sm: 8px;711 --radius-md: 14px;712 --radius-lg: 20px;713 --radius-xl: 28px;714 --radius-full: 9999px;715 --duration-instant: 80ms;716 --duration-fast: 140ms;717 --duration-base: 240ms;718 --duration-slow: 520ms;719 --ease-standard: cubic-bezier(0.3, 0, 0.2, 1);720 --ease-out: cubic-bezier(0.34, 1.56, 0.64, 1);721 --ease-in: cubic-bezier(0.5, 0, 1, 1);722 --reveal-distance: 20px;723 --reveal-stagger: 70ms;724 --container-max: 1140px;725 --gutter: 24px;726 --section-y: 96px;727 --section-y-mobile: 56px;728 --measure: 56ch;729 --background: #fff6df;730 --foreground: #1b1530;731 --card: #ffffff;732 --card-foreground: #1b1530;733 --muted: #ffeabd;734 --muted-foreground: #5b4f66;735 --primary: #d62839;736 --primary-foreground: #ffffff;737 --secondary: #b9e8d6;738 --secondary-foreground: #0f3a2d;739 --accent: #ffd23f;740 --accent-foreground: #1b1530;741 --border: #1b1530;742 --input: #1b1530;743 --ring: #2b59d9;744 --destructive: #a8182a;745 --destructive-foreground: #ffffff;746 --success: #0e7a54;747 --success-foreground: #ffffff;748 --warning: #ffb020;749 --warning-foreground: #241800;750 --chart-1: #d62839;751 --chart-2: #ffb020;752 --chart-3: #1fa584;753 --chart-4: #2b59d9;754 --chart-5: #8a4fd6;755 --shadow-sm: 3px 3px 0 #1b1530;756 --shadow-md: 5px 5px 0 #1b1530;757 --shadow-lg: 8px 8px 0 #1b1530;758}759 760.dark {761 --background: #1c1740;762 --foreground: #fff3d6;763 --card: #2a2360;764 --card-foreground: #fff3d6;765 --muted: #352d78;766 --muted-foreground: #cdc3ee;767 --primary: #ff6b7a;768 --primary-foreground: #2a0610;769 --secondary: #2d6b5c;770 --secondary-foreground: #e2fff3;771 --accent: #ffd23f;772 --accent-foreground: #1b1530;773 --border: #fff3d6;774 --input: #fff3d6;775 --ring: #7fb2ff;776 --destructive: #ff8b94;777 --destructive-foreground: #2e0508;778 --success: #4fdca5;779 --success-foreground: #042418;780 --warning: #ffc54d;781 --warning-foreground: #241800;782 --chart-1: #ff6b7a;783 --chart-2: #ffc54d;784 --chart-3: #4fdca5;785 --chart-4: #7fb2ff;786 --chart-5: #c39bff;787 --shadow-sm: 3px 3px 0 #0d0a26;788 --shadow-md: 5px 5px 0 #0d0a26;789 --shadow-lg: 8px 8px 0 #0d0a26;790}791 792/* Tailwind v4: utilities like bg-primary, text-muted-foreground, font-heading, text-display, rounded-ui-lg, shadow-ui-md */793@theme inline {794 --color-background: var(--background);795 --color-foreground: var(--foreground);796 --color-card: var(--card);797 --color-card-foreground: var(--card-foreground);798 --color-muted: var(--muted);799 --color-muted-foreground: var(--muted-foreground);800 --color-primary: var(--primary);801 --color-primary-foreground: var(--primary-foreground);802 --color-secondary: var(--secondary);803 --color-secondary-foreground: var(--secondary-foreground);804 --color-accent: var(--accent);805 --color-accent-foreground: var(--accent-foreground);806 --color-border: var(--border);807 --color-input: var(--input);808 --color-ring: var(--ring);809 --color-destructive: var(--destructive);810 --color-destructive-foreground: var(--destructive-foreground);811 --color-success: var(--success);812 --color-success-foreground: var(--success-foreground);813 --color-warning: var(--warning);814 --color-warning-foreground: var(--warning-foreground);815 --color-chart-1: var(--chart-1);816 --color-chart-2: var(--chart-2);817 --color-chart-3: var(--chart-3);818 --color-chart-4: var(--chart-4);819 --color-chart-5: var(--chart-5);820 --font-heading: var(--font-display);821 --font-body: var(--font-sans);822 --font-code: var(--font-mono);823 --radius-ui-sm: var(--radius-sm);824 --radius-ui-md: var(--radius-md);825 --radius-ui-lg: var(--radius-lg);826 --radius-ui-xl: var(--radius-xl);827 --text-display: var(--type-display-size);828 --text-display--line-height: var(--type-display-leading);829 --text-display--letter-spacing: var(--type-display-tracking);830 --text-display--font-weight: var(--type-display-weight);831 --text-h1: var(--type-h1-size);832 --text-h1--line-height: var(--type-h1-leading);833 --text-h1--letter-spacing: var(--type-h1-tracking);834 --text-h1--font-weight: var(--type-h1-weight);835 --text-h2: var(--type-h2-size);836 --text-h2--line-height: var(--type-h2-leading);837 --text-h2--letter-spacing: var(--type-h2-tracking);838 --text-h2--font-weight: var(--type-h2-weight);839 --text-h3: var(--type-h3-size);840 --text-h3--line-height: var(--type-h3-leading);841 --text-h3--letter-spacing: var(--type-h3-tracking);842 --text-h3--font-weight: var(--type-h3-weight);843 --text-body: var(--type-body-size);844 --text-body--line-height: var(--type-body-leading);845 --text-body--letter-spacing: var(--type-body-tracking);846 --text-body--font-weight: var(--type-body-weight);847 --text-small: var(--type-small-size);848 --text-small--line-height: var(--type-small-leading);849 --text-small--letter-spacing: var(--type-small-tracking);850 --text-small--font-weight: var(--type-small-weight);851 --text-label: var(--type-label-size);852 --text-label--line-height: var(--type-label-leading);853 --text-label--letter-spacing: var(--type-label-tracking);854 --text-label--font-weight: var(--type-label-weight);855 --text-mono: var(--type-mono-size);856 --text-mono--line-height: var(--type-mono-leading);857 --text-mono--letter-spacing: var(--type-mono-tracking);858 --text-mono--font-weight: var(--type-mono-weight);859 --shadow-ui-sm: var(--shadow-sm);860 --shadow-ui-md: var(--shadow-md);861 --shadow-ui-lg: var(--shadow-lg);862}863 864@layer base {865 body {866 background: var(--background);867 color: var(--foreground);868 font-family: var(--font-sans);869 font-size: var(--type-body-size);870 line-height: var(--type-body-leading);871 font-weight: var(--type-body-weight);872 letter-spacing: var(--type-body-tracking);873 -webkit-font-smoothing: antialiased;874 }875 .type-display {876 font-family: var(--font-display);877 font-size: var(--type-display-size);878 line-height: var(--type-display-leading);879 font-weight: var(--type-display-weight);880 letter-spacing: var(--type-display-tracking);881 }882 .type-h1 {883 font-family: var(--font-display);884 font-size: var(--type-h1-size);885 line-height: var(--type-h1-leading);886 font-weight: var(--type-h1-weight);887 letter-spacing: var(--type-h1-tracking);888 }889 .type-h2 {890 font-family: var(--font-display);891 font-size: var(--type-h2-size);892 line-height: var(--type-h2-leading);893 font-weight: var(--type-h2-weight);894 letter-spacing: var(--type-h2-tracking);895 }896 .type-h3 {897 font-family: var(--font-display);898 font-size: var(--type-h3-size);899 line-height: var(--type-h3-leading);900 font-weight: var(--type-h3-weight);901 letter-spacing: var(--type-h3-tracking);902 }903 .type-body {904 font-family: var(--font-sans);905 font-size: var(--type-body-size);906 line-height: var(--type-body-leading);907 font-weight: var(--type-body-weight);908 letter-spacing: var(--type-body-tracking);909 }910 .type-small {911 font-family: var(--font-sans);912 font-size: var(--type-small-size);913 line-height: var(--type-small-leading);914 font-weight: var(--type-small-weight);915 letter-spacing: var(--type-small-tracking);916 }917 .type-label {918 font-family: var(--font-sans);919 font-size: var(--type-label-size);920 line-height: var(--type-label-leading);921 font-weight: var(--type-label-weight);922 letter-spacing: var(--type-label-tracking);923 text-transform: uppercase;924 }925 .type-mono {926 font-family: var(--font-mono);927 font-size: var(--type-mono-size);928 line-height: var(--type-mono-leading);929 font-weight: var(--type-mono-weight);930 letter-spacing: var(--type-mono-tracking);931 }932 h1 {933 font-family: var(--font-display);934 font-size: var(--type-h1-size);935 line-height: var(--type-h1-leading);936 font-weight: var(--type-h1-weight);937 letter-spacing: var(--type-h1-tracking);938 }939 h2 {940 font-family: var(--font-display);941 font-size: var(--type-h2-size);942 line-height: var(--type-h2-leading);943 font-weight: var(--type-h2-weight);944 letter-spacing: var(--type-h2-tracking);945 }946 h3 {947 font-family: var(--font-display);948 font-size: var(--type-h3-size);949 line-height: var(--type-h3-leading);950 font-weight: var(--type-h3-weight);951 letter-spacing: var(--type-h3-tracking);952 }953 code, kbd, samp, pre {954 font-family: var(--font-mono);955 }956 ::selection {957 background: var(--primary);958 color: var(--primary-foreground);959 }960 .container {961 width: 100%;962 max-width: var(--container-max);963 margin-inline: auto;964 padding-inline: var(--gutter);965 }966 .section {967 padding-block: var(--section-y);968 }969 .prose {970 max-width: var(--measure);971 }972 .reveal {973 opacity: 0;974 transform: translateY(var(--reveal-distance));975 transition: opacity var(--duration-slow) var(--ease-out), transform var(--duration-slow) var(--ease-out);976 transition-delay: calc(var(--reveal-index, 0) * var(--reveal-stagger));977 }978 .reveal.is-in {979 opacity: 1;980 transform: none;981 }982 @media (prefers-reduced-motion: reduce) {983 .reveal { opacity: 1; transform: none; transition: none; }984 *, *::before, *::after { transition-duration: 0s !important; animation-duration: 0s !important; animation-iteration-count: 1 !important; }985 }986}987```988 989Tailwind v3:990 991```js992// tailwind.config.js, Tailwind v3 (v4 users: the @theme block in tokens.css does this)993module.exports = {994 darkMode: "class",995 theme: {996 extend: {997 colors: {998 "background": "var(--background)",999 "foreground": "var(--foreground)",1000 "card": { DEFAULT: "var(--card)", foreground: "var(--card-foreground)" },1001 "muted": { DEFAULT: "var(--muted)", foreground: "var(--muted-foreground)" },1002 "primary": { DEFAULT: "var(--primary)", foreground: "var(--primary-foreground)" },1003 "secondary": { DEFAULT: "var(--secondary)", foreground: "var(--secondary-foreground)" },1004 "accent": { DEFAULT: "var(--accent)", foreground: "var(--accent-foreground)" },1005 "border": "var(--border)",1006 "input": "var(--input)",1007 "ring": "var(--ring)",1008 "destructive": { DEFAULT: "var(--destructive)", foreground: "var(--destructive-foreground)" },1009 "success": { DEFAULT: "var(--success)", foreground: "var(--success-foreground)" },1010 "warning": { DEFAULT: "var(--warning)", foreground: "var(--warning-foreground)" },1011 chart: { 1: "var(--chart-1)", 2: "var(--chart-2)", 3: "var(--chart-3)", 4: "var(--chart-4)", 5: "var(--chart-5)" },1012 },1013 fontFamily: { heading: ["var(--font-display)"], body: ["var(--font-sans)"], code: ["var(--font-mono)"] },1014 borderRadius: { "ui-sm": "var(--radius-sm)", "ui-md": "var(--radius-md)", "ui-lg": "var(--radius-lg)", "ui-xl": "var(--radius-xl)" },1015 boxShadow: { "ui-sm": "var(--shadow-sm)", "ui-md": "var(--shadow-md)", "ui-lg": "var(--shadow-lg)" },1016 transitionDuration: { instant: "var(--duration-instant)", fast: "var(--duration-fast)", base: "var(--duration-base)", slow: "var(--duration-slow)" },1017 transitionTimingFunction: { standard: "var(--ease-standard)", out: "var(--ease-out)", in: "var(--ease-in)" },1018 maxWidth: { container: "var(--container-max)", measure: "var(--measure)" },1019 },1020 },1021};1022```1023 1024Dependencies: `lucide-react`Save as DESIGN.md in the repo root and add “Follow DESIGN.md for all UI” to CLAUDE.md, AGENTS.md or your Cursor rules.


