Ui — Design Reference
quiet grayscale instrument for builders
Source: https://ui.shadcn.com
Theme: light
Category: Developer Tools
Mood: light, minimal, technical, precise, monochrome, typographic
Captured: 2026-10-21
Overview
A pure-white, near-monochrome documentation and component showcase where hierarchy comes entirely from type weight, generous whitespace and hairline borders. The homepage is a wall of small, live component demos arranged in a masonry of soft-cornered cards — the chrome disappears so the components themselves do the talking. Only code blocks break the grayscale, where a GitHub-dark syntax palette (mint, periwinkle, coral, apricot) glows against near-black.
Technically it's one family doing almost everything: Geist at 400/500/600 for UI and prose, Geist Mono at 14px for code, commands and tab triggers. The display headline is 48px/1.1 at weight 600 with an aggressive −0.05em tracking; body prose runs 15px with a roomy 1.75 line-height. Colour is a ten-step neutral ramp built on lab() tokens — #ffffff page, #f7f7f7 surface, #e8e8e8 borders, #7a7a7a muted text, #000000 primary. Radii cluster at 8px (--radius 0.625rem) with 18px pills for chips and inputs; shadows are almost entirely absent, replaced by a 1px inset ring at 5% black. Spacing is an 8px grid — 8/12/16/24 inside cards, 40–80px between sections — inside a 1400px max container.
Tokens — Colors
| Name |
Value |
Token |
Role |
| Paper White |
#ffffff |
--color-background |
Page background, nav bar, card fills; the overwhelmingly dominant surface |
| Ash Surface |
#f7f7f7 |
--color-surface |
Inset panels, stat tiles, sidebar hover states, code block chrome |
| Mute Fill |
#f5f5f5 |
--color-muted-accent |
Muted/accent background for secondary buttons, badges, input fills, active sidebar items |
| Hairline |
#e8e8e8 |
--color-border |
1px card, input and divider borders; the only structural separator used |
| Ink Black |
#000000 |
--color-foreground-primary |
All headings and body text; primary button and badge fill |
| Graphite |
#141414 |
--color-secondary-foreground |
Sidebar primary, chart bar darkest step, high-contrast labels on light fills |
| Slate Muted |
#7a7a7a |
--color-muted-foreground |
Descriptions, placeholders, captions, chart axis labels, inactive nav |
| Fog Grey |
#a0a0a0 |
--color-ring |
Focus ring, disabled text, lightest chart bar step |
| Mint Terminal |
#99ffe4 |
--color-code-string |
Strings in code blocks on the dark code surface; the largest non-neutral area on the site |
| Periwinkle Keyword |
#9ecbff |
--color-code-keyword |
Keywords and identifiers in syntax highlighting |
| Coral Signal |
#f97583 |
--color-code-error |
Syntax tags/errors and failed-step markers in trace components |
| Apricot Const |
#ffc799 |
--color-code-number |
Numbers and constants in code; also warning-adjacent accents |
Semantic roles
| Role |
Value |
| background |
#ffffff |
| surface |
#f7f7f7 |
| surface raised |
#ffffff |
| border |
#e8e8e8 |
| text |
#000000 |
| text muted |
#7a7a7a |
| primary |
#000000 |
| primary text |
#fafafa |
| accent |
#99ffe4 |
| success |
#99ffe4 |
| warning |
#ffc799 |
| danger |
#f97583 |
Tokens — Typography
- Display: Geist (500, 600, 700) — fallbacks: Inter, system-ui, -apple-system, sans-serif. Headlines use 600 with tight negative tracking (−0.05em at 48px, −0.025em at 30px). Never go above 700.
- Body: Geist (400, 500, 600) — fallbacks: Inter, system-ui, -apple-system, sans-serif. Same family as display; 400 for prose, 500 for UI labels, nav and links, 600 for inline strong.
- Mono: Geist Mono (400, 500, 600) — fallbacks: JetBrains Mono, SFMono-Regular, ui-monospace, monospace. 14px for code blocks, package-manager tabs, inline code chips and copy buttons. Normal tracking.
| Role |
Size |
Line height |
Weight |
Letter spacing |
Family |
| Display |
48px |
1.1 |
600 |
-0.05em |
display |
| H1 (page) |
30px |
1.2 |
600 |
-0.025em |
display |
| H2 |
20px |
1.4 |
600 |
-0.025em |
display |
| H3 / Card title |
16px |
1.5 |
600 |
normal |
body |
| Lead |
18px |
1.56 |
400 |
normal |
body |
| Body / Prose |
15px |
1.75 |
400 |
normal |
body |
| UI label / Nav |
14px |
1.43 |
500 |
normal |
body |
| Caption |
12px |
1.33 |
500 |
0.02em |
body |
| Mono / Code |
14px |
1.63 |
400 |
normal |
mono |
Tokens — Spacing & Layout
- Base unit: 4px (8px is the dominant step)
- Density: comfortable
- Container max width: 1400px
- Section gap: 48px–80px
- Card padding: 16px–24px
- Scale: 2px, 4px, 6px, 8px, 12px, 16px, 20px, 24px, 32px, 40px, 48px, 80px
Tokens — Radius
| Element |
Value |
| Cards, code blocks, buttons (default), tab triggers |
8px |
| Base token --radius |
10px (0.625rem) |
| Chips, pill buttons, textarea, chat composer |
18px |
| Sidebar/menu items and small list buttons |
20px |
| Large panels and dialogs |
24px |
| Toggles, avatars, dots |
9999px |
Tokens — Shadows
| Name |
Value |
Usage |
| none |
none |
Default for nav, sidebar, inline buttons and most surfaces — structure comes from 1px borders, not depth. |
| ring-hairline |
0 0 0 1px rgba(0,0,0,0.05) |
Inset ring on cards and inputs, often instead of a border. |
| card |
0 0 0 1px rgba(0,0,0,0.05), 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px -1px rgba(0,0,0,0.1) |
Floating cards, popovers, the sticky nav 'New' button and dropdown menus. |
Components
Primary button (button)
| Property |
Value |
| background |
#000000 |
| color |
#fafafa |
| border |
none |
| radius |
8px |
| padding |
0 16px |
| font size |
14px |
| font weight |
500 |
| shadow |
0 0 0 1px rgba(0,0,0,0.05) |
| hover |
background lightens to #1f1f1f; no lift, no scale |
Height 36–40px. Hero CTA ('Get Started') and in-card actions ('Create Goal', 'View Full Report') use a full-width or auto-width black pill-rect. On the hero the radius reads fully rounded (18px+); inside cards it is 8px.
Secondary / outline button (button)
| Property |
Value |
| background |
#ffffff |
| color |
#000000 |
| border |
1px solid #e8e8e8 |
| radius |
8px |
| padding |
0 16px |
| font size |
14px |
| font weight |
500 |
| shadow |
none |
| hover |
background #f5f5f5 |
'View Components', 'Cancel', 'Deploy Now', 'Open shadcn/create'. A ghost variant drops the border entirely and relies on the #f5f5f5 hover fill — used for sidebar items and icon buttons.
Chip / tab trigger (badge)
| Property |
Value |
| background |
#f5f5f5 |
| color |
#141414 |
| border |
none |
| radius |
18px |
| padding |
0 10px |
| font size |
14px |
| font weight |
500 |
| shadow |
none |
| hover |
background #ececec |
32px tall pills used for demo variants ('Secondary', 'Outline') and the announcement banner. Active state inverts to #000000 bg / #fafafa text. Package-manager tabs ('pnpm', 'npm') use the same shape at 28px with Geist Mono 14px/500 and 2px 8px padding.
Input (input)
| Property |
Value |
| background |
#f5f5f5 |
| color |
#000000 |
| border |
1px solid transparent |
| radius |
10px |
| padding |
4px 10px |
| font size |
14px |
| font weight |
400 |
| shadow |
0 0 0 1px rgba(0,0,0,0.05) |
| hover |
border #e8e8e8 |
32px tall; placeholder in #7a7a7a. Textareas and the chat composer go to 18px radius with 8px 10px padding and ~64px min-height. Focus: 2px ring in #a0a0a0 with 2px offset. Search field in the nav is 36px tall, #f5f5f5, 8px radius, 240–280px wide.
Demo card (card)
| Property |
Value |
| background |
#ffffff |
| color |
#000000 |
| border |
1px solid #e8e8e8 |
| radius |
16px |
| padding |
20px 24px |
| font size |
14px |
| font weight |
400 |
| shadow |
none |
| hover |
none — cards are static containers |
The homepage is a 4-column masonry of these. Title 16px/600, description 14px/400 in #7a7a7a, 8px gap between header and body. Inset sub-tiles (stat blocks, list rows) use #f7f7f7 fill with 8px radius and no border.
Top navigation (nav)
| Property |
Value |
| background |
#ffffff |
| color |
#000000 |
| border |
none |
| radius |
0 |
| padding |
0 24px |
| font size |
14px |
| font weight |
500 |
| shadow |
none |
| hover |
link colour fades to #7a7a7a |
64px tall, sticky, no border or backdrop blur. Left: wordmark-less link row with 20–24px gaps. Right: search field, GitHub star count in #7a7a7a, theme toggle icon, then a black 'New' button with a + glyph. Thin vertical #e8e8e8 dividers separate right-hand clusters.
Docs sidebar item (link)
| Property |
Value |
| background |
transparent |
| color |
#7a7a7a |
| border |
none |
| radius |
20px |
| padding |
6px 10px |
| font size |
14px |
| font weight |
400 |
| shadow |
none |
| hover |
background #f5f5f5, colour #000000 |
Grouped under 12px/500 uppercase-ish section labels in #7a7a7a. Active item gets #f5f5f5 fill and #000000 text at weight 500. The whole rail sits against a 1px #e8e8e8 right border.
Code block (other)
| Property |
Value |
| background |
#0a0a0a |
| color |
#e1e4e8 |
| border |
1px solid rgba(255,255,255,0.1) |
| radius |
8px |
| padding |
16px |
| font size |
14px |
| font weight |
400 |
| shadow |
none |
| hover |
copy button appears at top-right with #f5f5f5/10 fill |
The only dark surface in the light theme. Syntax: strings #99ffe4, keywords #9ecbff, tags/errors #f97583, numbers #ffc799, functions #b392f0, links #79b8ff, plain text #e1e4e8. Header row holds mono package-manager tabs and a copy icon.
Layout
A 1400px max container centred on white. The marketing page opens with a centred hero stack — small pill announcement, 48px display headline, 18px lead capped around 620px, then two inline CTAs — followed by a dense four-column masonry of live component cards with 24px gutters and no section headings; the components are the content. Docs pages switch to a three-column frame: a ~240px left sidebar with a hairline right border, a ~600px measure content column, and a ~200px 'On This Page' rail plus a sticky promo card. Vertical rhythm inside prose is tight (16–24px between blocks) while sections breathe at 48–80px.
Imagery
No photography or illustration. Visual interest comes entirely from live UI: miniature dashboards, bar charts drawn as flat grey rectangles in a four-step ramp (#e8e8e8 → #141414), a black-and-white QR code, progress bars, toggles and chat bubbles. Icons are thin 1.5px-stroke line glyphs at 16px, inheriting text colour. Screenshots of the product are never used — the product is rendered inline.
Motion
Restrained and functional. Hovers are instant background-fill swaps (150ms ease) with no transform; dropdowns and dialogs fade+scale from 96% over ~150ms; the chat/trace demos use a subtle shimmer on pending states. No parallax, no scroll-triggered reveals, no gradient animation.
Responsive
Below ~1024px the docs sidebar and 'On This Page' rail disappear into a hamburger. The top bar collapses to a large 'Menu' affordance at the left (icon + 24px label), keeping the GitHub count, theme toggle and black 'New' button on the right at 64px height. Tapping it opens a full-screen overlay sheet over a blurred page, listing links as 28px/600 Geist stacked rows at ~34px rhythm, grouped under 14px #7a7a7a 'Menu' and 'Sections' labels — a scale jump that exists only on mobile. The hero stacks and the display headline drops to roughly 40px with the same −0.05em tracking; the lead paragraph wraps to four lines; the two CTAs stay side-by-side as auto-width pills rather than going full-width. The component masonry becomes a horizontally scrolling / single-column stack with 16px side gutters, and cards keep their 16px radius while padding tightens to 12–16px.
Do
- Build structure with 1px #e8e8e8 borders and #f7f7f7 inset fills, not drop shadows.
- Set display type at weight 600 with −0.05em tracking; keep body prose at 15px/1.75 for long-form docs.
- Reserve pure #000000 for text and primary actions — it is the only saturated-feeling value in the UI.
- Use Geist Mono 14px for every command, package name, inline code chip and tab trigger.
- Keep radii on the 8px / 18px pair: 8px for rectangles, 18–20px pills for chips, inputs and list items.
- Let colour appear only inside dark code blocks, using the mint/periwinkle/coral/apricot syntax set.
Don't
- Don't introduce brand hues in buttons, links or headers — the chrome stays strictly grayscale.
- Don't stack elevation; a card with a border should not also carry a visible shadow.
- Don't use letter-spacing above 0 on headings, or positive tracking anywhere except 12px captions.
- Don't fill cards with stock photography or illustration — show working components instead.
- Don't animate on scroll or add gradient washes; motion is limited to hover fills and 150ms fades.
- Don't let body prose exceed ~640px measure or drop below 1.75 line-height in documentation.
Agent prompt
Build a pure-white, monochrome developer-documentation UI in the shadcn/ui register. Load Geist (400/500/600/700) for everything and Geist Mono (400/500) for code; fall back to Inter and JetBrains Mono. Palette: background #ffffff, inset surface #f7f7f7, muted fill #f5f5f5, hairline border #e8e8e8, text #000000, muted text #7a7a7a, focus ring #a0a0a0, primary #000000 with #fafafa text — no brand hue anywhere in the chrome. The only colour lives inside dark code blocks (#0a0a0a background, text #e1e4e8, strings #99ffe4, keywords #9ecbff, errors #f97583, numbers #ffc799, functions #b392f0). Type: display 48px/1.1 weight 600 tracking −0.05em; page H1 30px/1.2 weight 600 tracking −0.025em; H2 20px/1.4/600; card title 16px/1.5/600; lead 18px/1.56/400; prose 15px/1.75/400; UI labels and nav links 14px/1.43/500; mono 14px/1.63/400. Spacing on a 4px grid dominated by 8px steps (8/12/16/20/24/40/48/80) inside a 1400px container; cards padded 20–24px with 24px gutters. Radii: --radius 10px, 8px on cards/buttons/code blocks, 18–20px pills for chips, inputs, textareas and sidebar items, 9999px for toggles. Shadows are essentially absent — use 1px #e8e8e8 borders or an inset 0 0 0 1px rgba(0,0,0,0.05) ring; only floating popovers get 0 1px 3px rgba(0,0,0,0.1). Components: black 8px-radius primary button (14px/500, 36–40px tall), white bordered secondary, ghost button with #f5f5f5 hover, 32px #f5f5f5 input with #7a7a7a placeholder, white bordered demo card with 16px/600 title and 14px #7a7a7a description, and a 64px sticky white nav with no border carrying 14px/500 links, a #f5f5f5 search field, GitHub star count and a black '+ New' button. Lay the landing page out as a centred hero (pill announcement, display headline, 620px lead, two inline CTAs) above a four-column masonry of live component demos; docs pages use a 240px bordered sidebar, ~600px content measure and a 200px 'On This Page' rail. On mobile collapse the nav into a 'Menu' button that opens a full-screen overlay of 28px/600 stacked links grouped by 14px #7a7a7a labels. Motion: 150ms background-fill hovers and fade+scale dialogs only.
CSS custom properties
/* Ui — CSS custom properties. Generated from style.json */
:root {
/* Palette */
--color-background: #ffffff; /* Page background, nav bar, card fills; the overwhelmingly dominant surface */
--color-surface: #f7f7f7; /* Inset panels, stat tiles, sidebar hover states, code block chrome */
--color-muted-accent: #f5f5f5; /* Muted/accent background for secondary buttons, badges, input fills, active sidebar items */
--color-border: #e8e8e8; /* 1px card, input and divider borders; the only structural separator used */
--color-foreground-primary: #000000; /* All headings and body text; primary button and badge fill */
--color-secondary-foreground: #141414; /* Sidebar primary, chart bar darkest step, high-contrast labels on light fills */
--color-muted-foreground: #7a7a7a; /* Descriptions, placeholders, captions, chart axis labels, inactive nav */
--color-ring: #a0a0a0; /* Focus ring, disabled text, lightest chart bar step */
--color-code-string: #99ffe4; /* Strings in code blocks on the dark code surface; the largest non-neutral area on the site */
--color-code-keyword: #9ecbff; /* Keywords and identifiers in syntax highlighting */
--color-code-error: #f97583; /* Syntax tags/errors and failed-step markers in trace components */
--color-code-number: #ffc799; /* Numbers and constants in code; also warning-adjacent accents */
/* Semantic roles */
--background: #ffffff;
--surface: #f7f7f7;
--surface-raised: #ffffff;
--border: #e8e8e8;
--text: #000000;
--text-muted: #7a7a7a;
--primary: #000000;
--primary-text: #fafafa;
--accent: #99ffe4;
--success: #99ffe4;
--warning: #ffc799;
--danger: #f97583;
/* Typography */
--font-display: Geist, Inter, system-ui, -apple-system, sans-serif;
--font-body: Geist, Inter, system-ui, -apple-system, sans-serif;
--font-mono: 'Geist Mono', 'JetBrains Mono', SFMono-Regular, ui-monospace, monospace;
--text-display: 48px;
--text-display--line-height: 1.1;
--text-display--letter-spacing: -0.05em;
--text-display--font-weight: 600;
--text-h1-page: 30px;
--text-h1-page--line-height: 1.2;
--text-h1-page--letter-spacing: -0.025em;
--text-h1-page--font-weight: 600;
--text-h2: 20px;
--text-h2--line-height: 1.4;
--text-h2--letter-spacing: -0.025em;
--text-h2--font-weight: 600;
--text-h3-card-title: 16px;
--text-h3-card-title--line-height: 1.5;
--text-h3-card-title--letter-spacing: normal;
--text-h3-card-title--font-weight: 600;
--text-lead: 18px;
--text-lead--line-height: 1.56;
--text-lead--letter-spacing: normal;
--text-lead--font-weight: 400;
--text-body-prose: 15px;
--text-body-prose--line-height: 1.75;
--text-body-prose--letter-spacing: normal;
--text-body-prose--font-weight: 400;
--text-ui-label-nav: 14px;
--text-ui-label-nav--line-height: 1.43;
--text-ui-label-nav--letter-spacing: normal;
--text-ui-label-nav--font-weight: 500;
--text-caption: 12px;
--text-caption--line-height: 1.33;
--text-caption--letter-spacing: 0.02em;
--text-caption--font-weight: 500;
--text-mono-code: 14px;
--text-mono-code--line-height: 1.63;
--text-mono-code--letter-spacing: normal;
--text-mono-code--font-weight: 400;
/* Spacing */
--space-1: 2px;
--space-2: 4px;
--space-3: 6px;
--space-4: 8px;
--space-5: 12px;
--space-6: 16px;
--space-7: 20px;
--space-8: 24px;
--space-9: 32px;
--space-10: 40px;
--space-11: 48px;
--space-12: 80px;
--container: 1400px;
--section-gap: 48px–80px;
/* Radius */
--radius-cards-code-blocks-buttons-default-tab-triggers: 8px;
--radius-base-token-radius: 10px (0.625rem);
--radius-chips-pill-buttons-textarea-chat-composer: 18px;
--radius-sidebar-menu-items-and-small-list-buttons: 20px;
--radius-large-panels-and-dialogs: 24px;
--radius-toggles-avatars-dots: 9999px;
/* Shadows */
--shadow-none: none;
--shadow-ring-hairline: 0 0 0 1px rgba(0,0,0,0.05);
--shadow-card: 0 0 0 1px rgba(0,0,0,0.05), 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px -1px rgba(0,0,0,0.1);
}
Tailwind v4 theme
/* Ui — Tailwind CSS v4 theme. Import after tailwindcss: @import "tailwindcss"; then paste this block. */
@theme {
--color-background: #ffffff;
--color-surface: #f7f7f7;
--color-muted-accent: #f5f5f5;
--color-border: #e8e8e8;
--color-foreground-primary: #000000;
--color-secondary-foreground: #141414;
--color-muted-foreground: #7a7a7a;
--color-ring: #a0a0a0;
--color-code-string: #99ffe4;
--color-code-keyword: #9ecbff;
--color-code-error: #f97583;
--color-code-number: #ffc799;
--color-background: #ffffff;
--color-surface: #f7f7f7;
--color-surface-raised: #ffffff;
--color-border: #e8e8e8;
--color-text: #000000;
--color-text-muted: #7a7a7a;
--color-primary: #000000;
--color-primary-text: #fafafa;
--color-accent: #99ffe4;
--color-success: #99ffe4;
--color-warning: #ffc799;
--color-danger: #f97583;
--font-display: Geist, Inter, system-ui, -apple-system, sans-serif;
--font-body: Geist, Inter, system-ui, -apple-system, sans-serif;
--font-mono: 'Geist Mono', 'JetBrains Mono', SFMono-Regular, ui-monospace, monospace;
--text-display: 48px;
--text-display--line-height: 1.1;
--text-display--letter-spacing: -0.05em;
--text-display--font-weight: 600;
--text-h1-page: 30px;
--text-h1-page--line-height: 1.2;
--text-h1-page--letter-spacing: -0.025em;
--text-h1-page--font-weight: 600;
--text-h2: 20px;
--text-h2--line-height: 1.4;
--text-h2--letter-spacing: -0.025em;
--text-h2--font-weight: 600;
--text-h3-card-title: 16px;
--text-h3-card-title--line-height: 1.5;
--text-h3-card-title--letter-spacing: normal;
--text-h3-card-title--font-weight: 600;
--text-lead: 18px;
--text-lead--line-height: 1.56;
--text-lead--letter-spacing: normal;
--text-lead--font-weight: 400;
--text-body-prose: 15px;
--text-body-prose--line-height: 1.75;
--text-body-prose--letter-spacing: normal;
--text-body-prose--font-weight: 400;
--text-ui-label-nav: 14px;
--text-ui-label-nav--line-height: 1.43;
--text-ui-label-nav--letter-spacing: normal;
--text-ui-label-nav--font-weight: 500;
--text-caption: 12px;
--text-caption--line-height: 1.33;
--text-caption--letter-spacing: 0.02em;
--text-caption--font-weight: 500;
--text-mono-code: 14px;
--text-mono-code--line-height: 1.63;
--text-mono-code--letter-spacing: normal;
--text-mono-code--font-weight: 400;
--radius-cards-code-blocks-buttons-default-tab-triggers: 8px;
--radius-base-token-radius: 10px (0.625rem);
--radius-chips-pill-buttons-textarea-chat-composer: 18px;
--radius-sidebar-menu-items-and-small-list-buttons: 20px;
--radius-large-panels-and-dialogs: 24px;
--radius-toggles-avatars-dots: 9999px;
--shadow-none: none;
--shadow-ring-hairline: 0 0 0 1px rgba(0,0,0,0.05);
--shadow-card: 0 0 0 1px rgba(0,0,0,0.05), 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px -1px rgba(0,0,0,0.1);
--container-site: 1400px;
}
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.
/* Ui — 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. Dark mode: estimated — the site has no dark scheme, so the .dark half is a plausible twin of its palette. */
@custom-variant dark (&:where(.dark, .dark *));
:root {
color-scheme: light;
--background: #ffffff;
--foreground: #000000;
--card: #ffffff;
--card-foreground: #000000;
--popover: #ffffff;
--popover-foreground: #000000;
--primary: #000000;
--primary-foreground: #fafafa;
--secondary: #f7f7f7;
--secondary-foreground: #000000;
--muted: #f7f7f7;
--muted-foreground: #7a7a7a;
--accent: #99ffe4;
--accent-foreground: #0a0a0a; /* estimated */
--destructive: #f97583;
--destructive-foreground: #ffffff; /* estimated */
--border: #e8e8e8;
--input: #e8e8e8; /* estimated */
--ring: #a1a1a1; /* estimated */
--radius-small: 8px;
--radius-medium: 18px;
--radius-large: 24px;
--radius: var(--radius-medium);
--font-display: Geist, Inter, system-ui, -apple-system, sans-serif;
--font-body: Geist, Inter, system-ui, -apple-system, sans-serif;
--font-mono: 'Geist Mono', 'JetBrains Mono', SFMono-Regular, ui-monospace, monospace;
}
.dark {
color-scheme: dark;
/* estimated from the light palette */
--background: #141414;
--foreground: #ffffff;
--card: #202020;
--card-foreground: #ffffff;
--popover: #202020;
--popover-foreground: #ffffff;
--primary: #ffffff;
--primary-foreground: #0a0a0a;
--secondary: #2c2c2c;
--secondary-foreground: #ffffff;
--muted: #2c2c2c;
--muted-foreground: #a6a6a6;
--accent: #99ffe4;
--accent-foreground: #0a0a0a;
--destructive: #ff6467;
--destructive-foreground: #ffffff;
--border: rgba(255, 255, 255, 0.1);
--input: rgba(255, 255, 255, 0.15);
--ring: #7e7e7e;
}
@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);
}
Ui — Style Reference
quiet grayscale instrument for builders
Theme: light · Mood: light, minimal, technical, precise, monochrome, typographic
A pure-white, near-monochrome documentation and component showcase where hierarchy comes entirely from type weight, generous whitespace and hairline borders. The homepage is a wall of small, live component demos arranged in a masonry of soft-cornered cards — the chrome disappears so the components themselves do the talking. Only code blocks break the grayscale, where a GitHub-dark syntax palette (mint, periwinkle, coral, apricot) glows against near-black.
Tokens — Colors
| Name |
Value |
Token |
Role |
| Paper White |
#ffffff |
--background |
Page background, nav bar, card fills; the overwhelmingly dominant surface |
| Ash Surface |
#f7f7f7 |
--surface |
Inset panels, stat tiles, sidebar hover states, code block chrome |
| Mute Fill |
#f5f5f5 |
--muted / --accent |
Muted/accent background for secondary buttons, badges, input fills, active sidebar items |
| Hairline |
#e8e8e8 |
--border |
1px card, input and divider borders; the only structural separator used |
| Ink Black |
#000000 |
--foreground / --primary |
All headings and body text; primary button and badge fill |
| Graphite |
#141414 |
--secondary-foreground |
Sidebar primary, chart bar darkest step, high-contrast labels on light fills |
| Slate Muted |
#7a7a7a |
--muted-foreground |
Descriptions, placeholders, captions, chart axis labels, inactive nav |
| Fog Grey |
#a0a0a0 |
--ring |
Focus ring, disabled text, lightest chart bar step |
| Mint Terminal |
#99ffe4 |
--code-string |
Strings in code blocks on the dark code surface; the largest non-neutral area on the site |
| Periwinkle Keyword |
#9ecbff |
--code-keyword |
Keywords and identifiers in syntax highlighting |
| Coral Signal |
#f97583 |
--code-error |
Syntax tags/errors and failed-step markers in trace components |
| Apricot Const |
#ffc799 |
--code-number |
Numbers and constants in code; also warning-adjacent accents |
Tokens — Typography
- Display: Geist (Inter, system-ui, -apple-system, sans-serif) — weights 500/600/700
- Body: Geist (Inter, system-ui, -apple-system, sans-serif) — weights 400/500/600
- Mono: Geist Mono (JetBrains Mono, SFMono-Regular, ui-monospace, monospace) — weights 400/500/600
Tokens — Radius
| Element |
Value |
| Cards, code blocks, buttons (default), tab triggers |
8px |
| Base token --radius |
10px (0.625rem) |
| Chips, pill buttons, textarea, chat composer |
18px |
| Sidebar/menu items and small list buttons |
20px |
| Large panels and dialogs |
24px |
| Toggles, avatars, dots |
9999px |
Do
- Build structure with 1px #e8e8e8 borders and #f7f7f7 inset fills, not drop shadows.
- Set display type at weight 600 with −0.05em tracking; keep body prose at 15px/1.75 for long-form docs.
- Reserve pure #000000 for text and primary actions — it is the only saturated-feeling value in the UI.
- Use Geist Mono 14px for every command, package name, inline code chip and tab trigger.
- Keep radii on the 8px / 18px pair: 8px for rectangles, 18–20px pills for chips, inputs and list items.
- Let colour appear only inside dark code blocks, using the mint/periwinkle/coral/apricot syntax set.
Don't
- Don't introduce brand hues in buttons, links or headers — the chrome stays strictly grayscale.
- Don't stack elevation; a card with a border should not also carry a visible shadow.
- Don't use letter-spacing above 0 on headings, or positive tracking anywhere except 12px captions.
- Don't fill cards with stock photography or illustration — show working components instead.
- Don't animate on scroll or add gradient washes; motion is limited to hover fills and 150ms fades.
- Don't let body prose exceed ~640px measure or drop below 1.75 line-height in documentation.
{
"$name": "Ui",
"$source": "https://ui.shadcn.com",
"$theme": "light",
"$generated": "inspiration library",
"color": {
"background": {
"$type": "color",
"$value": "#ffffff",
"$description": "Page background, nav bar, card fills; the overwhelmingly dominant surface"
},
"surface": {
"$type": "color",
"$value": "#f7f7f7",
"$description": "Inset panels, stat tiles, sidebar hover states, code block chrome"
},
"muted-accent": {
"$type": "color",
"$value": "#f5f5f5",
"$description": "Muted/accent background for secondary buttons, badges, input fills, active sidebar items"
},
"border": {
"$type": "color",
"$value": "#e8e8e8",
"$description": "1px card, input and divider borders; the only structural separator used"
},
"foreground-primary": {
"$type": "color",
"$value": "#000000",
"$description": "All headings and body text; primary button and badge fill"
},
"secondary-foreground": {
"$type": "color",
"$value": "#141414",
"$description": "Sidebar primary, chart bar darkest step, high-contrast labels on light fills"
},
"muted-foreground": {
"$type": "color",
"$value": "#7a7a7a",
"$description": "Descriptions, placeholders, captions, chart axis labels, inactive nav"
},
"ring": {
"$type": "color",
"$value": "#a0a0a0",
"$description": "Focus ring, disabled text, lightest chart bar step"
},
"code-string": {
"$type": "color",
"$value": "#99ffe4",
"$description": "Strings in code blocks on the dark code surface; the largest non-neutral area on the site"
},
"code-keyword": {
"$type": "color",
"$value": "#9ecbff",
"$description": "Keywords and identifiers in syntax highlighting"
},
"code-error": {
"$type": "color",
"$value": "#f97583",
"$description": "Syntax tags/errors and failed-step markers in trace components"
},
"code-number": {
"$type": "color",
"$value": "#ffc799",
"$description": "Numbers and constants in code; also warning-adjacent accents"
}
},
"role": {
"background": {
"$type": "color",
"$value": "#ffffff"
},
"surface": {
"$type": "color",
"$value": "#f7f7f7"
},
"surface_raised": {
"$type": "color",
"$value": "#ffffff"
},
"border": {
"$type": "color",
"$value": "#e8e8e8"
},
"text": {
"$type": "color",
"$value": "#000000"
},
"text_muted": {
"$type": "color",
"$value": "#7a7a7a"
},
"primary": {
"$type": "color",
"$value": "#000000"
},
"primary_text": {
"$type": "color",
"$value": "#fafafa"
},
"accent": {
"$type": "color",
"$value": "#99ffe4"
},
"success": {
"$type": "color",
"$value": "#99ffe4"
},
"warning": {
"$type": "color",
"$value": "#ffc799"
},
"danger": {
"$type": "color",
"$value": "#f97583"
}
},
"fontFamily": {
"display": {
"$type": "fontFamily",
"$value": [
"Geist",
"Inter",
"system-ui",
"-apple-system",
"sans-serif"
],
"$description": "Headlines use 600 with tight negative tracking (−0.05em at 48px, −0.025em at 30px). Never go above 700."
},
"body": {
"$type": "fontFamily",
"$value": [
"Geist",
"Inter",
"system-ui",
"-apple-system",
"sans-serif"
],
"$description": "Same family as display; 400 for prose, 500 for UI labels, nav and links, 600 for inline strong."
},
"mono": {
"$type": "fontFamily",
"$value": [
"Geist Mono",
"JetBrains Mono",
"SFMono-Regular",
"ui-monospace",
"monospace"
],
"$description": "14px for code blocks, package-manager tabs, inline code chips and copy buttons. Normal tracking."
}
},
"typography": {
"display": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "48px",
"lineHeight": "1.1",
"fontWeight": 600,
"letterSpacing": "-0.05em"
}
},
"h1-page": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "30px",
"lineHeight": "1.2",
"fontWeight": 600,
"letterSpacing": "-0.025em"
}
},
"h2": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.display}",
"fontSize": "20px",
"lineHeight": "1.4",
"fontWeight": 600,
"letterSpacing": "-0.025em"
}
},
"h3-card-title": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "16px",
"lineHeight": "1.5",
"fontWeight": 600,
"letterSpacing": "normal"
}
},
"lead": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "18px",
"lineHeight": "1.56",
"fontWeight": 400,
"letterSpacing": "normal"
}
},
"body-prose": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "15px",
"lineHeight": "1.75",
"fontWeight": 400,
"letterSpacing": "normal"
}
},
"ui-label-nav": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "14px",
"lineHeight": "1.43",
"fontWeight": 500,
"letterSpacing": "normal"
}
},
"caption": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.body}",
"fontSize": "12px",
"lineHeight": "1.33",
"fontWeight": 500,
"letterSpacing": "0.02em"
}
},
"mono-code": {
"$type": "typography",
"$value": {
"fontFamily": "{fontFamily.mono}",
"fontSize": "14px",
"lineHeight": "1.63",
"fontWeight": 400,
"letterSpacing": "normal"
}
}
},
"spacing": {
"1": {
"$type": "dimension",
"$value": "2px"
},
"2": {
"$type": "dimension",
"$value": "4px"
},
"3": {
"$type": "dimension",
"$value": "6px"
},
"4": {
"$type": "dimension",
"$value": "8px"
},
"5": {
"$type": "dimension",
"$value": "12px"
},
"6": {
"$type": "dimension",
"$value": "16px"
},
"7": {
"$type": "dimension",
"$value": "20px"
},
"8": {
"$type": "dimension",
"$value": "24px"
},
"9": {
"$type": "dimension",
"$value": "32px"
},
"10": {
"$type": "dimension",
"$value": "40px"
},
"11": {
"$type": "dimension",
"$value": "48px"
},
"12": {
"$type": "dimension",
"$value": "80px"
}
},
"radius": {
"cards-code-blocks-buttons-default-tab-triggers": {
"$type": "dimension",
"$value": "8px"
},
"base-token-radius": {
"$type": "dimension",
"$value": "10px (0.625rem)"
},
"chips-pill-buttons-textarea-chat-composer": {
"$type": "dimension",
"$value": "18px"
},
"sidebar-menu-items-and-small-list-buttons": {
"$type": "dimension",
"$value": "20px"
},
"large-panels-and-dialogs": {
"$type": "dimension",
"$value": "24px"
},
"toggles-avatars-dots": {
"$type": "dimension",
"$value": "9999px"
}
},
"shadow": {
"none": {
"$type": "shadow",
"$value": "none",
"$description": "Default for nav, sidebar, inline buttons and most surfaces — structure comes from 1px borders, not depth."
},
"ring-hairline": {
"$type": "shadow",
"$value": "0 0 0 1px rgba(0,0,0,0.05)",
"$description": "Inset ring on cards and inputs, often instead of a border."
},
"card": {
"$type": "shadow",
"$value": "0 0 0 1px rgba(0,0,0,0.05), 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px -1px rgba(0,0,0,0.1)",
"$description": "Floating cards, popovers, the sticky nav 'New' button and dropdown menus."
}
},
"component": {
"primary-button": {
"kind": "button",
"background": "#000000",
"color": "#fafafa",
"border": "none",
"radius": "8px",
"padding": "0 16px",
"font_size": "14px",
"font_weight": 500,
"shadow": "0 0 0 1px rgba(0,0,0,0.05)",
"hover": "background lightens to #1f1f1f; no lift, no scale",
"notes": "Height 36–40px. Hero CTA ('Get Started') and in-card actions ('Create Goal', 'View Full Report') use a full-width or auto-width black pill-rect. On the hero the radius reads fully rounded (18px+); inside cards it is 8px."
},
"secondary-outline-button": {
"kind": "button",
"background": "#ffffff",
"color": "#000000",
"border": "1px solid #e8e8e8",
"radius": "8px",
"padding": "0 16px",
"font_size": "14px",
"font_weight": 500,
"shadow": "none",
"hover": "background #f5f5f5",
"notes": "'View Components', 'Cancel', 'Deploy Now', 'Open shadcn/create'. A ghost variant drops the border entirely and relies on the #f5f5f5 hover fill — used for sidebar items and icon buttons."
},
"chip-tab-trigger": {
"kind": "badge",
"background": "#f5f5f5",
"color": "#141414",
"border": "none",
"radius": "18px",
"padding": "0 10px",
"font_size": "14px",
"font_weight": 500,
"shadow": "none",
"hover": "background #ececec",
"notes": "32px tall pills used for demo variants ('Secondary', 'Outline') and the announcement banner. Active state inverts to #000000 bg / #fafafa text. Package-manager tabs ('pnpm', 'npm') use the same shape at 28px with Geist Mono 14px/500 and 2px 8px padding."
},
"input": {
"kind": "input",
"background": "#f5f5f5",
"color": "#000000",
"border": "1px solid transparent",
"radius": "10px",
"padding": "4px 10px",
"font_size": "14px",
"font_weight": 400,
"shadow": "0 0 0 1px rgba(0,0,0,0.05)",
"hover": "border #e8e8e8",
"notes": "32px tall; placeholder in #7a7a7a. Textareas and the chat composer go to 18px radius with 8px 10px padding and ~64px min-height. Focus: 2px ring in #a0a0a0 with 2px offset. Search field in the nav is 36px tall, #f5f5f5, 8px radius, 240–280px wide."
},
"demo-card": {
"kind": "card",
"background": "#ffffff",
"color": "#000000",
"border": "1px solid #e8e8e8",
"radius": "16px",
"padding": "20px 24px",
"font_size": "14px",
"font_weight": 400,
"shadow": "none",
"hover": "none — cards are static containers",
"notes": "The homepage is a 4-column masonry of these. Title 16px/600, description 14px/400 in #7a7a7a, 8px gap between header and body. Inset sub-tiles (stat blocks, list rows) use #f7f7f7 fill with 8px radius and no border."
},
"top-navigation": {
"kind": "nav",
"background": "#ffffff",
"color": "#000000",
"border": "none",
"radius": "0",
"padding": "0 24px",
"font_size": "14px",
"font_weight": 500,
"shadow": "none",
"hover": "link colour fades to #7a7a7a",
"notes": "64px tall, sticky, no border or backdrop blur. Left: wordmark-less link row with 20–24px gaps. Right: search field, GitHub star count in #7a7a7a, theme toggle icon, then a black 'New' button with a + glyph. Thin vertical #e8e8e8 dividers separate right-hand clusters."
},
"docs-sidebar-item": {
"kind": "link",
"background": "transparent",
"color": "#7a7a7a",
"border": "none",
"radius": "20px",
"padding": "6px 10px",
"font_size": "14px",
"font_weight": 400,
"shadow": "none",
"hover": "background #f5f5f5, colour #000000",
"notes": "Grouped under 12px/500 uppercase-ish section labels in #7a7a7a. Active item gets #f5f5f5 fill and #000000 text at weight 500. The whole rail sits against a 1px #e8e8e8 right border."
},
"code-block": {
"kind": "other",
"background": "#0a0a0a",
"color": "#e1e4e8",
"border": "1px solid rgba(255,255,255,0.1)",
"radius": "8px",
"padding": "16px",
"font_size": "14px",
"font_weight": 400,
"shadow": "none",
"hover": "copy button appears at top-right with #f5f5f5/10 fill",
"notes": "The only dark surface in the light theme. Syntax: strings #99ffe4, keywords #9ecbff, tags/errors #f97583, numbers #ffc799, functions #b392f0, links #79b8ff, plain text #e1e4e8. Header row holds mono package-manager tabs and a copy icon."
}
}
}