DESIGN.md
File format and linter for describing a design system to coding agents
What it is
A specification from Google Labs for a single Markdown file that pairs machine-readable design tokens in YAML with prose explaining how to apply them. The accompanying CLI lints a file against the spec, checks token references and WCAG contrast, and diffs two versions to catch regressions.
Good for
- Write a DESIGN.md for an existing brand
- Lint tokens and contrast ratios before a build
- Diff two versions of a design system
Install or run
npx @google/design.md lint DESIGN.mdCommand as given in the project README. Read the repository before you run anything on your machine.
What you need
Node.js
Sources
- https://github.com/google-labs-code/design.md (project README, read 10 Nov 2026)
- https://api.github.com/repos/google-labs-code/design.md (GitHub API, read 13 Nov 2026)
The summary is ours, written from the README. Spotted an error? See how we work.