DESIGN.MD GENERATOR

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.

Zero retention: everything you type stays in this browser. Verify it yourself in DevTools.
Jump to your file
Identity
Colors
#2563eb
#475569
#0d9488
#64748b
Typography
Shape, space and depth
Components

Components to specify

Do's and Don'ts
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?

    1. Save the file as DESIGN.md at the root of the repository and commit it.
    2. 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.
    3. Generate the matching tokens.css and globals.css, so the variables the prose names actually exist in your code.
    4. 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.
    5. 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.

    1. Open your browser developer tools with F12, or Cmd+Option+I on a Mac, and select the Network tab.
    2. 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.
    3. Click the clear icon in the Network tab so that the log is empty.
    4. Fill in the form, load a template card, copy the file and download it.
    5. 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.

    Was this helpful?