MozaikaDesign system

Val Town — Design System

light · modern · medium · tailwind · confidence 92%

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; 4px 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

RoleValue
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

Typography

Spacing

Radii

Per-section tokens (7)

Export: DESIGN.md

# Val Town — Design System

> light, modern, medium, tailwind

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.

## Typography

- Heading: **IBM Plex Sans**
- Body: **Sprig Sans** _(free fallback: Newsreader)_
- h1: 48px
- h2: 48px
- body: 18px

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

## Spacing
- base unit: 4px
- scale: 2px, 4px, 6px, 8px, 12px, 16px, 24px, 32px

## Radius
- base: 0px
- button: 12px

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

## 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.

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;
  --text-h1: 48px;
  --text-h2: 48px;
  --text-body: 18px;
  --radius-base: 0px;
  --radius-button: 12px;
  --spacing-1: 2px;
  --spacing-2: 4px;
  --spacing-3: 6px;
  --spacing-4: 8px;
  --spacing-5: 12px;
  --spacing-6: 16px;
  --spacing-7: 24px;
  --spacing-8: 32px;
}

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;
  --radius: 0px;
  --radius-button: 12px;
}
/* fonts: IBM Plex Sans — free, on Google. Sprig Sans may be proprietary — safe free fallback: Newsreader (Google Fonts). */