Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

official-design-md

Official DESIGN.md files published by companies and projects themselves.

DESIGN.md Count Discord

Official DESIGN.md

The tracker for first-party DESIGN.md adoption. Every entry here is a DESIGN.md published by the company or project itself — not extracted, not reverse-engineered, not community-made.

If a team ships an official DESIGN.md in their repo or docs, it belongs here.

What is DESIGN.md?

DESIGN.md is a new concept introduced by Google Stitch. A plain-text design system document that AI agents read to generate consistent UI.

It's just a markdown file. No Figma exports, no JSON schemas, no special tooling. Drop it into your project root and any AI coding agent or Google Stitch instantly understands how your UI should look. Markdown is the format LLMs read best, so there's nothing to parse or configure.

File Who reads it What it defines
AGENTS.md Coding agents How to build the project
DESIGN.md Design agents How the project should look and feel

This repo tracks official DESIGN.md files — the ones companies and projects publish themselves.

Looking for ready-to-use DESIGN.md files extracted from real websites? Check out awesome-design-md.

Collection

  • Atlassian - Maker of Jira and Confluence. Atlassian Design System — structured blue palette, enterprise clarity
  • Clerk - Auth and user management platform. Signature purple, brand system written for humans and AI agents
  • Mintlify - Documentation platform. Token-driven design system, clean and reading-optimized
  • Nuxt - Vue framework. Powered by Nuxt UI and Tailwind CSS v4, dark mode by default
  • Resend - Email API for developers. Minimal dark theme, monospace accents
  • Vercel - Frontend deployment platform. Geist design system — black and white precision, developer-first minimalism
  • VoltAgent - AI agent framework. Void-black canvas, emerald accent, terminal-native

The DESIGN.md standard is new and official adoption is growing. Spotted one in the wild? Open an issue or send a PR.

How to Use

  1. Follow the link to the official DESIGN.md
  2. Copy it into your project root
  3. Tell your AI agent to use it

Contributing

Found an official DESIGN.md in the wild? We'd love to list it.

  • Add an entry: Link to the official file with the company name and a one-line description
  • Report a change: Let us know if an official file moved or was taken down

Before opening a PR, please open an issue first to discuss your idea and get feedback from maintainers.

License

MIT License - see LICENSE

This repository is a curated index of officially published DESIGN.md documents. All linked files remain the property of their respective owners. We do not host or claim ownership of any linked content.

About

Official DESIGN.md files published by companies themselves. First-party design systems that AI agents read to generate consistent UI.

Topics

Resources

Stars

461 stars

Watchers

6 watching

Forks

Releases

Packages

Contributors