Free · No sign-up · Claude Code · Cursor · Codex
Give your agenta DESIGN.md.
Paste your design tokens — CSS variables, a Tailwind config, token JSON or a list of hex codes — and get a DESIGN.md: the colours, type, radii and rules your coding agent should use instead of inventing its own.
your tokens · css variables · 11 tokens
# Design system: Your brand
Exported from Xtractly.
## Rules for coding agents
- Use these tokens for every colour, font size and radius. Don't invent new hex values or Tailwind palette colours (no `blue-500`).
- Reference tokens as CSS variables (`var(--brand)`) or the matching Tailwind utilities if the project maps them.
- Primary actions use #5e6ad2 with #ffffff text.
- Text is #0f1011 on #ffffff.
- Set type in Inter; fall back to the system sans-serif stack.
- Corner radii come from the radius scale below; pick the nearest step rather than a new value.
## Colour
| Token | Value | Role | Uses on page |
| --- | --- | --- | --- |
| `--brand` | `#5e6ad2` | Primary — main actions, links, focus | — |
| `--background` | `#ffffff` | Page background | — |
| `--foreground` | `#0f1011` | Body text | — |
| `--surface` | `#f7f8f8` | Cards and raised surfaces | — |
| `--accent` | `#e8e9fb` | Accent — highlights, badges, emphasis | — |
## Typography
Font family: **Inter**
| Token | Size |
| --- | --- |
| `--text-sm` | `0.875rem` |
| `--text-base` | `1rem` |
| `--text-2xl` | `1.5rem` |
## Radius
- `--radius-sm`: `6px`
- `--radius-md`: `10px`
## CSS
```css
/* Your brand */
:root {
--brand: #5e6ad2;
--background: #ffffff;
--foreground: #0f1011;
--surface: #f7f8f8;
--accent: #e8e9fb;
--radius-sm: 6px;
--radius-md: 10px;
--text-sm: 0.875rem;
--text-base: 1rem;
--text-2xl: 1.5rem;
--font-sans: "Inter", sans-serif;
}
```
Runs in your browser — nothing you paste is uploaded or stored.
live preview · your tokens
Your brand · typeface
Inter
sans-serif as fallback
- Styles
- 3 styles
- Colours
- 5 colours
type scale
Aa Bb Cc Dd Ee Ff Gg
Primary colour
#5E6AD2
How to write a DESIGN.md for your agent, in three steps.
Paste your tokens
CSS variables from globals.css, a Tailwind config, W3C or Tokens Studio JSON, or just hex codes, one per line. Or start from a real site's captured palette below the box.
Name the roles
The rules use role names: --brand or --primary for actions, --background and --foreground for the page, --surface for cards. Rename a variable in the box and the DESIGN.md updates as you type.
Commit it and point your agent at it
Save it as DESIGN.md in your repo root, then add one line to AGENTS.md, CLAUDE.md or your Cursor rules: “Follow DESIGN.md for every colour, font size and radius.”
Questions
What is a DESIGN.md file?
A Markdown file in your repository that describes your design system for AI coding agents: the exact colours, fonts, sizes and radii to use, and rules like “don't invent new hex values”. Agents such as Claude Code, Cursor and Codex read Markdown files you point them at, so a DESIGN.md keeps generated UI on-brand.
Where do I put DESIGN.md so my agent uses it?
In your repository root, next to README.md. Then reference it from the file your agent already loads: AGENTS.md, CLAUDE.md, .cursor/rules or .github/copilot-instructions.md — for example “Follow DESIGN.md for every colour, font size and radius.”
Which formats can I paste?
CSS custom properties (a :root block, a Tailwind v4 @theme block or a shadcn/ui globals.css), a Tailwind v3 tailwind.config.js, W3C design tokens (DTCG) or Tokens Studio JSON, Figma variables exported as JSON, or a plain list of colours. The format is detected as you paste.
Is what I paste uploaded anywhere?
No. The DESIGN.md is generated in your browser by the same code Xtractly's exports use, and nothing you paste is sent to a server or stored.
How do I keep DESIGN.md in sync with my design system?
Regenerate it when your tokens change, or connect your agent to Xtractly's Agent Bridge (MCP): get_theme returns a saved theme as DESIGN.md, CSS or Tailwind on request, so the agent always reads the current version.
More free tools, same idea.
Each one runs in your browser and works on tokens you already have.
- Brand colours → shadcn :root
shadcn/ui theme generator
Brand colours in, a complete shadcn/ui :root theme out, with readable foregrounds.
Open the tool → - Any tokens → any format
Design tokens converter
Convert tokens between DTCG JSON, Tokens Studio, Figma variables, CSS and Tailwind.
Open the tool → - :root → @theme
CSS variables → Tailwind
Turn :root custom properties into a Tailwind v4 @theme or a v3 config.
Open the tool →
It only knows what you paste.
Read it off any live site.
Xtractly's extension reads the real tokens off any live site — computed colours, the type scale, radii — and the Agent Bridge hands them to your agent directly, so the DESIGN.md never goes stale.
Add to Chrome, free