Skip to content

try-works/role-model / .agents/skills/ui-design-system

ui-design-system

Unverified

React UI component systems with TailwindCSS + Radix + shadcn/ui. Stack: TailwindCSS (styling), Radix UI (primitives), shadcn/ui (components), React/Next.js. Capabilities: design system architecture, accessible components, responsive layouts, theming, dark mode, component composition. Actions: review, design, build, improve, refactor UI components. Keywords: TailwindCSS, Radix UI, shadcn/ui, design system, component library, accessibility, ARIA, responsive, dark mode, theming, CSS variables, component architecture, atomic design, design tokens, variant, slot, composition. Use when: building component libraries, implementing shadcn/ui, creating accessible UIs, setting up design systems, adding dark mode/theming, reviewing UI component architecture.

FileKindSize
SKILL.mdskill md19.6 KB
canvas-fonts/ArsenalSC-OFL.txtmarkdown4.3 KB
canvas-fonts/ArsenalSC-Regular.ttfbinary162.0 KB
canvas-fonts/BigShoulders-Bold.ttfbinary92.3 KB
canvas-fonts/BigShoulders-OFL.txtmarkdown4.3 KB
canvas-fonts/BigShoulders-Regular.ttfbinary92.2 KB
canvas-fonts/Boldonse-OFL.txtmarkdown4.3 KB
canvas-fonts/Boldonse-Regular.ttfbinary75.4 KB
canvas-fonts/BricolageGrotesque-Bold.ttfbinary88.8 KB
canvas-fonts/BricolageGrotesque-OFL.txtmarkdown4.3 KB
canvas-fonts/BricolageGrotesque-Regular.ttfbinary88.8 KB
canvas-fonts/CrimsonPro-Bold.ttfbinary104.8 KB
canvas-fonts/CrimsonPro-Italic.ttfbinary106.3 KB
canvas-fonts/CrimsonPro-OFL.txtmarkdown4.3 KB
canvas-fonts/CrimsonPro-Regular.ttfbinary104.2 KB
canvas-fonts/DMMono-OFL.txtmarkdown4.3 KB
canvas-fonts/DMMono-Regular.ttfbinary47.7 KB
canvas-fonts/EricaOne-OFL.txtmarkdown4.3 KB
canvas-fonts/EricaOne-Regular.ttfbinary24.3 KB
canvas-fonts/GeistMono-Bold.ttfbinary76.5 KB
canvas-fonts/GeistMono-OFL.txtmarkdown4.3 KB
canvas-fonts/GeistMono-Regular.ttfbinary76.4 KB
canvas-fonts/Gloock-OFL.txtmarkdown4.3 KB
canvas-fonts/Gloock-Regular.ttfbinary92.9 KB
canvas-fonts/IBMPlexMono-Bold.ttfbinary132.8 KB
canvas-fonts/IBMPlexMono-OFL.txtmarkdown4.3 KB
canvas-fonts/IBMPlexMono-Regular.ttfbinary130.7 KB
canvas-fonts/IBMPlexSerif-Bold.ttfbinary157.2 KB
canvas-fonts/IBMPlexSerif-BoldItalic.ttfbinary165.9 KB
canvas-fonts/IBMPlexSerif-Italic.ttfbinary166.0 KB
canvas-fonts/IBMPlexSerif-Regular.ttfbinary156.6 KB
canvas-fonts/InstrumentSans-Bold.ttfbinary66.5 KB
canvas-fonts/InstrumentSans-BoldItalic.ttfbinary68.4 KB
canvas-fonts/InstrumentSans-Italic.ttfbinary68.3 KB
canvas-fonts/InstrumentSans-OFL.txtmarkdown4.3 KB
canvas-fonts/InstrumentSans-Regular.ttfbinary66.4 KB
canvas-fonts/InstrumentSerif-Italic.ttfbinary69.2 KB
canvas-fonts/InstrumentSerif-Regular.ttfbinary67.7 KB
canvas-fonts/Italiana-OFL.txtmarkdown4.3 KB
canvas-fonts/Italiana-Regular.ttfbinary26.5 KB
canvas-fonts/JetBrainsMono-Bold.ttfbinary112.1 KB
canvas-fonts/JetBrainsMono-OFL.txtmarkdown4.3 KB
canvas-fonts/JetBrainsMono-Regular.ttfbinary112.2 KB
canvas-fonts/Jura-Light.ttfbinary150.7 KB
canvas-fonts/Jura-Medium.ttfbinary150.9 KB
canvas-fonts/Jura-OFL.txtmarkdown4.3 KB
canvas-fonts/LibreBaskerville-OFL.txtmarkdown4.3 KB
canvas-fonts/LibreBaskerville-Regular.ttfbinary144.1 KB
canvas-fonts/Lora-Bold.ttfbinary130.7 KB
canvas-fonts/Lora-BoldItalic.ttfbinary137.0 KB
canvas-fonts/Lora-Italic.ttfbinary136.1 KB
canvas-fonts/Lora-OFL.txtmarkdown4.3 KB
canvas-fonts/Lora-Regular.ttfbinary130.8 KB
canvas-fonts/NationalPark-Bold.ttfbinary77.4 KB
canvas-fonts/NationalPark-OFL.txtmarkdown4.3 KB
canvas-fonts/NationalPark-Regular.ttfbinary74.6 KB
canvas-fonts/NothingYouCouldDo-OFL.txtmarkdown4.3 KB
canvas-fonts/NothingYouCouldDo-Regular.ttfbinary31.3 KB
canvas-fonts/Outfit-Bold.ttfbinary54.1 KB
canvas-fonts/Outfit-OFL.txtmarkdown4.3 KB
canvas-fonts/Outfit-Regular.ttfbinary53.6 KB
canvas-fonts/PixelifySans-Medium.ttfbinary49.9 KB
canvas-fonts/PixelifySans-OFL.txtmarkdown4.3 KB
canvas-fonts/PoiretOne-OFL.txtmarkdown4.3 KB
canvas-fonts/PoiretOne-Regular.ttfbinary44.2 KB
canvas-fonts/RedHatMono-Bold.ttfbinary33.6 KB
canvas-fonts/RedHatMono-OFL.txtmarkdown4.3 KB
canvas-fonts/RedHatMono-Regular.ttfbinary33.7 KB
canvas-fonts/Silkscreen-OFL.txtmarkdown4.3 KB
canvas-fonts/Silkscreen-Regular.ttfbinary31.2 KB
canvas-fonts/SmoochSans-Medium.ttfbinary58.3 KB
canvas-fonts/SmoochSans-OFL.txtmarkdown4.3 KB
canvas-fonts/Tektur-Medium.ttfbinary74.5 KB
canvas-fonts/Tektur-OFL.txtmarkdown4.3 KB
canvas-fonts/Tektur-Regular.ttfbinary73.8 KB
canvas-fonts/WorkSans-Bold.ttfbinary186.8 KB
canvas-fonts/WorkSans-BoldItalic.ttfbinary171.7 KB
canvas-fonts/WorkSans-Italic.ttfbinary170.2 KB
canvas-fonts/WorkSans-OFL.txtmarkdown4.3 KB
canvas-fonts/WorkSans-Regular.ttfbinary184.5 KB
canvas-fonts/YoungSerif-OFL.txtmarkdown4.3 KB
canvas-fonts/YoungSerif-Regular.ttfbinary102.7 KB
references/CUSTOMIZATION.mdmarkdown7.2 KB
references/DESIGN_TOKENS.mdmarkdown4.3 KB
references/INTEGRATION_PATTERNS.mdmarkdown15.0 KB
references/PERFORMANCE_OPTIMIZATION.mdmarkdown7.8 KB
references/RADIX_REFERENCE.mdmarkdown15.1 KB
references/RESPONSIVE_PATTERNS.mdmarkdown4.2 KB
references/SHADCN_REFERENCE.mdmarkdown10.9 KB
references/TAILWIND_REFERENCE.mdmarkdown10.1 KB
references/canvas-design-system.mdmarkdown7.7 KB
scripts/.coverageother52.0 KB
scripts/requirements.txtmanifest444 B
scripts/shadcn_add.pyscript7.8 KB
scripts/tailwind_config_gen.pyscript13.3 KB
scripts/tests/coverage-ui.jsonconfig48.8 KB
scripts/tests/requirements.txtmanifest52 B
scripts/tests/test_shadcn_add.pyscript9.7 KB
scripts/tests/test_tailwind_config_gen.pyscript11.9 KB

references/RESPONSIVE_PATTERNS.md

View on GitHub
# Responsive Design Patterns

## Breakpoint Philosophy

Mobile-first breakpoints ensure optimal experience across all devices.

### Standard Breakpoints
- **Base**: 0-639px (mobile)
- **sm**: 640px+ (large phones, small tablets)
- **md**: 768px+ (tablets)
- **lg**: 1024px+ (laptops, desktops)
- **xl**: 1280px+ (large desktops)
- **2xl**: 1536px+ (ultra-wide)

### Breakpoint Strategy
1. **Design mobile-first**: Start with smallest screen
2. **Progressive enhancement**: Add features as screen grows
3. **Test real devices**: Don't rely only on browser resize
4. **Consider touch**: Mobile isn't just about screen size

## Responsive Component Patterns

### Layout Shifts
Components adapt their structure based on available space:
- **Column to row**: Stack vertically on mobile, horizontal on desktop
- **Stacked to grid**: Single column → multi-column grid
- **Flex direction**: `flex-col` → `md:flex-row`

### Component Switching
Different components for different screen sizes:
- **Dialog on desktop, Drawer on mobile**: Better UX per device
- **Full menu vs hamburger**: Navigation patterns
- **Expanded vs collapsed**: Sidebar behavior

### Content Visibility
Strategic showing/hiding of content:
- **`hidden md:block`**: Show only on larger screens
- **`block md:hidden`**: Show only on mobile
- **Progressive disclosure**: Essential first, details later

### Typography Scaling
Text sizes adapt to screen size:
- **`text-sm md:text-base lg:text-lg`**: Responsive font sizes
- **Fluid typography**: `clamp()` for smooth scaling
- **Line height adjustments**: Tighter on mobile, looser on desktop

## Container Queries

Use for component-based responsiveness instead of viewport-based.

### Why Container Queries
- **Component-centric**: Respond to parent width, not viewport
- **Modular design**: Components work anywhere
- **Better reusability**: Same component, different contexts

### Implementation
```css
/* Component responds to container, not viewport */
@container (min-width: 400px) {
  .card {
    flex-direction: row;
  }
}
```

### Tailwind Container Queries
- Use `@container` utilities with Tailwind
- Define container contexts with `@container` directive
- Query container size with `@min-` and `@max-` variants

## Responsive Strategies

### Strategy 1: Mobile-First Classes
Start with mobile styles, add breakpoints:
```jsx
<div className="flex flex-col md:flex-row lg:gap-8">
```

### Strategy 2: Responsive Grid
Auto-responsive grids without breakpoints:
```jsx
<div className="grid grid-cols-[repeat(auto-fit,minmax(250px,1fr))]">
```

### Strategy 3: Conditional Rendering
Different components per breakpoint:
```jsx
{isMobile ? <Drawer /> : <Dialog />}
```

### Strategy 4: Fluid Spacing
Use viewport-relative units:
```jsx
<div className="px-4 md:px-8 lg:px-16">
```

## Image Optimization

### Responsive Images
- **srcset**: Multiple image sizes for different screens
- **sizes**: Hint to browser about display size
- **Next.js Image**: Automatic optimization and lazy loading

### Art Direction
Different crops for different screens:
```jsx
<picture>
  <source media="(min-width: 768px)" srcset="wide.jpg" />
  <img src="square.jpg" alt="..." />
</picture>
```

## Performance Considerations

### Critical CSS
- Inline critical styles for above-the-fold content
- Defer non-critical styles
- Reduce layout shift (CLS)

### Lazy Loading
- Images below the fold
- Components not immediately visible
- Intersection Observer for trigger

### Reduced Motion
Respect user preferences:
```css
@media (prefers-reduced-motion: reduce) {
  * {
    animation-duration: 0.01ms !important;
    transition-duration: 0.01ms !important;
  }
}
```

## Testing Checklist

- [ ] Test on real mobile devices (iOS and Android)
- [ ] Verify all breakpoints (320px, 375px, 768px, 1024px, 1920px)
- [ ] Check landscape and portrait orientations
- [ ] Test touch interactions (tap targets, swipe gestures)
- [ ] Validate text remains readable at all sizes
- [ ] Ensure images load appropriately per screen size
- [ ] Verify navigation works on mobile (hamburger menus)
- [ ] Test forms on mobile (input types, keyboard behavior)
- [ ] Check for horizontal scroll issues
- [ ] Validate container queries work as expected
- [ ] Test with browser zoom (200%, 400%)
- [ ] Verify reduced motion preferences respected
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall