Give your coding agent a design system it can follow: exact color, type, radius, spacing and component tokens in YAML, and the reasons behind them in plain Markdown. Start from one of 16 templates or describe your own.
Your fileUpdated as you type. Nothing is sent anywhere.
DESIGN.mdFor Any coding agent; Google Stitch and DESIGN.md tooling
---
version: alpha
name: My design system
description: Design system for a responsive web app.
colors:
primary: "#2563eb"
on-primary: "#ffffff"
primary-hover: "#1e51c1"
primary-text: "#2563eb"
secondary: "#475569"
on-secondary: "#ffffff"
tertiary: "#0d9488"
on-tertiary: "#0b0f19"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
typography:
display:
fontFamily: Inter
fontSize: 49px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Inter
fontSize: 39px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Inter
fontSize: 31px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Inter
fontSize: 25px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 20px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 16px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 14px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Inter
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Inter
fontSize: 12px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 4px
md: 8px
lg: 12px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
---
# My design system
## Overview
Quiet, minimal and content-first: generous whitespace, one accent color used sparingly, and almost no decoration. Hierarchy comes from type size and spacing, not from boxes and shadows. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#2563eb):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.16:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#2563eb):** the primary hue darkened or lightened for text on the surface (4.86:1, AA).
- **Secondary (#475569):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#0d9488):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Inter at weight 600, from `display` (49px) down to `h3` (25px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 16px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Inter at 14px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are soft and approachable without being bubbly: controls use `{rounded.md}`, containers `{rounded.lg}`. The scale is `sm` 4px, `md` 8px, `lg` 12px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #2563eb (5.16:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (4.86:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Use the primary color for the single most important action on a screen.
- Use the spacing scale for every gap; never invent a value.
**Don't**
- Do not use color as the only way to show state; pair it with text or an icon.
Save it as DESIGN.md at the repository root and mention it in AGENTS.md ("Follow DESIGN.md for all UI work") so agents read it before building screens.
Which DESIGN.md Templates Can You Start From?
Sixteen design directions, from minimal to brutalist. Every component color pair in every template reaches 4.5:1 contrast; load one to change it, or copy or download it as it is.
Minimal
A quiet, content-first system: one blue accent, Inter throughout, soft corners, almost no shadows and lots of whitespace.
Preconfigured for: Landing pages, portfolios and simple SaaS apps.
Preview DESIGN.md
---
version: alpha
name: Minimal
description: "Quiet, content-first design system with a single accent color."
colors:
primary: "#2563eb"
on-primary: "#ffffff"
primary-hover: "#1e51c1"
primary-text: "#2563eb"
secondary: "#475569"
on-secondary: "#ffffff"
tertiary: "#0d9488"
on-tertiary: "#0b0f19"
neutral: "#71717a"
background: "#ffffff"
surface: "#f8f8f8"
text: "#242427"
text-muted: "#71717a"
border: "#dedee0"
typography:
display:
fontFamily: Inter
fontSize: 49px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Inter
fontSize: 39px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Inter
fontSize: 31px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Inter
fontSize: 25px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 20px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 16px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 14px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Inter
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Inter
fontSize: 12px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 4px
md: 8px
lg: 12px
full: 9999px
spacing:
xs: 8px
sm: 12px
md: 24px
lg: 32px
xl: 48px
gutter: 32px
margin: 48px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
---
# Minimal
## Overview
Quiet, minimal and content-first: generous whitespace, one accent color used sparingly, and almost no decoration. Hierarchy comes from type size and spacing, not from boxes and shadows. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#2563eb):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.16:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#2563eb):** the primary hue darkened or lightened for text on the surface (4.86:1, AA).
- **Secondary (#475569):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#0d9488):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#71717a):** the hue every gray is built from. Background #ffffff, surface #f8f8f8, border #dedee0. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#242427) and muted text (#71717a):** body copy and secondary copy (15.47:1, AAA and 4.83:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Inter at weight 600, from `display` (49px) down to `h3` (25px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 16px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Inter at 14px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is generous: whitespace is part of the brand, so do not fill it. Every gap uses a spacing token (`xs` 8px to `xl` 48px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are soft and approachable without being bubbly: controls use `{rounded.md}`, containers `{rounded.lg}`. The scale is `sm` 4px, `md` 8px, `lg` 12px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #2563eb (5.16:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (4.86:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Let whitespace separate groups before reaching for a border or a card.
- Use the primary color for one action per screen.
**Don't**
- Do not add decorative gradients, illustrations or shadows.
- Do not use more than two type sizes in one component.
Design-system-first
Every component specified and every value tokenized, with strict reuse rules: the file an agent needs to extend a component library.
Preconfigured for: Teams with a shared component library or a design-token pipeline.
Preview DESIGN.md
---
version: alpha
name: Foundation
description: "Token-first design system: every value is named, every component is specified."
colors:
primary: "#4f46e5"
on-primary: "#ffffff"
primary-hover: "#4139bc"
primary-text: "#4f46e5"
secondary: "#0f766e"
on-secondary: "#ffffff"
tertiary: "#c026d3"
on-tertiary: "#ffffff"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
inverse: "#20252c"
on-inverse: "#f7f8f9"
typography:
display:
fontFamily: Inter
fontSize: 49px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Inter
fontSize: 39px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Inter
fontSize: 31px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Inter
fontSize: 25px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 20px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 16px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 14px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Inter
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Inter
fontSize: 12px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 4px
md: 8px
lg: 12px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Foundation
## Overview
Systematic and token-driven: every value comes from a named token, every component is built from the same small set of primitives, and consistency matters more than any single screen. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#4f46e5):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (6.28:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#4f46e5):** the primary hue darkened or lightened for text on the surface (5.91:1, AA).
- **Secondary (#0f766e):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#c026d3):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Inter at weight 600, from `display` (49px) down to `h3` (25px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 16px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Inter at 14px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are soft and approachable without being bubbly: controls use `{rounded.md}`, containers `{rounded.lg}`. The scale is `sm` 4px, `md` 8px, `lg` 12px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #4f46e5 (6.28:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (5.91:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #c026d3 (4.70:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Build new components from existing tokens and components; add a token before adding a value.
- Document every new variant as its own component entry, such as button-primary-hover.
**Don't**
- Do not hard-code a hex color, pixel size or shadow in component code.
- Do not create one-off variants for a single screen.
Mobile-first
Designed at 375px first: 48px touch targets, thumb-zone actions, a bottom-anchored primary button and pill shapes.
Preconfigured for: Mobile web apps, PWAs and companion apps.
Preview DESIGN.md
---
version: alpha
name: Pocket
description: Mobile-first design system with large touch targets and thumb-reachable actions.
colors:
primary: "#0f766e"
on-primary: "#ffffff"
primary-hover: "#0c615a"
primary-text: "#0f766e"
secondary: "#334155"
on-secondary: "#ffffff"
tertiary: "#ea580c"
on-tertiary: "#0b0f19"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
inverse: "#20252c"
on-inverse: "#f7f8f9"
typography:
display:
fontFamily: Inter
fontSize: 52px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Inter
fontSize: 42px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Inter
fontSize: 33px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Inter
fontSize: 27px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 21px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 17px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 15px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Inter
fontSize: 15px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Inter
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 8px
md: 12px
lg: 20px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 640px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
padding: "{spacing.md}"
height: 48px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
padding: "{spacing.md}"
height: 48px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 48px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 56px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Pocket
## Overview
Friendly and playful: rounded shapes, saturated color, lively but legible type, and small moments of delight that never get in the way of the task. The product is used mostly on phones: every screen is designed at 375px first, with thumb-reachable primary actions and 44px minimum touch targets.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#0f766e):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.47:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#0f766e):** the primary hue darkened or lightened for text on the surface (5.14:1, AA).
- **Secondary (#334155):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#ea580c):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Inter at weight 600, from `display` (52px) down to `h3` (27px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 17px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Inter at 15px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (640px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Buttons and badges are fully pill-shaped (`{rounded.full}`); cards and dialogs use the large radius. The scale is `sm` 8px, `md` 12px, `lg` 20px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #0f766e (5.47:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (5.14:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #0b0f19 on #ea580c (5.37:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Put the primary action within reach of the thumb, at the bottom of the screen on phones.
- Make every tap target at least 48 by 48 pixels.
**Don't**
- Do not rely on hover to reveal information or actions.
- Do not use multi-column layouts below 600px wide.
Editorial
Serif headlines and body, an ink-red accent, sharp shapes, no shadows and a reading column tuned for long-form text.
Preconfigured for: Publications, blogs, newsletters and essay sites.
Preview DESIGN.md
---
version: alpha
name: Broadsheet
description: Editorial design system for long-form reading.
colors:
primary: "#9f1239"
on-primary: "#ffffff"
primary-hover: "#820f2f"
primary-text: "#9f1239"
secondary: "#57534e"
on-secondary: "#ffffff"
tertiary: "#1d4ed8"
on-tertiary: "#ffffff"
neutral: "#78716c"
background: "#ffffff"
surface: "#f8f8f8"
text: "#272422"
text-muted: "#78716c"
border: "#e0dedd"
typography:
display:
fontFamily: Playfair Display
fontSize: 58px
fontWeight: 700
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Playfair Display
fontSize: 46px
fontWeight: 700
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Playfair Display
fontSize: 37px
fontWeight: 700
lineHeight: 1.2
h3:
fontFamily: Playfair Display
fontSize: 30px
fontWeight: 700
lineHeight: 1.3
body-lg:
fontFamily: Source Serif 4
fontSize: 24px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Source Serif 4
fontSize: 19px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Source Serif 4
fontSize: 17px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Inter
fontSize: 17px
fontWeight: 600
lineHeight: 1.2
letterSpacing: 0.06em
label-sm:
fontFamily: Inter
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
letterSpacing: 0.08em
rounded:
sm: 0px
md: 2px
lg: 4px
full: 9999px
spacing:
xs: 8px
sm: 12px
md: 24px
lg: 32px
xl: 48px
gutter: 32px
margin: 48px
max-width: 720px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
---
# Broadsheet
## Overview
Editorial and literary: strong typographic hierarchy, a serif voice for reading, restrained color, and layouts that respect the rhythm of long-form text. The product is a marketing and content site: bold headlines, clear calls to action and fast pages matter most.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#9f1239):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (8.01:1, AAA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#9f1239):** the primary hue darkened or lightened for text on the surface (7.54:1, AAA).
- **Secondary (#57534e):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#1d4ed8):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#78716c):** the hue every gray is built from. Background #ffffff, surface #f8f8f8, border #e0dedd. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#272422) and muted text (#78716c):** body copy and secondary copy (15.42:1, AAA and 4.79:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Playfair Display at weight 700, from `display` (58px) down to `h3` (30px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Source Serif 4 at 19px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Inter at 17px for buttons, table headers and metadata, in uppercase with wide tracking.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (720px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is generous: whitespace is part of the brand, so do not fill it. Every gap uses a spacing token (`xs` 8px to `xl` 48px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Shapes are sharp and engineered: inputs and buttons use `{rounded.sm}`, and nothing is rounded for decoration. The scale is `sm` 0px, `md` 2px, `lg` 4px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #9f1239 (8.01:1, AAA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (7.54:1, AAA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #1d4ed8 (6.70:1, AA). A badge never carries meaning by color alone: the text says the status.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Keep body text in a single column of 60 to 75 characters.
- Use the accent color for links and one call to action per article.
**Don't**
- Do not put body text on tinted backgrounds or images.
- Do not justify text; use left alignment.
Dashboard and data-dense
Compact 4px spacing, IBM Plex with monospace numbers, bordered tables and calm slate neutrals for all-day use.
Preconfigured for: Admin panels, analytics, operations and monitoring tools.
Preview DESIGN.md
---
version: alpha
name: Console
description: Compact design system for data-dense dashboards.
colors:
primary: "#2563eb"
on-primary: "#ffffff"
primary-hover: "#1e51c1"
primary-text: "#2563eb"
secondary: "#0f766e"
on-secondary: "#ffffff"
tertiary: "#7c3aed"
on-tertiary: "#ffffff"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
inverse: "#20252c"
on-inverse: "#f7f8f9"
typography:
display:
fontFamily: IBM Plex Sans
fontSize: 43px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: IBM Plex Sans
fontSize: 34px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: IBM Plex Sans
fontSize: 27px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: IBM Plex Sans
fontSize: 22px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: IBM Plex Sans
fontSize: 18px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: IBM Plex Sans
fontSize: 14px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: IBM Plex Sans
fontSize: 12px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: IBM Plex Mono
fontSize: 12px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: IBM Plex Mono
fontSize: 11px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 2px
md: 4px
lg: 8px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 12px
lg: 16px
xl: 24px
gutter: 16px
margin: 16px
max-width: 1600px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 36px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 36px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 36px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Console
## Overview
Professional and trustworthy: conservative color, clear structure, predictable components and dense-enough layouts for people who use the product all day. The product is a data-dense dashboard used for hours at a time on large screens: density, scannable tables and stable layouts matter most.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#2563eb):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.16:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#2563eb):** the primary hue darkened or lightened for text on the surface (4.86:1, AA).
- **Secondary (#0f766e):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#7c3aed):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** IBM Plex Sans at weight 600, from `display` (43px) down to `h3` (22px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** IBM Plex Sans at 14px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** IBM Plex Mono at 12px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1600px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. The grid is compact: 4px steps keep dense screens aligned. Every gap uses a spacing token (`xs` 4px to `xl` 24px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are only just softened, enough to feel modern while staying precise and structured. The scale is `sm` 2px, `md` 4px, `lg` 8px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #2563eb (5.16:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (4.86:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #7c3aed (5.69:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Right-align numbers and use tabular figures so columns line up.
- Keep filters and actions in a fixed toolbar above the data.
**Don't**
- Do not animate data refreshes; update values in place.
- Do not use more than five colors in one chart.
Playful consumer
Saturated violet and pink, Nunito, pill buttons, layered shadows and friendly copy for a product people enjoy opening.
Preconfigured for: Social, creative and gamified consumer apps.
Preview DESIGN.md
---
version: alpha
name: Confetti
description: "Bright, playful design system for a consumer app."
colors:
primary: "#7c3aed"
on-primary: "#ffffff"
primary-hover: "#662fc2"
primary-text: "#7c3aed"
secondary: "#db2777"
on-secondary: "#ffffff"
tertiary: "#a67103"
on-tertiary: "#0b0f19"
neutral: "#71717a"
background: "#ffffff"
surface: "#f8f8f8"
text: "#242427"
text-muted: "#71717a"
border: "#dedee0"
inverse: "#242427"
on-inverse: "#f8f8f8"
typography:
display:
fontFamily: Nunito
fontSize: 52px
fontWeight: 800
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Nunito
fontSize: 42px
fontWeight: 800
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Nunito
fontSize: 33px
fontWeight: 800
lineHeight: 1.2
h3:
fontFamily: Nunito
fontSize: 27px
fontWeight: 800
lineHeight: 1.3
body-lg:
fontFamily: Nunito
fontSize: 21px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Nunito
fontSize: 17px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Nunito
fontSize: 15px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Nunito
fontSize: 15px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Nunito
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 8px
md: 12px
lg: 20px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
padding: "{spacing.md}"
height: 48px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
padding: "{spacing.md}"
height: 48px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 48px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Confetti
## Overview
Friendly and playful: rounded shapes, saturated color, lively but legible type, and small moments of delight that never get in the way of the task. The product is used mostly on phones: every screen is designed at 375px first, with thumb-reachable primary actions and 44px minimum touch targets.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#7c3aed):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.69:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#7c3aed):** the primary hue darkened or lightened for text on the surface (5.36:1, AA).
- **Secondary (#db2777):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#a67103):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#71717a):** the hue every gray is built from. Background #ffffff, surface #f8f8f8, border #dedee0. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#242427) and muted text (#71717a):** body copy and secondary copy (15.47:1, AAA and 4.83:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Nunito at weight 800, from `display` (52px) down to `h3` (27px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Nunito at 17px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Nunito at 15px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is part of the language: cards rest on a small soft shadow, menus and popovers use a medium shadow, and modals use the largest. Higher layers are always lighter in light mode. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Buttons and badges are fully pill-shaped (`{rounded.full}`); cards and dialogs use the large radius. The scale is `sm` 8px, `md` 12px, `lg` 20px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #7c3aed (5.69:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (5.36:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #0b0f19 on #a67103 (4.54:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.57:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Celebrate completed actions with a short message, not a long animation.
- Use illustrations to explain empty states.
**Don't**
- Do not let decoration cover text or controls.
- Do not use more than one bright color per component.
Enterprise
Conservative navy, IBM Plex, subtle corners, full component coverage and predictable patterns for complex workflows.
Preconfigured for: Enterprise software, B2B platforms and internal tools.
Preview DESIGN.md
---
version: alpha
name: Bastion
description: "Conservative, predictable design system for enterprise workflows."
colors:
primary: "#1e3a8a"
on-primary: "#ffffff"
primary-hover: "#192f71"
primary-text: "#1e3a8a"
secondary: "#475569"
on-secondary: "#ffffff"
tertiary: "#0369a1"
on-tertiary: "#ffffff"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
inverse: "#20252c"
on-inverse: "#f7f8f9"
typography:
display:
fontFamily: IBM Plex Sans
fontSize: 46px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: IBM Plex Sans
fontSize: 37px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: IBM Plex Sans
fontSize: 29px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: IBM Plex Sans
fontSize: 23px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: IBM Plex Sans
fontSize: 19px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: IBM Plex Sans
fontSize: 15px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: IBM Plex Sans
fontSize: 13px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: IBM Plex Sans
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: IBM Plex Sans
fontSize: 11px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 2px
md: 4px
lg: 8px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1440px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Bastion
## Overview
Professional and trustworthy: conservative color, clear structure, predictable components and dense-enough layouts for people who use the product all day. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#1e3a8a):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (10.35:1, AAA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#1e3a8a):** the primary hue darkened or lightened for text on the surface (9.74:1, AAA).
- **Secondary (#475569):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#0369a1):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** IBM Plex Sans at weight 600, from `display` (46px) down to `h3` (23px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** IBM Plex Sans at 15px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** IBM Plex Sans at 13px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1440px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are only just softened, enough to feel modern while staying precise and structured. The scale is `sm` 2px, `md` 4px, `lg` 8px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #1e3a8a (10.35:1, AAA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (9.74:1, AAA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #0369a1 (5.93:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Use the same layout for every list, detail and edit page.
- Confirm destructive actions in a modal that names what will be deleted.
**Don't**
- Do not hide important actions in overflow menus.
- Do not change a pattern on one page without changing it everywhere.
Developer tool (dark)
Dark by default with a cyan accent, Geist and JetBrains Mono, crisp borders and compact spacing for long coding sessions.
Preconfigured for: Developer tools, CLIs with web UIs, API consoles and IDE extensions.
Preview DESIGN.md
---
version: alpha
name: Terminal
description: Dark-first design system for a developer tool.
colors:
primary: "#57b4cb"
on-primary: "#0b0f19"
primary-hover: "#9cd3e0"
primary-text: "#57b4cb"
secondary: "#96a0b0"
on-secondary: "#0b0f19"
tertiary: "#c48bfa"
on-tertiary: "#0b0f19"
neutral: "#71717a"
background: "#141416"
surface: "#242427"
text: "#f8f8f8"
text-muted: "#9e9ea5"
border: "#353539"
inverse: "#f8f8f8"
on-inverse: "#141416"
typography:
display:
fontFamily: Geist
fontSize: 46px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Geist
fontSize: 37px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Geist
fontSize: 29px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Geist
fontSize: 23px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Geist
fontSize: 19px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Geist
fontSize: 15px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Geist
fontSize: 13px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: JetBrains Mono
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: JetBrains Mono
fontSize: 11px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 2px
md: 4px
lg: 8px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 12px
lg: 16px
xl: 24px
gutter: 16px
margin: 16px
max-width: 1440px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 36px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 36px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 36px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Terminal
## Overview
Technical and precise: a dark-first, information-dense interface where monospace data, crisp borders and fast scanning matter more than ornament. The product is a data-dense dashboard used for hours at a time on large screens: density, scannable tables and stable layouts matter most.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is dark. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#57b4cb):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #0b0f19 (8.02:1, AAA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#57b4cb):** the primary hue darkened or lightened for text on the surface (6.48:1, AA).
- **Secondary (#96a0b0):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#c48bfa):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#71717a):** the hue every gray is built from. Background #141416, surface #242427, border #353539. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#f8f8f8) and muted text (#9e9ea5):** body copy and secondary copy (17.32:1, AAA and 6.91:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Geist at weight 600, from `display` (46px) down to `h3` (23px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Geist at 15px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** JetBrains Mono at 13px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1440px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. The grid is compact: 4px steps keep dense screens aligned. Every gap uses a spacing token (`xs` 4px to `xl` 24px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are only just softened, enough to feel modern while staying precise and structured. The scale is `sm` 2px, `md` 4px, `lg` 8px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #0b0f19 on #57b4cb (8.02:1, AAA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (6.48:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #0b0f19 on #c48bfa (7.67:1, AAA). A badge never carries meaning by color alone: the text says the status.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (17.32:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Show code, IDs and commands in the monospace label font with a copy button.
- Keep keyboard shortcuts visible next to the actions they trigger.
**Don't**
- Do not use pure black backgrounds; use the neutral background token.
- Do not rely on color alone for diff and status views.
E-commerce
An orange buy color, a navy trust color, clear badges for stock and sale, and product cards built to convert.
Preconfigured for: Online stores, product catalogs and checkout flows.
Preview DESIGN.md
---
version: alpha
name: Storefront
description: Conversion-focused design system for an online store.
colors:
primary: "#c2410c"
on-primary: "#ffffff"
primary-hover: "#9f350a"
primary-text: "#c2410c"
secondary: "#1e3a8a"
on-secondary: "#ffffff"
tertiary: "#15803d"
on-tertiary: "#ffffff"
neutral: "#6b7280"
background: "#ffffff"
surface: "#f8f8f9"
text: "#222529"
text-muted: "#6b7280"
border: "#dddfe2"
inverse: "#222529"
on-inverse: "#f8f8f9"
typography:
display:
fontFamily: DM Sans
fontSize: 49px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: DM Sans
fontSize: 39px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: DM Sans
fontSize: 31px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: DM Sans
fontSize: 25px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 20px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 16px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 14px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: DM Sans
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: DM Sans
fontSize: 12px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 4px
md: 8px
lg: 12px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Storefront
## Overview
Friendly and playful: rounded shapes, saturated color, lively but legible type, and small moments of delight that never get in the way of the task. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#c2410c):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.17:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#c2410c):** the primary hue darkened or lightened for text on the surface (4.87:1, AA).
- **Secondary (#1e3a8a):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#15803d):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#6b7280):** the hue every gray is built from. Background #ffffff, surface #f8f8f9, border #dddfe2. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#222529) and muted text (#6b7280):** body copy and secondary copy (15.38:1, AAA and 4.83:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** DM Sans at weight 600, from `display` (49px) down to `h3` (25px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 16px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** DM Sans at 14px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are soft and approachable without being bubbly: controls use `{rounded.md}`, containers `{rounded.lg}`. The scale is `sm` 4px, `md` 8px, `lg` 12px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #c2410c (5.17:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (4.87:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #15803d (5.01:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Show the total price in USD, including shipping and tax, before the final button.
- Keep Add to cart visible without scrolling on product pages.
**Don't**
- Do not use countdown timers or fake scarcity messages.
- Do not hide the guest checkout option.
Healthcare (calm, accessible)
A soft teal, Source Sans at 17px, generous spacing and plain-language rules for people who may be anxious or unwell.
Preconfigured for: Patient portals, telehealth, clinics and benefits apps.
Preview DESIGN.md
---
version: alpha
name: Haven
description: "Calm, accessible design system for a patient-facing health app."
colors:
primary: "#0f766e"
on-primary: "#ffffff"
primary-hover: "#0c615a"
primary-text: "#0f766e"
secondary: "#2563eb"
on-secondary: "#ffffff"
tertiary: "#7c3aed"
on-tertiary: "#ffffff"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
inverse: "#20252c"
on-inverse: "#f7f8f9"
typography:
display:
fontFamily: Source Sans 3
fontSize: 52px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Source Sans 3
fontSize: 42px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Source Sans 3
fontSize: 33px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Source Sans 3
fontSize: 27px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Source Sans 3
fontSize: 21px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Source Sans 3
fontSize: 17px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Source Sans 3
fontSize: 15px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Source Sans 3
fontSize: 15px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Source Sans 3
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 4px
md: 8px
lg: 12px
full: 9999px
spacing:
xs: 8px
sm: 12px
md: 24px
lg: 32px
xl: 48px
gutter: 32px
margin: 48px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 48px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 48px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 48px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 56px
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Haven
## Overview
Calm and reassuring: soft color, generous spacing, plain language and large touch targets for people who may be stressed, tired or unwell. The product is used mostly on phones: every screen is designed at 375px first, with thumb-reachable primary actions and 44px minimum touch targets.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#0f766e):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.47:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#0f766e):** the primary hue darkened or lightened for text on the surface (5.14:1, AA).
- **Secondary (#2563eb):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#7c3aed):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Source Sans 3 at weight 600, from `display` (52px) down to `h3` (27px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Source Sans 3 at 17px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Source Sans 3 at 15px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is generous: whitespace is part of the brand, so do not fill it. Every gap uses a spacing token (`xs` 8px to `xl` 48px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are soft and approachable without being bubbly: controls use `{rounded.md}`, containers `{rounded.lg}`. The scale is `sm` 4px, `md` 8px, `lg` 12px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #0f766e (5.47:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (5.14:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Write at a sixth-grade reading level and explain medical terms.
- Give every form step a clear title and a way back.
**Don't**
- Do not show health information in toasts or notifications on a locked screen.
- Do not use red for anything but errors and urgent alerts.
Fintech (trust)
A deep green and navy palette, monospace figures, subtle shapes and strict rules for showing money and risk.
Preconfigured for: Banking, payments, budgeting and investing products.
Preview DESIGN.md
---
version: alpha
name: Ledger
description: Trust-first design system for a financial product.
colors:
primary: "#047857"
on-primary: "#ffffff"
primary-hover: "#036247"
primary-text: "#047857"
secondary: "#1e3a8a"
on-secondary: "#ffffff"
tertiary: "#b45309"
on-tertiary: "#ffffff"
neutral: "#6b7280"
background: "#ffffff"
surface: "#f8f8f9"
text: "#222529"
text-muted: "#6b7280"
border: "#dddfe2"
inverse: "#222529"
on-inverse: "#f8f8f9"
typography:
display:
fontFamily: Inter
fontSize: 49px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Inter
fontSize: 39px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Inter
fontSize: 31px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Inter
fontSize: 25px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 20px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 16px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 14px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: IBM Plex Mono
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: IBM Plex Mono
fontSize: 12px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 2px
md: 4px
lg: 8px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Ledger
## Overview
Professional and trustworthy: conservative color, clear structure, predictable components and dense-enough layouts for people who use the product all day. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#047857):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.48:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#047857):** the primary hue darkened or lightened for text on the surface (5.16:1, AA).
- **Secondary (#1e3a8a):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#b45309):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#6b7280):** the hue every gray is built from. Background #ffffff, surface #f8f8f9, border #dddfe2. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#222529) and muted text (#6b7280):** body copy and secondary copy (15.38:1, AAA and 4.83:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Inter at weight 600, from `display` (49px) down to `h3` (25px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 16px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** IBM Plex Mono at 14px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is mostly tonal, with one subtle shadow for things that float: menus, popovers and modals. Cards on the page use a border and the surface color, not a shadow. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are only just softened, enough to feel modern while staying precise and structured. The scale is `sm` 2px, `md` 4px, `lg` 8px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #047857 (5.48:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (5.16:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #b45309 (5.02:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Show amounts in USD with two decimals and the currency symbol, in tabular figures.
- Ask for confirmation, with the amount and recipient, before any money moves.
**Don't**
- Do not use green and red as the only signal of gain and loss; add a sign and an arrow icon.
- Do not truncate account numbers or amounts.
Luxury
Deep charcoal with a gold accent, Playfair Display headlines, uppercase tracked labels and spacious, sharp layouts.
Preconfigured for: Luxury retail, hospitality, real estate and fashion.
Preview DESIGN.md
---
version: alpha
name: Atelier
description: Refined design system for a premium brand.
colors:
primary: "#1c1917"
on-primary: "#ffffff"
primary-hover: "#171513"
primary-text: "#1c1917"
secondary: "#57534e"
on-secondary: "#ffffff"
tertiary: "#8a6d2f"
on-tertiary: "#ffffff"
neutral: "#78716c"
background: "#ffffff"
surface: "#f8f8f8"
text: "#272422"
text-muted: "#78716c"
border: "#e0dedd"
typography:
display:
fontFamily: Playfair Display
fontSize: 52px
fontWeight: 500
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Playfair Display
fontSize: 42px
fontWeight: 500
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Playfair Display
fontSize: 33px
fontWeight: 500
lineHeight: 1.2
h3:
fontFamily: Playfair Display
fontSize: 27px
fontWeight: 500
lineHeight: 1.3
body-lg:
fontFamily: DM Sans
fontSize: 21px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: DM Sans
fontSize: 17px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: DM Sans
fontSize: 15px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: DM Sans
fontSize: 15px
fontWeight: 600
lineHeight: 1.2
letterSpacing: 0.06em
label-sm:
fontFamily: DM Sans
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
letterSpacing: 0.08em
rounded:
sm: 0px
md: 2px
lg: 4px
full: 9999px
spacing:
xs: 8px
sm: 12px
md: 24px
lg: 32px
xl: 48px
gutter: 32px
margin: 48px
max-width: 1280px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
---
# Atelier
## Overview
Refined and premium: a restrained palette of deep neutrals with one precious accent, elegant serif display type, and space used as a sign of quality. The product is a marketing and content site: bold headlines, clear calls to action and fast pages matter most.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#1c1917):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (17.48:1, AAA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#1c1917):** the primary hue darkened or lightened for text on the surface (16.46:1, AAA).
- **Secondary (#57534e):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#8a6d2f):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#78716c):** the hue every gray is built from. Background #ffffff, surface #f8f8f8, border #e0dedd. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#272422) and muted text (#78716c):** body copy and secondary copy (15.42:1, AAA and 4.79:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Playfair Display at weight 500, from `display` (52px) down to `h3` (27px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** DM Sans at 17px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** DM Sans at 15px for buttons, table headers and metadata, in uppercase with wide tracking.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1280px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is generous: whitespace is part of the brand, so do not fill it. Every gap uses a spacing token (`xs` 8px to `xl` 48px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Shapes are sharp and engineered: inputs and buttons use `{rounded.sm}`, and nothing is rounded for decoration. The scale is `sm` 0px, `md` 2px, `lg` 4px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #1c1917 (17.48:1, AAA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (16.46:1, AAA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Use large photography with plenty of space around it.
- Use the gold accent for one detail per screen.
**Don't**
- Do not use sale badges, bright colors or exclamation marks.
- Do not crowd a screen with more than one call to action.
Brutalist
Black, white and one loud red, Space Grotesk and Space Mono, 0px corners, thick borders and no shadows at all.
Preconfigured for: Portfolios, agencies, art projects and indie products.
Preview DESIGN.md
---
version: alpha
name: Concrete
description: "Raw, high-contrast brutalist design system."
colors:
primary: "#111111"
on-primary: "#ffffff"
primary-hover: "#0e0e0e"
primary-text: "#111111"
secondary: "#525252"
on-secondary: "#ffffff"
tertiary: "#dc2626"
on-tertiary: "#ffffff"
neutral: "#737373"
background: "#ffffff"
surface: "#f8f8f8"
text: "#252525"
text-muted: "#5e5e5e"
border: "#dfdfdf"
typography:
display:
fontFamily: Space Grotesk
fontSize: 52px
fontWeight: 700
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Space Grotesk
fontSize: 42px
fontWeight: 700
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Space Grotesk
fontSize: 33px
fontWeight: 700
lineHeight: 1.2
h3:
fontFamily: Space Grotesk
fontSize: 27px
fontWeight: 700
lineHeight: 1.3
body-lg:
fontFamily: Space Grotesk
fontSize: 21px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Space Grotesk
fontSize: 17px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Space Grotesk
fontSize: 15px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Space Mono
fontSize: 15px
fontWeight: 600
lineHeight: 1.2
letterSpacing: 0.06em
label-sm:
fontFamily: Space Mono
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
letterSpacing: 0.08em
rounded:
sm: 0px
md: 2px
lg: 4px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
---
# Concrete
## Overview
Raw and confident: hard edges, visible structure, heavy borders instead of shadows, and type set big and unapologetic. The product is a marketing and content site: bold headlines, clear calls to action and fast pages matter most.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#111111):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (18.88:1, AAA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#111111):** the primary hue darkened or lightened for text on the surface (17.78:1, AAA).
- **Secondary (#525252):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#dc2626):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#737373):** the hue every gray is built from. Background #ffffff, surface #f8f8f8, border #dfdfdf. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#252525) and muted text (#5e5e5e):** body copy and secondary copy (15.32:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Space Grotesk at weight 700, from `display` (52px) down to `h3` (27px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Space Grotesk at 17px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Space Mono at 15px for buttons, table headers and metadata, in uppercase with wide tracking.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Shapes are sharp and engineered: inputs and buttons use `{rounded.sm}`, and nothing is rounded for decoration. The scale is `sm` 0px, `md` 2px, `lg` 4px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #111111 (18.88:1, AAA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (17.78:1, AAA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Use 2px solid borders to separate everything.
- Set headlines very large and let them run edge to edge.
**Don't**
- Do not add gradients, blur or soft shadows.
- Do not round any corner.
Accessible high-contrast
Atkinson Hyperlegible at 18px, near-black text, strong focus rings, large targets and explicit no-color-only rules.
Preconfigured for: Public services, accessibility-first products and older audiences.
Preview DESIGN.md
---
version: alpha
name: Clearview
description: "High-contrast, accessibility-first design system."
colors:
primary: "#1e40af"
on-primary: "#ffffff"
primary-hover: "#193590"
primary-text: "#1e40af"
secondary: "#334155"
on-secondary: "#ffffff"
tertiary: "#7e22ce"
on-tertiary: "#ffffff"
neutral: "#525252"
background: "#ffffff"
surface: "#f6f6f6"
text: "#1a1a1a"
text-muted: "#525252"
border: "#d7d7d7"
inverse: "#1a1a1a"
on-inverse: "#f6f6f6"
typography:
display:
fontFamily: Atkinson Hyperlegible
fontSize: 55px
fontWeight: 700
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Atkinson Hyperlegible
fontSize: 44px
fontWeight: 700
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Atkinson Hyperlegible
fontSize: 35px
fontWeight: 700
lineHeight: 1.2
h3:
fontFamily: Atkinson Hyperlegible
fontSize: 28px
fontWeight: 700
lineHeight: 1.3
body-lg:
fontFamily: Atkinson Hyperlegible
fontSize: 23px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Atkinson Hyperlegible
fontSize: 18px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Atkinson Hyperlegible
fontSize: 16px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Atkinson Hyperlegible
fontSize: 16px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Atkinson Hyperlegible
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 2px
md: 4px
lg: 8px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Clearview
## Overview
Accessibility-first: high contrast, large readable type, unmistakable focus states and no meaning carried by color alone. The product is a responsive web application used on desktop and mobile.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#1e40af):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (8.72:1, AAA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#1e40af):** the primary hue darkened or lightened for text on the surface (8.07:1, AAA).
- **Secondary (#334155):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#7e22ce):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#525252):** the hue every gray is built from. Background #ffffff, surface #f6f6f6, border #d7d7d7. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#1a1a1a) and muted text (#525252):** body copy and secondary copy (17.40:1, AAA and 7.81:1, AAA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Atkinson Hyperlegible at weight 700, from `display` (55px) down to `h3` (28px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Atkinson Hyperlegible at 18px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Atkinson Hyperlegible at 16px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are only just softened, enough to feel modern while staying precise and structured. The scale is `sm` 2px, `md` 4px, `lg` 8px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #1e40af (8.72:1, AAA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (8.07:1, AAA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #7e22ce (6.98:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (16.10:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Show a 3px focus outline with at least 3:1 contrast on every interactive element.
- Underline every link in body text.
**Don't**
- Do not convey state with color alone.
- Do not set body text below 18px or use light font weights.
Kids and education
A bright blue with sunny accents, Nunito at 18px, very round shapes and big buttons for young learners.
Preconfigured for: Learning apps, classroom tools and children's products.
Preview DESIGN.md
---
version: alpha
name: Playground
description: "Bright, friendly design system for young learners."
colors:
primary: "#2563eb"
on-primary: "#ffffff"
primary-hover: "#1e51c1"
primary-text: "#2563eb"
secondary: "#16a34a"
on-secondary: "#0b0f19"
tertiary: "#d97706"
on-tertiary: "#0b0f19"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
inverse: "#20252c"
on-inverse: "#f7f8f9"
typography:
display:
fontFamily: Nunito
fontSize: 55px
fontWeight: 800
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Nunito
fontSize: 44px
fontWeight: 800
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Nunito
fontSize: 35px
fontWeight: 800
lineHeight: 1.2
h3:
fontFamily: Nunito
fontSize: 28px
fontWeight: 800
lineHeight: 1.3
body-lg:
fontFamily: Nunito
fontSize: 23px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Nunito
fontSize: 18px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Nunito
fontSize: 16px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: Nunito
fontSize: 16px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: Nunito
fontSize: 14px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 8px
md: 12px
lg: 20px
full: 9999px
spacing:
xs: 8px
sm: 12px
md: 24px
lg: 32px
xl: 48px
gutter: 32px
margin: 48px
max-width: 1200px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
padding: "{spacing.md}"
height: 48px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.full}"
padding: "{spacing.md}"
height: 48px
card:
backgroundColor: "{colors.surface}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.lg}"
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
modal:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
rounded: "{rounded.lg}"
padding: "{spacing.xl}"
width: 560px
toast:
backgroundColor: "{colors.inverse}"
textColor: "{colors.on-inverse}"
typography: "{typography.body-sm}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
---
# Playground
## Overview
Friendly and playful: rounded shapes, saturated color, lively but legible type, and small moments of delight that never get in the way of the task. The product is used mostly on phones: every screen is designed at 375px first, with thumb-reachable primary actions and 44px minimum touch targets.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#2563eb):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.16:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#2563eb):** the primary hue darkened or lightened for text on the surface (4.86:1, AA).
- **Secondary (#16a34a):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#d97706):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Nunito at weight 800, from `display` (55px) down to `h3` (28px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Nunito at 18px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** Nunito at 16px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1200px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is generous: whitespace is part of the brand, so do not fill it. Every gap uses a spacing token (`xs` 8px to `xl` 48px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth is part of the language: cards rest on a small soft shadow, menus and popovers use a medium shadow, and modals use the largest. Higher layers are always lighter in light mode. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Buttons and badges are fully pill-shaped (`{rounded.full}`); cards and dialogs use the large radius. The scale is `sm` 8px, `md` 12px, `lg` 20px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #2563eb (5.16:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (4.86:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Card** (`card`): groups related content on the surface color with `{rounded.lg}` corners and `{spacing.lg}` padding. A whole card is clickable only when it has one destination; otherwise put the action in a button inside it.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #0b0f19 on #d97706 (6.01:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Modal dialog** (`modal`): for decisions that block the task. It traps focus while open, closes on Escape, returns focus to the control that opened it, and has a visible title and an explicit cancel action.
- **Toast** (`toast`): brief, non-blocking confirmation in the inverse colors (14.49:1, AAA), announced with `role="status"`, dismissed after about five seconds or on click. Errors that need action are not toasts.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Use icons with text labels on every button.
- Reward progress with badges and short encouraging messages.
**Don't**
- Do not use timers that pressure the learner.
- Do not put links to outside sites without a grown-up gate.
Documentation site
A readable 17px body, JetBrains Mono code, a sidebar-friendly layout and quiet colors that keep attention on the content.
Preconfigured for: Developer docs, knowledge bases and help centers.
Preview DESIGN.md
---
version: alpha
name: Manual
description: Readable design system for a documentation site.
colors:
primary: "#0369a1"
on-primary: "#ffffff"
primary-hover: "#035684"
primary-text: "#0369a1"
secondary: "#475569"
on-secondary: "#ffffff"
tertiary: "#15803d"
on-tertiary: "#ffffff"
neutral: "#64748b"
background: "#ffffff"
surface: "#f7f8f9"
text: "#20252c"
text-muted: "#525f72"
border: "#dbdfe4"
typography:
display:
fontFamily: Inter
fontSize: 52px
fontWeight: 600
lineHeight: 1.1
letterSpacing: -0.02em
h1:
fontFamily: Inter
fontSize: 42px
fontWeight: 600
lineHeight: 1.15
letterSpacing: -0.015em
h2:
fontFamily: Inter
fontSize: 33px
fontWeight: 600
lineHeight: 1.2
h3:
fontFamily: Inter
fontSize: 27px
fontWeight: 600
lineHeight: 1.3
body-lg:
fontFamily: Inter
fontSize: 21px
fontWeight: 400
lineHeight: 1.6
body-md:
fontFamily: Inter
fontSize: 17px
fontWeight: 400
lineHeight: 1.6
body-sm:
fontFamily: Inter
fontSize: 15px
fontWeight: 400
lineHeight: 1.5
label-md:
fontFamily: JetBrains Mono
fontSize: 15px
fontWeight: 600
lineHeight: 1.2
label-sm:
fontFamily: JetBrains Mono
fontSize: 13px
fontWeight: 600
lineHeight: 1.2
rounded:
sm: 2px
md: 4px
lg: 8px
full: 9999px
spacing:
xs: 4px
sm: 8px
md: 16px
lg: 24px
xl: 32px
gutter: 24px
margin: 24px
max-width: 1360px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
textColor: "{colors.on-primary}"
button-secondary:
backgroundColor: "{colors.surface}"
textColor: "{colors.primary-text}"
typography: "{typography.label-md}"
rounded: "{rounded.md}"
padding: "{spacing.md}"
height: 44px
input:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-md}"
rounded: "{rounded.sm}"
padding: "{spacing.sm}"
height: 44px
nav:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.label-md}"
height: 64px
badge:
backgroundColor: "{colors.tertiary}"
textColor: "{colors.on-tertiary}"
typography: "{typography.label-sm}"
rounded: "{rounded.full}"
padding: "{spacing.xs}"
table:
backgroundColor: "{colors.background}"
textColor: "{colors.text}"
typography: "{typography.body-sm}"
padding: "{spacing.sm}"
table-header:
backgroundColor: "{colors.surface}"
textColor: "{colors.text-muted}"
typography: "{typography.label-sm}"
---
# Manual
## Overview
Quiet, minimal and content-first: generous whitespace, one accent color used sparingly, and almost no decoration. Hierarchy comes from type size and spacing, not from boxes and shadows. The product is a documentation site: readable prose, code blocks, clear navigation and search come first.
When a rule below does not cover a decision, choose the option that best fits this description, and reuse an existing token before creating a new one.
## Colors
The default theme is light. Every text and background pair in the components meets WCAG AA (4.5:1) or better; the ratios are computed from the token values.
- **Primary (#0369a1):** the action color: primary buttons, links, focus rings and the current navigation item. Text on it is #ffffff (5.93:1, AA). In CSS: `--color-primary`, `--color-on-primary`, `--color-primary-hover`.
- **Primary text (#0369a1):** the primary hue darkened or lightened for text on the surface (5.58:1, AA).
- **Secondary (#475569):** supporting emphasis such as illustrations, charts and selected states. Never a second call to action.
- **Tertiary (#15803d):** highlights and badges, used sparingly so it stays noticeable.
- **Neutral (#64748b):** the hue every gray is built from. Background #ffffff, surface #f7f8f9, border #dbdfe4. In CSS: `--color-bg`, `--color-surface`, `--color-border`.
- **Text (#20252c) and muted text (#525f72):** body copy and secondary copy (15.41:1, AAA and 6.48:1, AA on the background). In CSS: `--color-text`, `--color-text-muted`.
- Status colors come from tokens.css: `--color-success`, `--color-warning`, `--color-danger` and `--color-info`. Always pair a status color with text or an icon.
## Typography
- **Headlines:** Inter at weight 600, from `display` (52px) down to `h3` (27px) on a 1.25 ratio. Tight line height and slight negative tracking at the largest sizes.
- **Body:** Inter at 17px with a 1.6 line height for reading. Keep lines between 45 and 80 characters.
- **Labels:** JetBrains Mono at 15px for buttons, table headers and metadata, in sentence case.
- Use one h1 per page and never skip heading levels. In CSS, the families map to `--font-sans`, `--font-serif` and `--font-mono`, and the sizes to `--text-xs` through `--text-4xl`.
## Layout
Content sits in a centered column up to `{spacing.max-width}` (1360px) wide, with `{spacing.margin}` page margins and `{spacing.gutter}` gutters. Spacing is comfortable on an 8px rhythm, with 4px for fine adjustments. Every gap uses a spacing token (`xs` 4px to `xl` 32px); in CSS they map to the `--space-*` scale.
## Elevation & Depth
Depth comes from tonal layers and 1px borders, never shadows. The page uses the background color, grouped content sits on the surface color, and a border separates anything that needs separating. In CSS, shadows map to `--shadow-sm`, `--shadow-md` and `--shadow-lg`.
## Shapes
Corners are only just softened, enough to feel modern while staying precise and structured. The scale is `sm` 2px, `md` 4px, `lg` 8px and `full` for pills and avatars (CSS: `--radius-sm` to `--radius-full`).
## Components
- **Primary button** (`button-primary`): the one main action per screen or dialog. #ffffff on #0369a1 (5.93:1, AA); hover shifts one step to `{colors.primary-hover}`. Focus shows a 2px `--color-focus` outline offset by 2px. Disabled buttons keep their size and drop to 40% opacity with `cursor: not-allowed`.
- **Secondary button** (`button-secondary`): every other action. Primary-text color on the surface (5.58:1, AA) with a 1px `{colors.border}` border. Never place two primary buttons side by side; make one of them secondary.
- **Text input** (`input`): background color, 1px border, label above the field (never placeholder-only). Focus replaces the border with the primary color and adds the focus ring. Errors use `--color-danger` for the border and a message below the field linked with `aria-describedby`.
- **Top navigation** (`nav`): the product name on the left, at most seven top-level items, the current item marked with `aria-current="page"` and a 2px primary underline. On small screens the items move into a menu button.
- **Badge** (`badge`): short status or count labels, `{typography.label-sm}`, pill-shaped. #ffffff on #15803d (5.01:1, AA). A badge never carries meaning by color alone: the text says the status.
- **Data table** (`table`, `table-header`): body-sm rows, label-sm muted headers on the surface color, numbers right-aligned in tabular figures, and row borders instead of zebra stripes. Wide tables scroll inside their container, never the whole page.
Every interactive component has visible hover, focus-visible, active and disabled states, and a minimum target size of 44 by 44 CSS pixels on touch screens.
## Do's and Don'ts
**Do**
- Give every code block a language label and a copy button.
- Keep a table of contents for any page longer than three screens.
**Don't**
- Do not put essential information only in screenshots.
- Do not nest navigation more than three levels deep.
About the DESIGN.md generator
What Is DESIGN.md?
DESIGN.md is an open format, published by Google Labs, for describing a visual identity to coding agents. One plain-text file holds two layers. YAML front matter carries the design tokens, the exact values: colors, typography levels, corner radii, spacing and component styles. The Markdown body below it explains why those values exist and how to apply them. The specification and a command-line linter live at google-labs-code/design.md; the current spec version is "alpha".
The point is the same as AGENTS.md, applied to UI. Without it, an agent asked to build a settings page invents a blue, a gray, a radius and a button style, and the next page gets different ones. With it, the agent reads the tokens and the rules first and builds screens that look like the rest of your product.
What Does the Generated File Contain?
Front matter tokens:version: alpha, the name and description, colors (primary, secondary, tertiary, neutral, their on-colors and the surface and text roles), nine typography levels from display to label, rounded and spacing scales, and components that refer to the other tokens with {colors.primary} style references.
Overview: the personality and platform in a few sentences, plus your own brand notes, so the agent can make decisions the tokens do not cover.
Colors, Typography, Layout, Elevation & Depth and Shapes: what each value is for, with the computed contrast ratios, and the matching tokens.css variable names.
Components: usage rules and states for each component you ticked: buttons, inputs, cards, navigation, badges, modals, tables and toasts.
Do's and Don'ts: your brand rules, written as instructions an agent can check.
The sections appear in the order the specification requires, and only the component properties it defines are used: background color, text color, typography, rounded, padding, size, height and width.
How Does the Generator Keep Colors Accessible?
Every component that sets both a text color and a background color is checked with the WCAG 2.x contrast formula, and the generator chooses colors that reach 4.5:1. If your primary color is too light for white button text, the primary token moves along the same hue, to a darker step in a light theme or a lighter one in a dark theme, until it passes. The notes under the preview tell you exactly what moved and why, and the Colors section of the file states the computed ratio for each pair.
Your original color is not lost: use it for large decorative areas, illustrations or the logo, where text never sits on it. In dark themes the same logic runs in the other direction, which is why the developer-tool template ships a lighter cyan than the one it starts from.
How Do You Use DESIGN.md With an Agent?
Save the file as DESIGN.md at the root of the repository and commit it.
Add one line to AGENTS.md: "Follow DESIGN.md for all UI work; use its tokens, never raw values." The AGENTS.md generator has a house-rules box for it.
Generate the matching tokens.css and globals.css, so the variables the prose names actually exist in your code.
Ask for UI work as usual. Review the first few screens against the file, and add a do or do-not line whenever the agent gets something wrong.
Optionally run the official linter from the specification repository to check token references and contrast before you commit.
How Do the Tokens Map to Your CSS?
DESIGN.md names tokens by role, and tokens.css implements the same roles as CSS custom properties. The prose in each generated section names both, so an agent can wire them without guessing:
colors.primary, on-primary and primary-hover map to --color-primary, --color-on-primary and --color-primary-hover.
colors.background, surface, text, text-muted and border map to --color-bg, --color-surface, --color-text, --color-text-muted and --color-border.
Font families map to --font-sans, --font-serif and --font-mono; spacing to --space-*; corner radii to --radius-sm through --radius-full.
Is DESIGN.md the Same as a Kiro design.md?
No. Every Kiro spec has three files, requirements.md, design.md and tasks.md, and its lowercase design.md documents the technical design of one feature: architecture, sequence diagrams and implementation considerations. The DESIGN.md format on this page describes the visual identity of a whole product. If you use Kiro, keep both: this file at the root for how things look, and the spec files for what each feature does. The tasks.md generator writes the task list half of a spec.
Is the Generator Private?
Yes. The form, the color math and the file are built in this page. Nothing you type is uploaded or stored, and the download is created in your browser. The same choices always produce the same file.
Frequently Asked Questions
Which agents read DESIGN.md?
Any coding agent can read it when your AGENTS.md or prompt points to it, because it is plain Markdown with YAML front matter. The format was published by Google Labs with a linter and export tools, and community collections of DESIGN.md files exist for many tools.
Why did the generator change my primary color?
Because text on a button in your color would not reach 4.5:1 contrast. The token moves along the same hue until it passes, and the notes under the preview show the original and the adjusted value.
Do I need every section?
No. The specification lets you omit sections, but the ones present must stay in order. The generator always writes the core sections and leaves out Components when you tick none.
Can I edit the file by hand?
Yes. Edit the tokens and the prose like any Markdown file, keep the section order, and make sure every {token.reference} still points to a token that exists.
How is this different from tokens.css?
tokens.css is code your stylesheets import. DESIGN.md is instructions an agent reads: the same values plus the reasons, the component rules and the do and do-not lines. Use both.
How Can You Verify That Nothing Leaves This Browser?
You do not have to take our word for it. Developer tools show every request a page makes, so you can watch this page work and confirm that nothing you type is sent. The check takes under a minute.
Open your browser developer tools with F12, or Cmd+Option+I on a Mac, and select the Network tab.
Reload the page and let it finish. You will see the page's own files, its web fonts, and one anonymous page-view request. Nothing has been typed yet, so none of them can contain your input.
Click the clear icon in the Network tab so that the log is empty.
Fill in the form, load a template card, copy the file and download it.
Look at the Network tab again. It is still empty. Downloads are built in the page as Blob URLs, so even the zip never touches a server. For extra proof, turn on offline mode after the page loads: everything keeps working.
Only the feedback form can add a line to that log, and it sends only the vote and comment you type into it. 2prompt has no server code at all: no API, no model and no database of your files. The production site also sends a Content-Security-Policy header that tells your browser to refuse connections to anywhere except this site, the fonts and the anonymous analytics endpoint.