shadcn/ui Best Practices

Comprehensive best practices guide for shadcn/ui applications, designed for AI agents and LLMs. Contains 48 rules across 8 categories, prioritized by impact to guide component composition, styling, accessibility, and performance optimization.

When to Apply

Reference these guidelines when:

• Installing and configuring shadcn/ui in a project
• Composing component structures with Dialog, Select, or Dropdown
• Implementing theming with CSS variables and dark mode
• Building accessible forms with validation and error handling
• Creating data tables with TanStack Table integration

Rule Categories by Priority