DESIGN.md prompt

A DESIGN.md prompt asks the AI to write your design rules into one plain-text file: colours, type, spacing, layout and a never list. Every later prompt points to that file, so screens stay consistent.

The prompt

Write a DESIGN.md file for [business] from the brief above.
Sections: Brand, Colour, Type, Layout, Components, Never.
Use exact values: hex codes, font names, pixel sizes,
a spacing scale and a maximum content width.
Body text contrast at least 4.5:1. Buttons at least 44px tall.
Keep it under 60 lines.
Ask me before you choose any colour or font I didn't give you.

When to use it

After the brief and before the first screen. Update the file whenever you make a design decision you want to keep.

Why it works

Google's Stitch made the DESIGN.md file a named practice in March 2026.1 It works in any tool that reads a file or a paste. Exact values are what make it useful. "Clean and modern" can't be checked. "#111111 on #FFFFFF" can. WCAG 2.2 sets 24 by 24 CSS pixels as the minimum target size,2 so 44px buttons leave room to spare.

How to adapt it

  • Add a Components section once you have buttons, cards and forms you like.
  • Add your own spacing scale, such as 4, 8, 16, 24, 40, 64.
  • Keep one DESIGN.md per brand if you run more than one site.

Mistakes to avoid

  • Adjectives instead of values. "Warm" means something different every time.
  • Letting the file grow past a page. The tool starts skipping rules.

Go deeper

The AI website design prompts guide has a full DESIGN.md template. A DESIGN.md is a small design system. The UI sizing guide has more values worth adding. This prompt is part of the plan stage. It follows the AI website design prompts guide and the six steps in how to use AI to design a website.

Read the prompts guideAll 24 prompts

Sources

  1. "Google upgrades its Stitch AI interface development tool," SiliconANGLE, 19 March 2026. siliconangle.com
  2. "Understanding success criterion 2.5.8: target size (minimum)," W3C, WCAG 2.2. w3.org

Related prompts

Never list prompt

A never list prompt tells the AI what must not appear on your site. It's the fastest way to stop the generic look, because most AI defaults are things you would never pick yourself.

Get the prompt

Design directions prompt

A design directions prompt asks the AI for several homepage options at once, each from a different named style, with the copy kept identical. You compare layout, type and colour, and pick one to build on.

Get the prompt

Website brief prompt

A website brief prompt is the first message of an AI website build. It tells the tool who visits, what they should do, what you can prove and what to avoid, so every later prompt can stay short.

Get the prompt

Component states prompt

A component states prompt asks the AI to show every state of a button, form or card side by side: default, hover, focus, error, disabled, loading and success. AI tools design the happy path and skip the rest.

Get the prompt

Want this done for you?

Want a design system your AI tools can follow? Book a call and I'll write it with you.

Book a 20-minute call