Town — Design Reference
storybook slab on warm paper
Source: https://www.town.com
Theme: light
Category: AI
Mood: light, warm, editorial, playful, typographic, illustrated
Captured: 2026-11-10
Overview
A warm off-white editorial canvas where an oversized slab serif does nearly all the shouting and hand-drawn animal characters do the charming. Headlines run to 80px with tight -1.6px tracking and 0.9–1.04 line heights, broken mid-sentence by inline photo tiles and pastel highlighter swipes, so the page reads like a children's reader redrawn for enterprise software. Everything else is quiet: 14–18px sans UI text, hairline-ringed cards, near-black ink, and acres of paper.
Tokens — Colors
| Name |
Value |
Token |
Role |
| Paper |
#fdfdfc |
--color-background |
Dominant page ground across every route; also the fill of secondary/ghost buttons and the integrations cards. |
| Ink |
#1c1b1b |
--color-foreground |
Headline and nav colour, and the fill of every primary CTA (Sign up, Meet your Townie, Try Pro) and the announcement bar. |
| Pressed Linen |
#f9f9f8 |
--color-secondary |
Surface-01: alternating section bands and 16px-radius feature cards. |
| Sage Wash |
#f7f8f4 |
--color-muted |
Large cool-tinted section band behind the wiki/routines storytelling blocks. |
| Card White |
#ffffff |
--color-card |
Raised panels: sign-in dialog, product UI mockups, OAuth buttons. |
| Graphite |
#464a47 |
--color-muted-foreground |
Secondary body copy, card descriptions, filter labels. |
| Honey Highlight |
#f5d188 |
--color-accent |
Marker-swipe behind 'unusually helpful', the portrait tile backdrop and the send-button disc in the ask field. |
| Terracotta |
#a5380b |
--color-accent-strong |
Highlighted word colour on honey, the 'Bud' name, and the input hairline in the ask field. |
| Town Green |
#35765a |
--color-primary-alt |
Pill CTA fill on the security/feature pages ('Contact us') and the green highlighter band on /integrations. |
| Signal Blue |
#1375a0 |
--color-link |
Inline text links inside product mockups and documentation copy. |
| Sky Tile |
#c4e2fb |
--color-accent-sky |
Illustration sky in the town scene and pastel chips in the character grid. |
| Night Paper |
#151613 |
--color-background-dark |
Ground of the dark-scheme rendering; also the deep footer band in light mode. |
Semantic roles
| Role |
Value |
| background |
#fdfdfc |
| surface |
#f9f9f8 |
| surface raised |
#ffffff |
| border |
rgba(28, 27, 27, 0.1) |
| text |
#1c1b1b |
| text muted |
#464a47 |
| primary |
#1c1b1b |
| primary text |
#ffffff |
| accent |
#f5d188 |
| success |
#35765a |
| warning |
#d89450 |
| danger |
#a5380b |
Tokens — Typography
- Display: slab (84, 85, 87, 92, 95, 100) — fallbacks: Bookmania, Roslindale, Zilla Slab, Georgia, serif. A variable slab serif carrying every hero, section heading and pricing tier name. Weights are on a 0–1000 variable axis: ~84–87 for display, 92–100 for small headings and the lead paragraph. Always set tight: line-height 0.9–1.15, letter-spacing -1.6px at 80px.
- Body: sans (400, 405, 450, 525, 665) — fallbacks: Inter, Söhne, -apple-system, Segoe UI, sans-serif. Neutral grotesque for nav links (16px/405), buttons (14px/405–525), card copy and filter chips. Slight positive tracking (0.15–0.225px) at 18–20px.
- Accent: diatype (400, 405, 525, 665) — fallbacks: ABC Diatype, Inter, Helvetica Neue, sans-serif. Used in app-adjacent surfaces — sign-in dialog, OAuth buttons, pill CTAs. Interchangeable with body sans at small sizes; keep it for authenticated/product chrome.
- Mono: handwriting (405) — fallbacks: Caveat, Patrick Hand, cursive. Not a monospace — a hand script reserved for mascot name tags ('BUD', 'Flash') and tiny marginal annotations beside illustrations. Use sparingly, 11–13px, in terracotta.
| Role |
Size |
Line height |
Weight |
Letter spacing |
Family |
| Display |
80px |
0.9 |
84 |
-0.02em |
display |
| H1 |
64px |
1.05 |
85 |
-0.015em |
display |
| H2 |
40px |
1.15 |
85 |
-0.01em |
display |
| H3 |
24px |
1.3 |
92 |
0.005em |
display |
| Lead |
18px |
1.6 |
100 |
0.01em |
display |
| Body |
18px |
1.5 |
400 |
0.0125em |
body |
| UI / Small |
14px |
1.45 |
405 |
normal |
body |
| Caption |
12px |
1.5 |
400 |
0.01em |
body |
Tokens — Spacing & Layout
- Base unit: 4px
- Density: spacious
- Container max width: 1180px (prose column capped at 732px)
- Section gap: 138px
- Card padding: 16px (24px on wide feature cards, 32px on dialogs)
- Scale: 4px, 8px, 12px, 16px, 24px, 32px, 48px, 64px, 83px, 138px
Tokens — Radius
| Element |
Value |
| Button, chip, integration card |
6px |
| Filter chip / inline tag |
2px |
| Input, small control |
8px |
| Nav shell, segmented control |
10px |
| Dialog / auth card |
12px |
| Feature panel |
16px |
| Pill CTA |
9999px |
Tokens — Shadows
| Name |
Value |
Usage |
| hairline |
inset 0 0 0 1px rgba(28,27,27,0.1) |
Default card and ghost-button edge — an inset ring, never an outset border, so boxes sit flush on paper. |
| hairline-strong |
inset 0 0 0 1px rgba(28,27,27,0.2) |
Interactive chips and segmented-control segments that need a touch more definition. |
| sm |
0 1px 3px 0 rgba(0,0,0,0.06), 0 1px 2px -1px rgba(0,0,0,0.06) |
OAuth buttons and small raised controls. |
| md |
0 4px 16px -4px rgba(0,0,0,0.04), 0 12px 32px 0 rgba(0,0,0,0.04) |
Floating product mockup panels and the ask-anything composer. |
| lg |
0 1px 0 0 rgba(26,25,26,0.05), 0 4px 16px 0 rgba(0,0,0,0.07), 0 2px 6px -2px rgba(0,0,0,0.04) |
Sign-in dialog centred on empty paper. |
Components
Primary button (button)
| Property |
Value |
| background |
#1c1b1b |
| color |
#ffffff |
| border |
none |
| radius |
6px |
| padding |
10px 16px |
| font size |
14px |
| font weight |
450 |
| shadow |
none |
| hover |
background lightens to #333230; no lift, no scale |
Near-black solid, used for Sign up, Meet your Townie, Try Pro. Hero version steps up to 18px text with 12px 20px padding. Never full-width on desktop.
Ghost / secondary button (button)
| Property |
Value |
| background |
#fdfdfc |
| color |
#1c1b1b |
| border |
none |
| radius |
6px |
| padding |
8px 12px |
| font size |
14px |
| font weight |
405 |
| shadow |
inset 0 0 0 1px rgba(28,27,27,0.2) |
| hover |
inset ring darkens to rgba(28,27,27,0.35) |
The default for Sign in, category filters, 'Browse all Routines' and pricing tier CTAs. Paper fill, inset hairline — visually weightless next to the black primary.
Pill CTA (button)
| Property |
Value |
| background |
#35765a |
| color |
#ffffff |
| border |
none |
| radius |
9999px |
| padding |
16px 24px |
| font size |
18px |
| font weight |
525 |
| shadow |
none |
| hover |
darken to #2c6349 |
Green pill reserved for the security/feature narrative pages; the only rounded-pill shape in the system.
Search / ask input (input)
| Property |
Value |
| background |
#fdfdfc |
| color |
#1c1b1b |
| border |
1px solid rgba(28,27,27,0.15) |
| radius |
8px |
| padding |
12px 16px |
| font size |
14px |
| font weight |
400 |
| shadow |
none |
| hover |
border → rgba(28,27,27,0.3); focus adds 2px #fdfdfc offset ring |
The hero 'Ask Bud anything' composer swaps the border to terracotta #a5380b and tucks a 28px honey #f5d188 circular arrow button on the right. Search inputs on /integrations use a 16px leading magnifier glyph in #464a47.
Directory card (card)
| Property |
Value |
| background |
#fdfdfc |
| color |
#1c1b1b |
| border |
none |
| radius |
6px |
| padding |
16px |
| font size |
14px |
| font weight |
400 |
| shadow |
inset 0 0 0 1px rgba(28,27,27,0.1) |
| hover |
ring to rgba(28,27,27,0.2) |
Integration tiles in a 3-up grid: 24px app logo, 16px title in body sans 525, two-line description in #464a47. Grid gutters 24px.
Feature panel (card)
| Property |
Value |
| background |
#f9f9f8 |
| color |
#1c1b1b |
| border |
none |
| radius |
16px |
| padding |
24px |
| font size |
16px |
| font weight |
400 |
| shadow |
none |
| hover |
none |
Soft linen panels used for routine/feature blocks; contain their own nested white product mockups with the md shadow.
Floating nav shell (nav)
| Property |
Value |
| background |
#fdfdfc |
| color |
#1c1b1b |
| border |
inset 0 0 0 1px rgba(28,27,27,0.1) |
| radius |
10px |
| padding |
8px 16px |
| font size |
16px |
| font weight |
405 |
| shadow |
none |
| hover |
link colour unchanged; underline-free, subtle opacity drop |
Sticky 78px bar with a transparent track and three separate rounded shells: logo lockup, link group, auth group. A full-width black announcement bar (#1c1b1b, 13px white text, underlined 'Read more →') sits above it.
Marker highlight (badge)
| Property |
Value |
| background |
#f5d188 |
| color |
#a5380b |
| border |
none |
| radius |
2px |
| padding |
0 4px |
| font size |
inherit |
| font weight |
inherit |
| shadow |
none |
| hover |
none |
Inline highlighter swipe on a key phrase. Honey/terracotta in the hero, mint #e0eccd with ink text on /integrations — one per heading, maximum.
Layout
Centred single column on a warm paper ground, prose capped near 732px while headline type and card grids run wider (~1180px). The homepage alternates full-bleed paper with tinted bands (#f7f8f4, #f9f9f8) and a near-black security section; vertical rhythm is generous, with ~138px between narrative sections and 83px between a heading and its proof. Hero typography is deliberately deconstructed: the H1 breaks across lines with an inline photo tile inset into the text block, supporting copy centred far below, and a mascot illustration anchoring the bottom-right where a second headline line completes the sentence. Content blocks pair a left-set slab heading with a right-set 18px paragraph plus illustration. Footers stack centred slab nav links over a giant outlined TOWN wordmark lockup.
Imagery
Two registers, deliberately clashing and held together by the paper ground: (1) hand-drawn, crayon-textured animal mascots — a golden retriever, a bear with glasses, an axolotl, an ogre — rendered with visible pencil outlines and flat washes, often waving or reading, dropped at the edges of sections with handwritten name tags; (2) crisp product UI screenshots on white panels, and a single warm portrait photo cropped square on a honey backdrop and inset directly into the hero sentence. An illustrated storybook town scene (sky #c4e2fb, rooftops, hills) serves as the brand banner. Icons are small, literal, monochrome line glyphs at 16–24px.
Motion
Restrained. Sticky nav holds position without blur or shadow change; hover states are colour/ring shifts only, in roughly 150ms ease-out. Entrance animation is limited to gentle fade-and-rise on section reveal; mascots may have a small idle wave loop. No parallax, no scale-on-hover, no gradient animation.
Responsive
At phone width the three nav shells collapse to a single rounded bar holding the asterisk mark, Sign in, Sign up and a vertical-dots toggle; tapping it opens a full-screen paper overlay with the five destinations set in 32px slab serif, each on its own row separated by hairline rules with a trailing → arrow, the retriever mascot filling the space below, and a black full-width 'Get the iPhone app' button plus an outlined 'Sign up' pinned at the bottom. The hero stacks: the display drops to ~44px with 1.05 line height, the inline portrait tile moves onto its own line below the first two words, the supporting line and black CTA centre, and the second headline clause falls beneath the mascot. Cards and grids go single-column, section gaps compress from ~138px to 56–64px, side padding becomes 16–24px, and large CTAs stretch to full width; the announcement bar wraps to two lines with the link on its own row.
Do
- Set display type in the slab at 64–80px with negative tracking (-0.015 to -0.02em) and line-height under 1.05 — the headline should feel crowded and confident.
- Keep all chrome on #fdfdfc paper and define boxes with inset 1px rings at 10% ink, not outset borders or heavy shadows.
- Reserve solid #1c1b1b fills for exactly one primary action per view; everything else is a paper button with a hairline ring.
- Use the honey #f5d188 / terracotta #a5380b highlighter on one phrase per heading to carry the brand's warmth.
- Let hand-drawn mascots break the grid at section edges, overlapping headline type, with handwritten labels at 11–13px.
- Separate sections with tinted bands (#f9f9f8, #f7f8f4) and ~138px of air rather than rules.
Don't
- Don't set headlines in the sans — the slab is the brand voice; sans is for UI and paragraphs only.
- Don't use pure #ffffff as the page ground; the warm #fdfdfc paper is what makes the illustrations sit.
- Don't add gradients, glows or glass blur — surfaces are flat with at most a 4% diffuse shadow.
- Don't round cards past 16px or buttons past 6px; the green pill is the single sanctioned pill shape.
- Don't mix illustration styles — if it isn't hand-drawn with visible outline texture, it's a product screenshot, not an icon-illustration hybrid.
- Don't let body copy exceed ~732px wide or drop below 14px in UI chrome.
- Don't apply more than one highlighter colour within a single section.
Agent prompt
Build a warm editorial marketing site on a #fdfdfc paper ground with #1c1b1b ink text and #464a47 secondary copy. Typography is the entire design: a variable slab serif (fallbacks Bookmania / Zilla Slab / Georgia) for every heading — hero at 80px / line-height 0.9 / letter-spacing -1.6px / weight ~84, section H2 at 40–64px, H3 at 24px weight 92, plus an 18px slab lead at weight 100 — paired with a neutral grotesque (Inter) for all UI at 14px/405 and body at 18px/400 with 0.0125em tracking. Highlight one phrase per headline with an inline marker swipe: background #f5d188, text #a5380b, 2px radius (mint #e0eccd with ink text as the alternate). Chrome: a sticky 78px transparent nav track carrying three separate 10px-radius paper shells (logo, 16px link group, Sign in + black Sign up), with a full-bleed #1c1b1b announcement bar above. Buttons: primary = #1c1b1b fill, #fff text, 6px radius, 10px 16px padding, weight 450, no shadow; secondary = #fdfdfc fill with inset 0 0 0 1px rgba(28,27,27,0.2); one green pill (#35765a, radius 9999px, 16px 24px) for narrative pages. Cards use inset 0 0 0 1px rgba(28,27,27,0.1) at 6px radius with 16px padding for directory grids, and flat #f9f9f8 panels at 16px radius / 24px padding for feature blocks; dialogs are #fff, 12px radius, 32px padding, shadow 0 4px 16px rgba(0,0,0,0.07). Spacing on a 4px base — 8/12/16/24/32/48/64/83/138 — prose capped at 732px inside a ~1180px container, ~138px between sections, alternating #f9f9f8 and #f7f8f4 bands plus one near-black section. Imagery: crayon-textured hand-drawn animal mascots overlapping the type at section edges with handwritten terracotta name tags, square-cropped portraits on honey backdrops inset into the hero sentence, and crisp white product screenshots. Motion is minimal: 150ms colour and ring transitions only. Mobile collapses the nav to one bar plus a dots toggle opening a full-screen paper menu with 32px slab links on hairline rules, mascot art, and full-width black CTAs.
CSS custom properties
/* Town — CSS custom properties. Generated from style.json */
:root {
/* Palette */
--color-background: #fdfdfc; /* Dominant page ground across every route; also the fill of secondary/ghost buttons and the integrations cards. */
--color-foreground: #1c1b1b; /* Headline and nav colour, and the fill of every primary CTA (Sign up, Meet your Townie, Try Pro) and the announcement bar. */
--color-secondary: #f9f9f8; /* Surface-01: alternating section bands and 16px-radius feature cards. */
--color-muted: #f7f8f4; /* Large cool-tinted section band behind the wiki/routines storytelling blocks. */
--color-card: #ffffff; /* Raised panels: sign-in dialog, product UI mockups, OAuth buttons. */
--color-muted-foreground: #464a47; /* Secondary body copy, card descriptions, filter labels. */
--color-accent: #f5d188; /* Marker-swipe behind 'unusually helpful', the portrait tile backdrop and the send-button disc in the ask field. */
--color-accent-strong: #a5380b; /* Highlighted word colour on honey, the 'Bud' name, and the input hairline in the ask field. */
--color-primary-alt: #35765a; /* Pill CTA fill on the security/feature pages ('Contact us') and the green highlighter band on /integrations. */
--color-link: #1375a0; /* Inline text links inside product mockups and documentation copy. */
--color-accent-sky: #c4e2fb; /* Illustration sky in the town scene and pastel chips in the character grid. */
--color-background-dark: #151613; /* Ground of the dark-scheme rendering; also the deep footer band in light mode. */
/* Semantic roles */
--background: #fdfdfc;
--surface: #f9f9f8;
--surface-raised: #ffffff;
--border: rgba(28, 27, 27, 0.1);
--text: #1c1b1b;
--text-muted: #464a47;
--primary: #1c1b1b;
--primary-text: #ffffff;
--accent: #f5d188;
--success: #35765a;
--warning: #d89450;
--danger: #a5380b;
/* Typography */
--font-display: slab, Bookmania, Roslindale, 'Zilla Slab', Georgia, serif;
--font-body: sans, Inter, Söhne, -apple-system, 'Segoe UI', sans-serif;
--font-accent: diatype, 'ABC Diatype', Inter, 'Helvetica Neue', sans-serif;
--font-mono: handwriting, Caveat, 'Patrick Hand', cursive;
--text-display: 80px;
--text-display--line-height: 0.9;
--text-display--letter-spacing: -0.02em;
--text-display--font-weight: 84;
--text-h1: 64px;
--text-h1--line-height: 1.05;
--text-h1--letter-spacing: -0.015em;
--text-h1--font-weight: 85;
--text-h2: 40px;
--text-h2--line-height: 1.15;
--text-h2--letter-spacing: -0.01em;
--text-h2--font-weight: 85;
--text-h3: 24px;
--text-h3--line-height: 1.3;
--text-h3--letter-spacing: 0.005em;
--text-h3--font-weight: 92;
--text-lead: 18px;
--text-lead--line-height: 1.6;
--text-lead--letter-spacing: 0.01em;
--text-lead--font-weight: 100;
--text-body: 18px;
--text-body--line-height: 1.5;
--text-body--letter-spacing: 0.0125em;
--text-body--font-weight: 400;
--text-ui-small: 14px;
--text-ui-small--line-height: 1.45;
--text-ui-small--letter-spacing: normal;
--text-ui-small--font-weight: 405;
--text-caption: 12px;
--text-caption--line-height: 1.5;
--text-caption--letter-spacing: 0.01em;
--text-caption--font-weight: 400;
/* Spacing */
--space-1: 4px;
--space-2: 8px;
--space-3: 12px;
--space-4: 16px;
--space-5: 24px;
--space-6: 32px;
--space-7: 48px;
--space-8: 64px;
--space-9: 83px;
--space-10: 138px;
--container: 1180px (prose column capped at 732px);
--section-gap: 138px;
/* Radius */
--radius-button-chip-integration-card: 6px;
--radius-filter-chip-inline-tag: 2px;
--radius-input-small-control: 8px;
--radius-nav-shell-segmented-control: 10px;
--radius-dialog-auth-card: 12px;
--radius-feature-panel: 16px;
--radius-pill-cta: 9999px;
/* Shadows */
--shadow-hairline: inset 0 0 0 1px rgba(28,27,27,0.1);
--shadow-hairline-strong: inset 0 0 0 1px rgba(28,27,27,0.2);
--shadow-sm: 0 1px 3px 0 rgba(0,0,0,0.06), 0 1px 2px -1px rgba(0,0,0,0.06);
--shadow-md: 0 4px 16px -4px rgba(0,0,0,0.04), 0 12px 32px 0 rgba(0,0,0,0.04);
--shadow-lg: 0 1px 0 0 rgba(26,25,26,0.05), 0 4px 16px 0 rgba(0,0,0,0.07), 0 2px 6px -2px rgba(0,0,0,0.04);
}
Tailwind v4 theme
/* Town — Tailwind CSS v4 theme. Import after tailwindcss: @import "tailwindcss"; then paste this block. */
@theme {
--color-background: #fdfdfc;
--color-foreground: #1c1b1b;
--color-secondary: #f9f9f8;
--color-muted: #f7f8f4;
--color-card: #ffffff;
--color-muted-foreground: #464a47;
--color-accent: #f5d188;
--color-accent-strong: #a5380b;
--color-primary-alt: #35765a;
--color-link: #1375a0;
--color-accent-sky: #c4e2fb;
--color-background-dark: #151613;
--color-background: #fdfdfc;
--color-surface: #f9f9f8;
--color-surface-raised: #ffffff;
--color-border: rgba(28, 27, 27, 0.1);
--color-text: #1c1b1b;
--color-text-muted: #464a47;
--color-primary: #1c1b1b;
--color-primary-text: #ffffff;
--color-accent: #f5d188;
--color-success: #35765a;
--color-warning: #d89450;
--color-danger: #a5380b;
--font-display: slab, Bookmania, Roslindale, 'Zilla Slab', Georgia, serif;
--font-body: sans, Inter, Söhne, -apple-system, 'Segoe UI', sans-serif;
--font-accent: diatype, 'ABC Diatype', Inter, 'Helvetica Neue', sans-serif;
--font-mono: handwriting, Caveat, 'Patrick Hand', cursive;
--text-display: 80px;
--text-display--line-height: 0.9;
--text-display--letter-spacing: -0.02em;
--text-display--font-weight: 84;
--text-h1: 64px;
--text-h1--line-height: 1.05;
--text-h1--letter-spacing: -0.015em;
--text-h1--font-weight: 85;
--text-h2: 40px;
--text-h2--line-height: 1.15;
--text-h2--letter-spacing: -0.01em;
--text-h2--font-weight: 85;
--text-h3: 24px;
--text-h3--line-height: 1.3;
--text-h3--letter-spacing: 0.005em;
--text-h3--font-weight: 92;
--text-lead: 18px;
--text-lead--line-height: 1.6;
--text-lead--letter-spacing: 0.01em;
--text-lead--font-weight: 100;
--text-body: 18px;
--text-body--line-height: 1.5;
--text-body--letter-spacing: 0.0125em;
--text-body--font-weight: 400;
--text-ui-small: 14px;
--text-ui-small--line-height: 1.45;
--text-ui-small--letter-spacing: normal;
--text-ui-small--font-weight: 405;
--text-caption: 12px;
--text-caption--line-height: 1.5;
--text-caption--letter-spacing: 0.01em;
--text-caption--font-weight: 400;
--radius-button-chip-integration-card: 6px;
--radius-filter-chip-inline-tag: 2px;
--radius-input-small-control: 8px;
--radius-nav-shell-segmented-control: 10px;
--radius-dialog-auth-card: 12px;
--radius-feature-panel: 16px;
--radius-pill-cta: 9999px;
--shadow-hairline: inset 0 0 0 1px rgba(28,27,27,0.1);
--shadow-hairline-strong: inset 0 0 0 1px rgba(28,27,27,0.2);
--shadow-sm: 0 1px 3px 0 rgba(0,0,0,0.06), 0 1px 2px -1px rgba(0,0,0,0.06);
--shadow-md: 0 4px 16px -4px rgba(0,0,0,0.04), 0 12px 32px 0 rgba(0,0,0,0.04);
--shadow-lg: 0 1px 0 0 rgba(26,25,26,0.05), 0 4px 16px 0 rgba(0,0,0,0.07), 0 2px 6px -2px rgba(0,0,0,0.04);
--container-site: 1180px (prose column capped at 732px);
}
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.
/* Town — 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. Both schemes come from the site. */
@custom-variant dark (&:where(.dark, .dark *));
:root {
color-scheme: light;
--background: #fdfdfc;
--foreground: #1c1b1b;
--card: #ffffff;
--card-foreground: #1a1a16;
--popover: #ffffff; /* estimated */
--popover-foreground: #1a1a16; /* estimated */
--primary: #1c1b1b;
--primary-foreground: #ffffff;
--secondary: #f9f9f8;
--secondary-foreground: #1c1b1b;
--muted: #f4f4f3;
--muted-foreground: #464a47;
--accent: #f5d188;
--accent-foreground: #a5380b;
--destructive: #a5380b;
--destructive-foreground: #ffffff; /* estimated */
--border: rgba(28, 27, 27, 0.1);
--input: rgba(28, 27, 27, 0.2);
--ring: #1c1b1b; /* estimated */
--radius-small: 2px;
--radius-medium: 6px;
--radius-large: 16px;
--radius: var(--radius-medium);
--font-display: slab, Bookmania, Roslindale, 'Zilla Slab', Georgia, serif;
--font-body: sans, Inter, Söhne, -apple-system, 'Segoe UI', sans-serif;
--font-mono: handwriting, Caveat, 'Patrick Hand', cursive;
}
.dark {
color-scheme: dark;
--background: #151613;
--foreground: #fafaf9;
--card: #1c1b1b;
--card-foreground: #fafaf9;
--popover: #1c1b1b;
--popover-foreground: #fafaf9;
--primary: #fdfdfc;
--primary-foreground: #1c1b1b;
--secondary: #23241f;
--secondary-foreground: #fafaf9;
--muted: #23241f;
--muted-foreground: #a3a49d;
--accent: #f7e0b2;
--accent-foreground: #1c1b1b;
--destructive: #eb4819;
--destructive-foreground: #151613;
--border: rgba(250, 250, 249, 0.12);
--input: rgba(250, 250, 249, 0.2);
--ring: #f5d188;
}
@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-display: var(--font-display);
--font-body: var(--font-body);
--font-mono: var(--font-mono);
}
Town — Style Reference
storybook slab on warm paper
Theme: light · Mood: light, warm, editorial, playful, typographic, illustrated
A warm off-white editorial canvas where an oversized slab serif does nearly all the shouting and hand-drawn animal characters do the charming. Headlines run to 80px with tight -1.6px tracking and 0.9–1.04 line heights, broken mid-sentence by inline photo tiles and pastel highlighter swipes, so the page reads like a children's reader redrawn for enterprise software. Everything else is quiet: 14–18px sans UI text, hairline-ringed cards, near-black ink, and acres of paper.
Tokens — Colors
| Name |
Value |
Token |
Role |
| Paper |
#fdfdfc |
--background |
Dominant page ground across every route; also the fill of secondary/ghost buttons and the integrations cards. |
| Ink |
#1c1b1b |
--foreground |
Headline and nav colour, and the fill of every primary CTA (Sign up, Meet your Townie, Try Pro) and the announcement bar. |
| Pressed Linen |
#f9f9f8 |
--secondary |
Surface-01: alternating section bands and 16px-radius feature cards. |
| Sage Wash |
#f7f8f4 |
--muted |
Large cool-tinted section band behind the wiki/routines storytelling blocks. |
| Card White |
#ffffff |
--card |
Raised panels: sign-in dialog, product UI mockups, OAuth buttons. |
| Graphite |
#464a47 |
--muted_foreground |
Secondary body copy, card descriptions, filter labels. |
| Honey Highlight |
#f5d188 |
--accent |
Marker-swipe behind 'unusually helpful', the portrait tile backdrop and the send-button disc in the ask field. |
| Terracotta |
#a5380b |
--accent-strong |
Highlighted word colour on honey, the 'Bud' name, and the input hairline in the ask field. |
| Town Green |
#35765a |
--primary-alt |
Pill CTA fill on the security/feature pages ('Contact us') and the green highlighter band on /integrations. |
| Signal Blue |
#1375a0 |
--link |
Inline text links inside product mockups and documentation copy. |
| Sky Tile |
#c4e2fb |
--accent-sky |
Illustration sky in the town scene and pastel chips in the character grid. |
| Night Paper |
#151613 |
--background-dark |
Ground of the dark-scheme rendering; also the deep footer band in light mode. |
Tokens — Typography
- Display: slab (Bookmania, Roslindale, Zilla Slab, Georgia, serif) — weights 84/85/87/92/95/100
- Body: sans (Inter, Söhne, -apple-system, Segoe UI, sans-serif) — weights 400/405/450/525/665
- Accent: diatype (ABC Diatype, Inter, Helvetica Neue, sans-serif) — weights 400/405/525/665
- Mono: handwriting (Caveat, Patrick Hand, cursive) — weights 405
Tokens — Radius
| Element |
Value |
| Button, chip, integration card |
6px |
| Filter chip / inline tag |
2px |
| Input, small control |
8px |
| Nav shell, segmented control |
10px |
| Dialog / auth card |
12px |
| Feature panel |
16px |
| Pill CTA |
9999px |
Do
- Set display type in the slab at 64–80px with negative tracking (-0.015 to -0.02em) and line-height under 1.05 — the headline should feel crowded and confident.
- Keep all chrome on #fdfdfc paper and define boxes with inset 1px rings at 10% ink, not outset borders or heavy shadows.
- Reserve solid #1c1b1b fills for exactly one primary action per view; everything else is a paper button with a hairline ring.
- Use the honey #f5d188 / terracotta #a5380b highlighter on one phrase per heading to carry the brand's warmth.
- Let hand-drawn mascots break the grid at section edges, overlapping headline type, with handwritten labels at 11–13px.
- Separate sections with tinted bands (#f9f9f8, #f7f8f4) and ~138px of air rather than rules.
Don't
- Don't set headlines in the sans — the slab is the brand voice; sans is for UI and paragraphs only.
- Don't use pure #ffffff as the page ground; the warm #fdfdfc paper is what makes the illustrations sit.
- Don't add gradients, glows or glass blur — surfaces are flat with at most a 4% diffuse shadow.
- Don't round cards past 16px or buttons past 6px; the green pill is the single sanctioned pill shape.
- Don't mix illustration styles — if it isn't hand-drawn with visible outline texture, it's a product screenshot, not an icon-illustration hybrid.
- Don't let body copy exceed ~732px wide or drop below 14px in UI chrome.
- Don't apply more than one highlighter colour within a single section.
{
"$name": "Town",
"$source": "https://www.town.com",
"$theme": "light",
"$generated": "inspiration library",
"color": {
"background": {
"$type": "color",
"$value": "#fdfdfc",
"$description": "Dominant page ground across every route; also the fill of secondary/ghost buttons and the integrations cards."
},
"foreground": {
"$type": "color",
"$value": "#1c1b1b",
"$description": "Headline and nav colour, and the fill of every primary CTA (Sign up, Meet your Townie, Try Pro) and the announcement bar."
},
"secondary": {
"$type": "color",
"$value": "#f9f9f8",
"$description": "Surface-01: alternating section bands and 16px-radius feature cards."
},
"muted": {
"$type": "color",
"$value": "#f7f8f4",
"$description": "Large cool-tinted section band behind the wiki/routines storytelling blocks."
},
"card": {
"$type": "color",
"$value": "#ffffff",
"$description": "Raised panels: sign-in dialog, product UI mockups, OAuth buttons."
},
"muted-foreground": {
"$type": "color",
"$value": "#464a47",
"$description": "Secondary body copy, card descriptions, filter labels."
},
"accent": {
"$type": "color",
"$value": "#f5d188",
"$description": "Marker-swipe behind 'unusually helpful', the portrait tile backdrop and the send-button disc in the ask field."
},
"accent-strong": {
"$type": "color",
"$value": "#a5380b",
"$description": "Highlighted word colour on honey, the 'Bud' name, and the input hairline in the ask field."
},
"primary-alt": {
"$type": "color",
"$value": "#35765a",
"$description": "Pill CTA fill on the security/feature pages ('Contact us') and the green highlighter band on /integrations."
},
"link": {
"$type": "color",
"$value": "#1375a0",
"$description": "Inline text links inside product mockups and documentation copy."
},
"accent-sky": {
"$type": "color",
"$value": "#c4e2fb",
"$description": "Illustration sky in the town scene and pastel chips in the character grid."
},
"background-dark": {
"$type": "color",
"$value": "#151613",
"$description": "Ground of the dark-scheme rendering; also the deep footer band in light mode."
}
},
"role": {
"background": {
"$type": "color",
"$value": "#fdfdfc"
},
"surface": {
"$type": "color",
"$value": "#f9f9f8"
},
"surface_raised": {
"$type": "color",
"$value": "#ffffff"
},
"border": {
"$type": "color",
"$value": "rgba(28, 27, 27, 0.1)"
},
"text": {
"$type": "color",
"$value": "#1c1b1b"
},
"text_muted": {
"$type": "color",
"$value": "#464a47"
},
"primary": {
"$type": "color",
"$value": "#1c1b1b"
},
"primary_text": {
"$type": "color",
"$value": "#ffffff"
},
"accent": {
"$type": "color",
"$value": "#f5d188"
},
"success": {
"$type": "color",
"$value": "#35765a"
},
"warning": {
"$type": "color",
"$value": "#d89450"
},
"danger": {
"$type": "color",
"$value": "#a5380b"
}
},
"fontFamily": {
"display": {
"$type": "fontFamily",
"$value": [
"slab",
"Bookmania",
"Roslindale",
"Zilla Slab",
"Georgia",
"serif"
],
"$description": "A variable slab serif carrying every hero, section heading and pricing tier name. Weights are on a 0–1000 variable axis: ~84–87 for display, 92–100 for small headings and the lead paragraph. Always set tight: line-height 0.9–1.15, letter-spacing -1.6px at 80px."
},
"body": {
"$type": "fontFamily",
"$value": [
"sans",
"Inter",
"Söhne",
"-apple-system",
"Segoe UI",
"sans-serif"
],
"$description": "Neutral grotesque for nav links (16px/405), buttons (14px/405–525), card copy and filter chips. Slight positive tracking (0.15–0.225px) at 18–20px."
},
"accent": {
"$type": "fontFamily",
"$value": [
"diatype",
"ABC Diatype",
"Inter",
"Helvetica Neue",
"sans-serif"
],
"$description": "Used in app-adjacent surfaces — sign-in dialog, OAuth buttons, pill CTAs. Interchangeable with body sans at small sizes; keep it for authenticated/product chrome."
},
"mono": {
"$type": "fontFamily",
"$value": [
"handwriting",
"Caveat",
"Patrick Hand",
"cursive"
],
"$description": "Not a monospace — a hand script reserved for mascot name tags ('BUD', 'Flash') and tiny marginal annotations beside illustrations. Use sparingly, 11–13px, in terracotta."
}
},
"typography": {
"display": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "80px",
"lineHeight": "0.9",
"fontWeight": 84,
"letterSpacing": "-0.02em"
}
},
"h1": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "64px",
"lineHeight": "1.05",
"fontWeight": 85,
"letterSpacing": "-0.015em"
}
},
"h2": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "40px",
"lineHeight": "1.15",
"fontWeight": 85,
"letterSpacing": "-0.01em"
}
},
"h3": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "24px",
"lineHeight": "1.3",
"fontWeight": 92,
"letterSpacing": "0.005em"
}
},
"lead": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "18px",
"lineHeight": "1.6",
"fontWeight": 100,
"letterSpacing": "0.01em"
}
},
"body": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "18px",
"lineHeight": "1.5",
"fontWeight": 400,
"letterSpacing": "0.0125em"
}
},
"ui-small": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "14px",
"lineHeight": "1.45",
"fontWeight": 405,
"letterSpacing": "normal"
}
},
"caption": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "12px",
"lineHeight": "1.5",
"fontWeight": 400,
"letterSpacing": "0.01em"
}
}
},
"spacing": {
"1": {
"$type": "dimension",
"$value": "4px"
},
"2": {
"$type": "dimension",
"$value": "8px"
},
"3": {
"$type": "dimension",
"$value": "12px"
},
"4": {
"$type": "dimension",
"$value": "16px"
},
"5": {
"$type": "dimension",
"$value": "24px"
},
"6": {
"$type": "dimension",
"$value": "32px"
},
"7": {
"$type": "dimension",
"$value": "48px"
},
"8": {
"$type": "dimension",
"$value": "64px"
},
"9": {
"$type": "dimension",
"$value": "83px"
},
"10": {
"$type": "dimension",
"$value": "138px"
}
},
"radius": {
"button-chip-integration-card": {
"$type": "dimension",
"$value": "6px"
},
"filter-chip-inline-tag": {
"$type": "dimension",
"$value": "2px"
},
"input-small-control": {
"$type": "dimension",
"$value": "8px"
},
"nav-shell-segmented-control": {
"$type": "dimension",
"$value": "10px"
},
"dialog-auth-card": {
"$type": "dimension",
"$value": "12px"
},
"feature-panel": {
"$type": "dimension",
"$value": "16px"
},
"pill-cta": {
"$type": "dimension",
"$value": "9999px"
}
},
"shadow": {
"hairline": {
"$type": "shadow",
"$value": "inset 0 0 0 1px rgba(28,27,27,0.1)",
"$description": "Default card and ghost-button edge — an inset ring, never an outset border, so boxes sit flush on paper."
},
"hairline-strong": {
"$type": "shadow",
"$value": "inset 0 0 0 1px rgba(28,27,27,0.2)",
"$description": "Interactive chips and segmented-control segments that need a touch more definition."
},
"sm": {
"$type": "shadow",
"$value": "0 1px 3px 0 rgba(0,0,0,0.06), 0 1px 2px -1px rgba(0,0,0,0.06)",
"$description": "OAuth buttons and small raised controls."
},
"md": {
"$type": "shadow",
"$value": "0 4px 16px -4px rgba(0,0,0,0.04), 0 12px 32px 0 rgba(0,0,0,0.04)",
"$description": "Floating product mockup panels and the ask-anything composer."
},
"lg": {
"$type": "shadow",
"$value": "0 1px 0 0 rgba(26,25,26,0.05), 0 4px 16px 0 rgba(0,0,0,0.07), 0 2px 6px -2px rgba(0,0,0,0.04)",
"$description": "Sign-in dialog centred on empty paper."
}
},
"component": {
"primary-button": {
"kind": "button",
"background": "#1c1b1b",
"color": "#ffffff",
"border": "none",
"radius": "6px",
"padding": "10px 16px",
"font_size": "14px",
"font_weight": 450,
"shadow": "none",
"hover": "background lightens to #333230; no lift, no scale",
"notes": "Near-black solid, used for Sign up, Meet your Townie, Try Pro. Hero version steps up to 18px text with 12px 20px padding. Never full-width on desktop."
},
"ghost-secondary-button": {
"kind": "button",
"background": "#fdfdfc",
"color": "#1c1b1b",
"border": "none",
"radius": "6px",
"padding": "8px 12px",
"font_size": "14px",
"font_weight": 405,
"shadow": "inset 0 0 0 1px rgba(28,27,27,0.2)",
"hover": "inset ring darkens to rgba(28,27,27,0.35)",
"notes": "The default for Sign in, category filters, 'Browse all Routines' and pricing tier CTAs. Paper fill, inset hairline — visually weightless next to the black primary."
},
"pill-cta": {
"kind": "button",
"background": "#35765a",
"color": "#ffffff",
"border": "none",
"radius": "9999px",
"padding": "16px 24px",
"font_size": "18px",
"font_weight": 525,
"shadow": "none",
"hover": "darken to #2c6349",
"notes": "Green pill reserved for the security/feature narrative pages; the only rounded-pill shape in the system."
},
"search-ask-input": {
"kind": "input",
"background": "#fdfdfc",
"color": "#1c1b1b",
"border": "1px solid rgba(28,27,27,0.15)",
"radius": "8px",
"padding": "12px 16px",
"font_size": "14px",
"font_weight": 400,
"shadow": "none",
"hover": "border → rgba(28,27,27,0.3); focus adds 2px #fdfdfc offset ring",
"notes": "The hero 'Ask Bud anything' composer swaps the border to terracotta #a5380b and tucks a 28px honey #f5d188 circular arrow button on the right. Search inputs on /integrations use a 16px leading magnifier glyph in #464a47."
},
"directory-card": {
"kind": "card",
"background": "#fdfdfc",
"color": "#1c1b1b",
"border": "none",
"radius": "6px",
"padding": "16px",
"font_size": "14px",
"font_weight": 400,
"shadow": "inset 0 0 0 1px rgba(28,27,27,0.1)",
"hover": "ring to rgba(28,27,27,0.2)",
"notes": "Integration tiles in a 3-up grid: 24px app logo, 16px title in body sans 525, two-line description in #464a47. Grid gutters 24px."
},
"feature-panel": {
"kind": "card",
"background": "#f9f9f8",
"color": "#1c1b1b",
"border": "none",
"radius": "16px",
"padding": "24px",
"font_size": "16px",
"font_weight": 400,
"shadow": "none",
"hover": "none",
"notes": "Soft linen panels used for routine/feature blocks; contain their own nested white product mockups with the md shadow."
},
"floating-nav-shell": {
"kind": "nav",
"background": "#fdfdfc",
"color": "#1c1b1b",
"border": "inset 0 0 0 1px rgba(28,27,27,0.1)",
"radius": "10px",
"padding": "8px 16px",
"font_size": "16px",
"font_weight": 405,
"shadow": "none",
"hover": "link colour unchanged; underline-free, subtle opacity drop",
"notes": "Sticky 78px bar with a transparent track and three separate rounded shells: logo lockup, link group, auth group. A full-width black announcement bar (#1c1b1b, 13px white text, underlined 'Read more →') sits above it."
},
"marker-highlight": {
"kind": "badge",
"background": "#f5d188",
"color": "#a5380b",
"border": "none",
"radius": "2px",
"padding": "0 4px",
"font_size": "inherit",
"font_weight": "inherit",
"shadow": "none",
"hover": "none",
"notes": "Inline highlighter swipe on a key phrase. Honey/terracotta in the hero, mint #e0eccd with ink text on /integrations — one per heading, maximum."
}
}
}