DESIGN.md for shadcn/ui
How to keep shadcn/ui fast without letting your product feel generic.
The risk
shadcn/ui speeds up delivery, but AI agents often stop at the default look. DESIGN.md adds brand constraints on top of the component primitives.
What to document
Spell out density, border weight, chart treatment, dashboard patterns, empty states, and how to adapt base primitives for your product.
Result
Agents can still move fast with shadcn, but the surface feels like your company instead of a starter kit.
Have a public DESIGN.md?
Create an account and submit the source URL so it can be reviewed and indexed in the directory.
Submit DESIGN.md →