# mddesign

> A registry of installable design systems for AI coding agents. Drop a design.md into your project and your agent codes in that brand's voice.

mddesign provides a CLI (`npx mddesign`) and a public registry of design systems published as markdown files (`design.md`) with frontmatter tokens (colors, typography, spacing) and prose describing the visual language.

## How AI agents should use this

When a user asks for UI in a specific brand voice, or wants a polished aesthetic without specifying one:

1. Search: `npx mddesign search <query> --json`
2. Inspect: `npx mddesign get <slug> --md` (no install)
3. Install if good: `npx mddesign add <slug>`
4. Read `./design.md` and apply it when generating UI

Full agent guide: [AGENTS.md](https://design.yadbarzel.info/AGENTS.md)

## API

- [API: list registry](https://design.yadbarzel.info/api/designs): Public JSON, all metadata
- [API: design detail](https://design.yadbarzel.info/api/designs/stripe): Full bundle for one design including raw design.md and preview HTML
- [API: search by query](https://design.yadbarzel.info/api/designs?q=dashboard): Filter
- [API: search by tag](https://design.yadbarzel.info/api/designs?tag=fintech): Filter by tag
- [Install badge](https://design.yadbarzel.info/b/stripe): SVG badge for READMEs

Rate limit: 60 GET/min/IP, 30 install pings/min/IP, 10 publishes/hour/IP.

## CLI

- [npm package: mddesign](https://www.npmjs.com/package/mddesign): Run with `npx mddesign <command>` — no install needed
- Commands: list, search, info, get, add, update, remove, random, init, validate, publish

## Pages

- [Homepage](https://design.yadbarzel.info/): Browse, intro
- [How it works](https://design.yadbarzel.info/about): Concept, examples, FAQ
- [Browse all designs](https://design.yadbarzel.info/browse): Filtering UI
- [Publish guide](https://design.yadbarzel.info/publish): How to author + publish
- [Privacy](https://design.yadbarzel.info/privacy)
- [Terms](https://design.yadbarzel.info/terms)