DESIGN.md

Design guidance your coding agent can read.

A practical file format for describing how an interface should look, behave, and stay consistent when humans and AI agents write code.

What it is

DESIGN.md is a markdown document that explains the visual rules of a product: color, type, spacing, layout, components, and usage.

Where it comes from

Google Stitch introduced the format as a way to bring design context into AI-assisted interface development.

What it looks like

It reads like technical documentation: sections, tokens, component notes, examples, and clear rules for building screens.

A design system your coding agent can read.

DESIGN.md is a plain markdown file that documents the design decisions behind an interface before new code gets written.

In a traditional product team, design guidance often lives across Figma files, component docs, brand notes, and scattered code. A developer can inspect those sources and make judgment calls. An AI coding assistant needs the same context in a form it can read directly.

That is the role of DESIGN.md. It turns the important parts of a design system into text: the color palette, typography scale, spacing rules, layout patterns, component behavior, interaction states, and the principles that explain when to use them.

The format comes from Google Stitch, which introduced DESIGN.md as a practical bridge between visual design and AI-assisted coding. Instead of relying on a prompt to repeat every design rule, the project can keep a durable source of truth beside the code.

In practice, it looks like a technical article about the interface. It describes the product tone, the visual foundation, the reusable pieces, and the constraints that keep screens from drifting apart. A human can skim it. An AI agent can reference it before generating a page, editing a component, or repairing visual inconsistencies.

Every Uiverse Design pack includes a DESIGN.md file alongside pure CSS, a plain HTML preview, metadata, and screenshots. The design guidance stays portable, so teams can use it in React, Vue, Svelte, HTMX, server-rendered apps, or no framework at all.

Put it in your project.

Drop DESIGN.md and the generated stylesheet into your codebase, run the integration prompt, and keep every new screen on the same visual foundation.

How to use design systems

See it in a few design systems.

Browse all