Val Town — Design System
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.
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
| 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; only on things you click or must notice, never large fills. accent,link,button_bgare 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: 4px
- scale: 2px, 4px, 6px, 8px, 12px, 16px, 24px, 32px
Radii
- base: 0px
- button: 12px
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). */