Val Town — Design System

light · modern · medium · tailwind · confidence 92% · deep decode

Val Town ships apps from a storybook: Sprig Sans at 48px/400 over isometric town illustrations, IBM Plex Sans for the working text and 8px-radius buttons. Code vals render as friendly postcards — a serverless platform drawn like a neighborhood, where deploying is walking down the street.

Open in Mozaika →

This is a static, crawlable rendering for search & AI engines. The interactive version — filters, live decode console, copy & export — is at https://mozaika.design/ds/val-town.

Tokens

Val Town's decoded design system: background #FFFFFF, text #000000, accent #00BCFF, link #00BCFF, primary #B8E6FE; type scale h1 48px / h2 48px / body 18px; 8px spacing base; 0px base radius. The single interactive/action color is #00BCFF — used only on interactive or must-notice elements (buttons, links, key highlights), never on large fills.

Color roles

Using these colors

• Action color #00BCFF — the single interactive color; only on things you click or must notice, never large fills.
• accent, link, button_bg are all #00BCFF — one role, not several (the action color).
• accent #00BCFF — THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed.
• primary #B8E6FE — a brand color — but the call-to-action uses #00BCFF, not this.
• secondary #052F4A — optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two.

Typography

• Heading: IBM Plex Sans
• Body: Sprig Sans
• h1: 48px
• h2: 48px
• body: 18px

Spacing

• base unit: 8px
• scale: 4px, 8px, 12px, 16px, 20px, 24px, 40px, 48px, 64px, 80px

Radii

• base: 0px
• button: 12px

Motion

Micro-interactions run at 150ms (dominant) with cubic-bezier(0.4, 0, 0.2, 1).

• durations: 150ms · 500ms · 300ms
• easings: cubic-bezier(0.4, 0, 0.2, 1) · ease-in-out
• animated properties: opacity, color, background-color, border-color

Native design tokens

…and 110 more measured on the page.

Layout (measured)

• nav: 64px

Motion choreography (measured)

Load order: image._sway_g4kj4_12×19 → div.pointer-events-none → div.pointer-events-none → div.h-full → img.absolute×4

Scroll reveal: 6 elements rest at opacity 0, animate in over 0.5s cubic-bezier(0.4, 0, 0.2, 1).

Stagger: image ×5 — 6500ms apart.

Responsive (measured)

• breakpoints: 384px · 512px · 640px · 768px · 896px · 1024px
• mobile (390px): hero 24px · nav inline

Per-section tokens (7)

• Hero — light · bg #FFFFFF · text #625B5D · 1 col · left
• Logo Wall — light · bg #FFFFFF · text #262022 · 1 col · left
• Feature — light · bg #FFFFFF · text #8B9AA9 · 1 col · left
• Feature — light · bg #FFFFFF · text #4D4D4B · 3 col · split
• Testimonial / Social Proof — light · bg #FFFFFF · text #A3A29F · 2 col · split
• Gallery / Showcase — light · bg #FFFFFF · text #544E45 · 2 col · left
• Footer — light · bg #FFFFFF · text #95B2BC · 1 col · left

Export: DESIGN.md

# Val Town — Design System

> light, modern, medium, tailwind — deep decode (measured live)

Val Town ships apps from a storybook: Sprig Sans at 48px/400 over isometric town illustrations, IBM Plex Sans for the working text and 8px-radius buttons. Code vals render as friendly postcards — a serverless platform drawn like a neighborhood, where deploying is walking down the street.

## Colors

| Role | Value |
|------|-------|
| bg | `#FFFFFF` |
| surface | `#EFEFEF` |
| border | `#D8D8D8` |
| text | `#000000` |
| text_muted | `#606060` |
| primary | `#B8E6FE` |
| accent | `#00BCFF` |
| link | `#00BCFF` |
| secondary | `#052F4A` |
| button_bg | `#00BCFF` |
| button_text | `#052F4A` |

**Using these colors**

- **Action color** `#00BCFF` — the single interactive color; it appears only on things you click or must notice (buttons, key highlights), never on large fills or backgrounds.
- `accent`, `link`, `button_bg` are all `#00BCFF` — one role, not several (your action color).
- **accent** `#00BCFF` — THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed.
- **primary** `#B8E6FE` — a brand color — but the call-to-action uses #00BCFF, not this.
- **secondary** `#052F4A` — optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two.
- **Page coverage** (full-page screenshot pixels): `#FFFFFF` 87.7% · `#6C6C72` 7.7% · `#CED8DA` 4.6%

## Typography

- Heading: **IBM Plex Sans**
- Body: **Sprig Sans** _(free fallback: Newsreader)_

| Role | Size / weight · line-height · tracking |
|------|------------------------------------------|
| hero | 48px / 400 · lh 50px · tracking -1.2px |
| h2 | 32px / 400 · lh 48px |
| body | 18px / 400 · lh 27px |
| small | 16px / 700 · lh 24px |

- Weight ladder: 400 · 700 — use these exact measured weights, not the 400/600 defaults.

> **Fonts —** IBM Plex Sans — free, on Google. Sprig Sans may be proprietary — safe free fallback: Newsreader (Google Fonts).

## Spacing
- base unit: 8px (inferred from the measured scale)
- measured scale: 4px, 8px, 12px, 16px, 20px, 24px, 40px, 48px, 64px, 80px — snap all gaps/padding to these
- section rhythm: 80px top/bottom padding per section (measured)

## Radius
- base: 0px
- button: 12px
- card: 12px
- pill: 9999px

## Primary button
- bg `#00BCFF` · text `#052F4A` · radius 12px

## Motion
- durations: 150ms (dominant) · 500ms · 300ms
- easings: `cubic-bezier(0.4, 0, 0.2, 1)` (dominant) · `ease-in-out`
- animated properties: opacity, color, background-color, border-color

Micro-interactions use the dominant duration + easing; nothing on the page animates slower than the longest duration above — don't invent springier motion.

## Their own tokens (verbatim from :root)

| Token | Value |
|-------|-------|
| `--color-purple-200` | `oklch(90.2% .063 306.703)` |
| `--color-purple-300` | `oklch(82.7% .119 306.383)` |
| `--color-rose-200` | `oklch(89.2% .058 10.001)` |
| `--color-slate-200` | `oklch(92.9% .013 255.508)` |
| `--color-sky-500` | `oklch(68.5% .169 237.323)` |
| `--color-pink-500` | `oklch(65.6% .241 354.308)` |
| `--color-orange-600` | `oklch(64.6% .222 41.116)` |
| `--color-violet-600` | `oklch(54.1% .281 293.009)` |
| `--color-red-900` | `oklch(39.6% .141 25.723)` |
| `--color-orange-800` | `oklch(47% .157 37.304)` |
| `--color-blue-700` | `oklch(48.8% .243 264.376)` |
| `--color-neutral-300` | `oklch(87% 0 0)` |

_…and 108 more measured on the page._

Prefer these names when extending their system — it's the brand's actual vocabulary.

## Layout (measured)
- nav: 64px · border-bottom 1px solid oklch(0.929 0.013 255.508) · bg #FFFFFF

| Section (y) | Height | Cols | Gap | Pad y | Split |
|---|---|---|---|---|---|
| 64 | 1056 | — | — | 0/0 | — |
| 1120 | 904 | — | — | 80/80 | — |
| 2024 | 1550 | — | — | 0/0 | — |
| 3574 | 1474 | — | — | 0/0 | — |

## Motion choreography (measured)
Load order: `image._sway_g4kj4_12`×19 @0ms → `div.pointer-events-none` @1ms → `div.pointer-events-none` @1ms → `div.h-full` @1ms → `img.absolute`×4 @2740ms
- `div.pointer-events-none` — transform scale(0.6)→scale(1) — 420ms cubic-bezier(0.34, 1.56, 0.64, 1)
- `div.h-full` — width 8px→100% — 5000ms
- `image._sway_g4kj4_12` ×19 — transform skew(0deg, 0deg)→skew(0.9deg, 0deg) — 8400ms ease-in-out (delay -23400ms) · loops
- stagger: `image` ×5 — 6500ms apart
- scroll reveal: 6 elements rest at opacity 0, animate in over 0.5s cubic-bezier(0.4, 0, 0.2, 1) (1 revealed during the drive).

Rebuild the timeline, not just the durations — order, delays and staggers above are the choreography.

## Responsive (measured)
- breakpoints: 384px · 512px · 640px · 768px · 896px · 1024px
- mobile (390px): hero 24px · body 16px · 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/ds/val-town

Export: Tailwind v4 (@theme)

@theme {
  /* action color #00BCFF — the one interactive color; buttons/links/emphasis only, never large fills. */
  --color-bg: #FFFFFF;
  --color-surface: #EFEFEF;
  --color-border: #D8D8D8;
  --color-text: #000000;
  --color-text-muted: #606060;
  --color-primary: #B8E6FE;  /* a brand color — but the call-to-action uses #00BCFF, not this. */
  --color-accent: #00BCFF;  /* THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed. */
  --color-link: #00BCFF;  /* inline text links — shares the action color. */
  --color-secondary: #052F4A;  /* optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two. */
  --color-button-bg: #00BCFF;  /* primary-button fill — the main call-to-action color. */
  --color-button-text: #052F4A;
  /* fonts: IBM Plex Sans — free, on Google. Sprig Sans may be proprietary — safe free fallback: Newsreader (Google Fonts). */
  --font-heading: "IBM Plex Sans", system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-body: "Sprig Sans", "Newsreader", system-ui, -apple-system, 'Segoe UI', sans-serif;
  /* measured weights: 400, 700 — use these, not 400/600 */
  --text-hero: 48px; --font-weight-hero: 400; --leading-hero: 50px; --tracking-hero: -1.2px;
  --text-h2: 32px; --font-weight-h2: 400; --leading-h2: 48px;
  --text-body: 18px; --font-weight-body: 400; --leading-body: 27px;
  --text-small: 16px; --font-weight-small: 700; --leading-small: 24px;
  --radius-base: 0px;
  --radius-button: 12px;
  --radius-card: 12px;
  --radius-pill: 9999px;
  --ease-brand: cubic-bezier(0.4, 0, 0.2, 1);
  --duration-fast: 150ms;  /* use: duration-[var(--duration-fast)] */
  --duration-base: 300ms;
  --duration-slow: 500ms;
  --section-y: 80px;  /* per-section vertical padding (measured) */
  --spacing: 8px;  /* measured base — drives the p-*/gap-* scale. steps seen on the page: 4, 8, 12, 16, 20, 24, 40, 48, 64, 80px */
}

Export: CSS variables

:root {
  /* action color #00BCFF — the one interactive color; buttons/links/emphasis only, never large fills. */
  --bg: #FFFFFF;
  --surface: #EFEFEF;
  --border: #D8D8D8;
  --text: #000000;
  --text-muted: #606060;
  --primary: #B8E6FE;  /* a brand color — but the call-to-action uses #00BCFF, not this. */
  --accent: #00BCFF;  /* THE accent / action color — interactive & must-notice only (buttons, links, focus, one key highlight); never large fills or backgrounds. Scarcity is what makes it read as designed. */
  --link: #00BCFF;  /* inline text links — shares the action color. */
  --secondary: #052F4A;  /* optional secondary accent — LOW decode confidence; use rarely (a status color or a single decorative moment) or omit it entirely. Prefer one accent unless the reference clearly shows two. */
  --button-bg: #00BCFF;  /* primary-button fill — the main call-to-action color. */
  --button-text: #052F4A;
  --font-heading: "IBM Plex Sans", system-ui, -apple-system, 'Segoe UI', sans-serif;
  --font-body: "Sprig Sans", "Newsreader", system-ui, -apple-system, 'Segoe UI', sans-serif;
  --text-hero: 48px; --weight-hero: 400; --leading-hero: 50px; --tracking-hero: -1.2px;
  --text-h2: 32px; --weight-h2: 400; --leading-h2: 48px;
  --text-body: 18px; --weight-body: 400; --leading-body: 27px;
  --text-small: 16px; --weight-small: 700; --leading-small: 24px;
  --radius: 0px;
  --radius-button: 12px;
  --radius-card: 12px;
  --radius-pill: 9999px;
  --ease: cubic-bezier(0.4, 0, 0.2, 1);
  --duration-fast: 150ms;
  --duration-base: 300ms;
  --duration-slow: 500ms;
  --section-y: 80px;
}

/* their own tokens, verbatim from the site's :root */
:root {
  --color-purple-200: oklch(90.2% .063 306.703);
  --color-purple-300: oklch(82.7% .119 306.383);
  --color-rose-200: oklch(89.2% .058 10.001);
  --color-slate-200: oklch(92.9% .013 255.508);
  --color-sky-500: oklch(68.5% .169 237.323);
  --color-pink-500: oklch(65.6% .241 354.308);
  --color-orange-600: oklch(64.6% .222 41.116);
  --color-violet-600: oklch(54.1% .281 293.009);
  --color-red-900: oklch(39.6% .141 25.723);
  --color-orange-800: oklch(47% .157 37.304);
  --color-blue-700: oklch(48.8% .243 264.376);
  --color-neutral-300: oklch(87% 0 0);
}
/* fonts: IBM Plex Sans — free, on Google. Sprig Sans may be proprietary — safe free fallback: Newsreader (Google Fonts). */