Shadcn UI Designer
Core Design Prompt
When designing any UI, apply this philosophy:
"Design a modern, clean UI following Shadcn principles: apply minimalism with ample white space and simple sans-serif typography; use strategic, subtle shadows for depth and hierarchy; ensure accessibility with high-contrast neutrals and scalable elements; provide beautiful defaults for buttons, cards, and forms that compose modularly; incorporate fluid, non-intrusive animations; maintain a professional palette of soft grays, whites, and minimal accents like purple; output as responsive, customizable React code with Tailwind CSS."
Design Rules
1. Typography Rule
- Limit to 2-3 font weights and sizes per screen
- Use Inter or system fonts for consistency
<h1 className="text-2xl font-semibold">Title</h1>
<p className="text-sm text-muted-foreground">Description</p>
2. Spacing Rule
- 4px-based scale: 4px, 8px, 16px, 24px, 32px
- Tailwind utilities:
p-1, p-2, p-4, p-6, p-8
<div className="p-6 space-y-4">
<div className="mb-8">...</div>
</div>
3. Color Rule
- Base on OKLCH for perceptual uniformity
- Use 50-950 scale grays (background, foreground, muted)
- Subtle accents at 10% opacity to avoid visual noise
<Card className="bg-card text-card-foreground border-border">
<Button className="bg-primary text-primary-foreground">Action</Button>
<div className="bg-primary/10">Subtle accent</div>
</Card>
4. Shadow Rule
- 3 levels only:
shadow-sm: Subtle lift (0 1px 2px) - for cards
shadow-md: Medium depth (0 4px 6px) - for dropdowns
shadow-lg: High elevation (0 10px 15px) - for modals
<Card className="shadow-sm hover:shadow-md transition-shadow">
5. Animation Rule
- 200-300ms durations
- ease-in-out curves for transitions
- Subtle feedback only (hovers, state changes) - no decorative flourishes
<Button className="transition-colors duration-200 hover:bg-primary/90">
<Card className="transition-transform duration-200 hover:scale-105">
6. Accessibility Rule
- ARIA labels on all interactive elements
- WCAG 2.1 AA contrast ratios (4.5:1 minimum)
- Keyboard-focus styles matching hover states
- Semantic HTML structure
<button
aria-label="Submit form"
className="focus:ring-2 focus:ring-primary focus:outline-none"
>
Submit
</button>
Workflow
1. Interview User (if details not provided)
- Scope: Full page, section, or specific component?
- Type: Dashboard, form, card, modal, table?
- Target file: Where should this be implemented?
- Requirements: Features, interactions, data to display?
2. Design & Implement
- Match existing design - align with current UI patterns in the app
- Build UI first - complete visual interface before adding logic
- Modular components - break large pages into focused, reusable pieces
- Apply all 6 rules above strictly
- Verify accessibility - keyboard navigation, contrast, ARIA labels
- Test responsiveness - mobile, tablet, desktop
3. Component Structure Pattern
import { Button } from "@/components/ui/button"
import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card"
export function MyComponent() {
return (
<div className="container mx-auto p-6 space-y-6">
<header>
<h1 className="text-2xl font-semibold">Page Title</h1>
</header>
<main className="grid gap-4">
<Card className="shadow-sm">
<CardHeader>
<CardTitle>Section</CardTitle>
</CardHeader>
<CardContent>
{/* Content */}
</CardContent>
</Card>
</main>
</div>
)
}
4. Quality Checklist
Before completing, verify:
Common Patterns
Dashboard Page
<div className="container mx-auto p-6 space-y-6">
<header className="space-y-2">
<h1 className="text-2xl font-semibold">Dashboard</h1>
<p className="text-sm text-muted-foreground">Overview of metrics</p>
</header>
<div className="grid gap-4 md:grid-cols-2 lg:grid-cols-4">
{stats.map(stat => (
<Card key={stat.id} className="shadow-sm">
<CardHeader className="pb-2">
<CardTitle className="text-sm font-medium text-muted-foreground">
{stat.title}
</CardTitle>
</CardHeader>
<CardContent>
<div className="text-2xl font-semibold">{stat.value}</div>
</CardContent>
</Card>
))}
</div>
</div>
Form Pattern
<form className="space-y-6">
<div className="space-y-4">
<div className="space-y-2">
<Label htmlFor="name">Full Name</Label>
<Input id="name" placeholder="John Doe" />
</div>
<div className="space-y-2">
<Label htmlFor="email">Email</Label>
<Input id="email" type="email" placeholder="john@example.com" />
</div>
</div>
<Button type="submit" className="w-full transition-colors duration-200">
Submit
</Button>
</form>
Data Table Pattern
<Card className="shadow-sm">
<CardHeader>
<CardTitle className="text-xl font-semibold">Recent Orders</CardTitle>
</CardHeader>
<CardContent>
<Table>
<TableHeader>
<TableRow>
<TableHead>Order ID</TableHead>
<TableHead>Customer</TableHead>
<TableHead>Status</TableHead>
</TableRow>
</TableHeader>
<TableBody>
{orders.map(order => (
<TableRow key={order.id} className="hover:bg-muted/50 transition-colors">
<TableCell className="font-medium">{order.id}</TableCell>
<TableCell>{order.customer}</TableCell>
<TableCell>
<Badge variant="default">{order.status}</Badge>
</TableCell>
</TableRow>
))}
</TableBody>
</Table>
</CardContent>
</Card>
Best Practices
- Match existing design - new designs align with current UI screens and components
- UI-first approach - complete visual interface before adding business logic
- Modular code - small, focused, reusable components (avoid monolithic pages)
- Token efficiency - concise, well-structured code
- Consistency - follow existing color, spacing, and typography patterns
- Composability - build with shadcn's philosophy of small components that work together
Common Shadcn Components
- Layout: Card, Tabs, Sheet, Dialog, Popover
- Forms: Input, Textarea, Select, Checkbox, Radio, Switch, Label
- Buttons: Button, Toggle, ToggleGroup
- Display: Badge, Avatar, Separator, Skeleton, Table
- Feedback: Alert, Toast, Progress
- Navigation: NavigationMenu, Dropdown, Command
References
1---2name: shadcn-ui-designer3description: "Designs modern, clean UI components and pages following Shadcn principles with minimalism, accessibility, and beautiful defaults. Use when building new UI components, redesigning pages, or creating consistent UI or simply wanting to use shadcn."4version: "1.0.0"5allowed-tools: ["file_write", "file_read", "shadcn"]6metadata:7 source: https://skillmd.com/skills/bishal-pdmsft/shadcn-ui-designer8---910# Shadcn UI Designer1112## Core Design Prompt1314When designing any UI, apply this philosophy:1516> "Design a modern, clean UI following Shadcn principles: apply minimalism with ample white space and simple sans-serif typography; use strategic, subtle shadows for depth and hierarchy; ensure accessibility with high-contrast neutrals and scalable elements; provide beautiful defaults for buttons, cards, and forms that compose modularly; incorporate fluid, non-intrusive animations; maintain a professional palette of soft grays, whites, and minimal accents like purple; output as responsive, customizable React code with Tailwind CSS."1718## Design Rules1920### 1. Typography Rule21- Limit to **2-3 font weights and sizes** per screen22- Use **Inter** or system fonts for consistency23```tsx24<h1 className="text-2xl font-semibold">Title</h1>25<p className="text-sm text-muted-foreground">Description</p>26```2728### 2. Spacing Rule29- **4px-based scale**: 4px, 8px, 16px, 24px, 32px30- Tailwind utilities: `p-1`, `p-2`, `p-4`, `p-6`, `p-8`31```tsx32<div className="p-6 space-y-4">33 <div className="mb-8">...</div>34</div>35```3637### 3. Color Rule38- Base on **OKLCH** for perceptual uniformity39- Use **50-950 scale grays** (background, foreground, muted)40- **Subtle accents** at 10% opacity to avoid visual noise41```tsx42<Card className="bg-card text-card-foreground border-border">43 <Button className="bg-primary text-primary-foreground">Action</Button>44 <div className="bg-primary/10">Subtle accent</div>45</Card>46```4748### 4. Shadow Rule49- **3 levels only**:50 - `shadow-sm`: Subtle lift (0 1px 2px) - for cards51 - `shadow-md`: Medium depth (0 4px 6px) - for dropdowns52 - `shadow-lg`: High elevation (0 10px 15px) - for modals53```tsx54<Card className="shadow-sm hover:shadow-md transition-shadow">55```5657### 5. Animation Rule58- **200-300ms durations**59- **ease-in-out** curves for transitions60- **Subtle feedback** only (hovers, state changes) - no decorative flourishes61```tsx62<Button className="transition-colors duration-200 hover:bg-primary/90">63<Card className="transition-transform duration-200 hover:scale-105">64```6566### 6. Accessibility Rule67- **ARIA labels** on all interactive elements68- **WCAG 2.1 AA** contrast ratios (4.5:1 minimum)69- **Keyboard-focus styles** matching hover states70- **Semantic HTML** structure71```tsx72<button73 aria-label="Submit form"74 className="focus:ring-2 focus:ring-primary focus:outline-none"75>76 Submit77</button>78```7980## Workflow8182### 1. Interview User (if details not provided)83- **Scope**: Full page, section, or specific component?84- **Type**: Dashboard, form, card, modal, table?85- **Target file**: Where should this be implemented?86- **Requirements**: Features, interactions, data to display?8788### 2. Design & Implement891. **Match existing design** - align with current UI patterns in the app902. **Build UI first** - complete visual interface before adding logic913. **Modular components** - break large pages into focused, reusable pieces924. **Apply all 6 rules** above strictly935. **Verify accessibility** - keyboard navigation, contrast, ARIA labels946. **Test responsiveness** - mobile, tablet, desktop9596### 3. Component Structure Pattern97```tsx98import { Button } from "@/components/ui/button"99import { Card, CardHeader, CardTitle, CardContent } from "@/components/ui/card"100101export function MyComponent() {102 return (103 <div className="container mx-auto p-6 space-y-6">104 <header>105 <h1 className="text-2xl font-semibold">Page Title</h1>106 </header>107108 <main className="grid gap-4">109 <Card className="shadow-sm">110 <CardHeader>111 <CardTitle>Section</CardTitle>112 </CardHeader>113 <CardContent>114 {/* Content */}115 </CardContent>116 </Card>117 </main>118 </div>119 )120}121```122123### 4. Quality Checklist124Before completing, verify:125- [ ] Uses shadcn/ui components where applicable126- [ ] 2-3 font weights/sizes max per screen127- [ ] 4px-based spacing throughout128- [ ] Theme color variables (no hardcoded colors)129- [ ] 3 shadow levels max, strategically applied130- [ ] Animations 200-300ms with ease-in-out131- [ ] ARIA labels on interactive elements132- [ ] WCAG AA contrast ratios (4.5:1 min)133- [ ] Keyboard focus styles implemented134- [ ] Mobile-first responsive design135- [ ] Modular, reusable code structure136137## Common Patterns138139### Dashboard Page140```tsx141<div className="container mx-auto p-6 space-y-6">142 <header className="space-y-2">143 <h1 className="text-2xl font-semibold">Dashboard</h1>144 <p className="text-sm text-muted-foreground">Overview of metrics</p>145 </header>146147 <div className="grid gap-4 md:grid-cols-2 lg:grid-cols-4">148 {stats.map(stat => (149 <Card key={stat.id} className="shadow-sm">150 <CardHeader className="pb-2">151 <CardTitle className="text-sm font-medium text-muted-foreground">152 {stat.title}153 </CardTitle>154 </CardHeader>155 <CardContent>156 <div className="text-2xl font-semibold">{stat.value}</div>157 </CardContent>158 </Card>159 ))}160 </div>161</div>162```163164### Form Pattern165```tsx166<form className="space-y-6">167 <div className="space-y-4">168 <div className="space-y-2">169 <Label htmlFor="name">Full Name</Label>170 <Input id="name" placeholder="John Doe" />171 </div>172 <div className="space-y-2">173 <Label htmlFor="email">Email</Label>174 <Input id="email" type="email" placeholder="john@example.com" />175 </div>176 </div>177 <Button type="submit" className="w-full transition-colors duration-200">178 Submit179 </Button>180</form>181```182183### Data Table Pattern184```tsx185<Card className="shadow-sm">186 <CardHeader>187 <CardTitle className="text-xl font-semibold">Recent Orders</CardTitle>188 </CardHeader>189 <CardContent>190 <Table>191 <TableHeader>192 <TableRow>193 <TableHead>Order ID</TableHead>194 <TableHead>Customer</TableHead>195 <TableHead>Status</TableHead>196 </TableRow>197 </TableHeader>198 <TableBody>199 {orders.map(order => (200 <TableRow key={order.id} className="hover:bg-muted/50 transition-colors">201 <TableCell className="font-medium">{order.id}</TableCell>202 <TableCell>{order.customer}</TableCell>203 <TableCell>204 <Badge variant="default">{order.status}</Badge>205 </TableCell>206 </TableRow>207 ))}208 </TableBody>209 </Table>210 </CardContent>211</Card>212```213214## Best Practices215216- **Match existing design** - new designs align with current UI screens and components217- **UI-first approach** - complete visual interface before adding business logic218- **Modular code** - small, focused, reusable components (avoid monolithic pages)219- **Token efficiency** - concise, well-structured code220- **Consistency** - follow existing color, spacing, and typography patterns221- **Composability** - build with shadcn's philosophy of small components that work together222223## Common Shadcn Components224225- **Layout**: Card, Tabs, Sheet, Dialog, Popover226- **Forms**: Input, Textarea, Select, Checkbox, Radio, Switch, Label227- **Buttons**: Button, Toggle, ToggleGroup228- **Display**: Badge, Avatar, Separator, Skeleton, Table229- **Feedback**: Alert, Toast, Progress230- **Navigation**: NavigationMenu, Dropdown, Command231232## References233234- [Shadcn UI](https://ui.shadcn.com)235- [Tailwind CSS v4](https://tailwindcss.com)236- [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/)