Open library · 423 documented files

DESIGN MD (DESIGN.md)

A Markdown file at the project root that teaches the AI agent your design system's colors, typography, and visual patterns — before generating any component.

Compatible with Claude Code · Cursor · Kiro · Windsurf · Cline

Library

423 DESIGN.md ready to use

View all →

01

Agents don't remember your design

LLMs process each prompt in isolation. Without a reference in the repository, each generated component uses different visual decisions.

02

DESIGN.md enters the context window

YAML front matter with design tokens (colors, typography, spacing) + Markdown prose with rationale and constraints. The agent reads it before generating any UI.

03

Copy from library, paste in project

423 documented design systems. Choose a style, download the DESIGN.md and configure your agent.

Reading

Articles and guides

View all →

Structure

Anatomy of a DESIGN.md

Eight sections in canonical order from the official spec. YAML front matter with tokens + Markdown prose with rationale. The agent reads the full file before generating any component.

View full format →
DESIGN.md
---
name: Productivity App
colors:
  primary: "#2665fd"
  surface: "#0b1326"
  on-surface: "#dae2fd"
typography:
  headline:
    fontFamily: Geist
    fontSize: 2rem
    fontWeight: 600
  body:
    fontFamily: Geist
    fontSize: 1rem
    fontWeight: 400
rounded:
  sm: 4px
  md: 8px
  lg: 12px
spacing:
  sm: 8px
  md: 16px
  lg: 32px
---

## Overview
Minimal interface for a productivity app.
Clean lines, high information density.

## Colors
- **Primary** (#2665fd): CTAs, active states
- **Surface** (#0b1326): Backgrounds

## Typography
- Headlines: Geist, semi-bold
- Body: Geist, regular, 14–16px

## Components
- Buttons: rounded-lg, primary filled
- Inputs: 1px border, surface-variant bg

## Do's and Don'ts
- Do use primary only for main actions
- Don't mix rounded and sharp corners

Setup Guides

Configure DESIGN.md with your AI coding agent