Template

shadcn/ui DESIGN.md template

shadcn/ui gives AI agents a strong component base, but the default look can still feel generic. A shadcn DESIGN.md adds product-specific choices: density, radius, color roles, button emphasis, table behavior, form layout, modal tone, and empty states.

Make primitives feel like a product

The file should describe how cards, inputs, badges, tables, dialogs, dropdowns, sidebars, and settings sections should look in this specific product. It should also name which default shadcn patterns are acceptable and which need brand tuning.

Use it before generation

Ask the agent to read DESIGN.md before adding shadcn components. The result is still fast, but it is guided by product taste instead of default component examples.

Start here

Move from this landing page into deeper DESIGN.md references, examples, and guides.

Search the catalog