/design

Create exceptional, production-ready designs that captivate users and win awards. Research-driven design process studying Dribbble, Behance, and Awwwards winners to deliver immersive, high-fidelity experiences with meticulous attention to detail.

Syntax

/design:good [detailed design brief]

How It Works

The /design:good command follows a comprehensive design process:

1. Research & Inspiration

  • Studies award-winning designs on Dribbble, Behance, Awwwards
  • Analyzes current design trends and best practices
  • Reviews competitor designs in your industry
  • Identifies successful patterns and unique opportunities
  • Creates mood boards and visual direction

2. Strategic Planning

  • Invokes ui-ux-designer agent for deep analysis
  • Defines design system (colors, typography, spacing, components)
  • Plans information architecture and user flows
  • Identifies key micro-interactions and animations
  • Establishes accessibility and performance goals

3. Design System Creation

  • Develops comprehensive color palette with semantic tokens
  • Designs typography system with type scale and hierarchy
  • Creates spacing scale for consistent rhythm
  • Defines component library with variants and states
  • Establishes animation principles and timing

4. High-Fidelity Design

  • Creates pixel-perfect layouts with attention to detail
  • Implements custom illustrations or graphics
  • Designs sophisticated micro-interactions
  • Adds meaningful animations that enhance UX
  • Ensures brand consistency throughout

5. Responsive & Accessible

  • Designs for all breakpoints (mobile, tablet, desktop, ultra-wide)
  • Implements WCAG 2.1 AA accessibility standards
  • Tests color contrast ratios (4.5
    minimum)
  • Ensures keyboard navigation and screen reader support
  • Adds focus indicators and skip links

6. Motion Design

  • Creates purposeful animations (300-500ms for UI)
  • Implements smooth transitions and easing curves
  • Adds micro-interactions for delight
  • Designs loading states and skeleton screens
  • Respects prefers-reduced-motion

7. Production Ready

  • Generates clean, maintainable code
  • Includes comprehensive documentation
  • Provides design system documentation
  • Adds inline comments for complex logic
  • Ensures performance optimization

Examples

Premium SaaS Landing Page

/design:good [SaaS landing page for AI writing assistant - modern, professional, showcasing product capabilities with interactive demo section, social proof, and elegant micro-interactions]

Research Phase:

Inspiration Research:
β”œβ”€β”€ Analyzed: Linear, Notion, Stripe, Vercel landing pages
β”œβ”€β”€ Trend: Gradient mesh backgrounds, glass morphism
β”œβ”€β”€ Pattern: Hero with product preview, feature tabs, pricing comparison
└── Opportunity: Interactive writing demo with real-time AI suggestions

Mood Board Created:
β”œβ”€β”€ Colors: Deep purples, bright blues, warm accents
β”œβ”€β”€ Style: Modern, clean, sophisticated
β”œβ”€β”€ Typography: Display fonts for headlines, readable sans-serif for body
└── Imagery: Abstract gradients, subtle 3D elements

Design System:

Color Palette:
β”œβ”€β”€ Primary:
β”‚   β”œβ”€β”€ 50: #F5F3FF β†’ 900: #4C1D95 (9 shades)
β”‚   └── Main: #7C3AED (violet-600)
β”œβ”€β”€ Secondary:
β”‚   β”œβ”€β”€ 50: #EFF6FF β†’ 900: #1E3A8A (9 shades)
β”‚   └── Main: #3B82F6 (blue-500)
β”œβ”€β”€ Accent:
β”‚   β”œβ”€β”€ Warm: #F59E0B (amber-500)
β”‚   └── Cool: #06B6D4 (cyan-500)
└── Neutrals:
    β”œβ”€β”€ Gray scale: 50 β†’ 900
    └── Semantic: success, error, warning, info

Typography System:
β”œβ”€β”€ Display: "Cal Sans" (custom, headlines only)
β”œβ”€β”€ Body: "Inter Variable" (400, 500, 600, 700)
β”œβ”€β”€ Code: "JetBrains Mono" (code blocks)
└── Scale:
    β”œβ”€β”€ xs: 12px | sm: 14px | base: 16px
    β”œβ”€β”€ lg: 18px | xl: 20px | 2xl: 24px
    β”œβ”€β”€ 3xl: 30px | 4xl: 36px | 5xl: 48px
    └── 6xl: 60px | 7xl: 72px (display only)

Spacing Scale:
β”œβ”€β”€ Base unit: 4px
β”œβ”€β”€ Scale: 4, 8, 12, 16, 24, 32, 48, 64, 96, 128px
└── Container: 1280px max-width, 32px padding

Animation Principles:
β”œβ”€β”€ Duration: 200ms (micro) | 300ms (standard) | 500ms (complex)
β”œβ”€β”€ Easing: cubic-bezier(0.4, 0.0, 0.2, 1) for UI
β”œβ”€β”€ Purpose: Provide feedback, guide attention, create delight
└── Respect: prefers-reduced-motion

Implementation:

Generated Components:
βœ“ Hero Section
  β”œβ”€β”€ Gradient mesh background (animated)
  β”œβ”€β”€ Headline with gradient text effect
  β”œβ”€β”€ Animated CTA buttons (hover: scale + glow)
  β”œβ”€β”€ Product preview (browser mockup + live demo)
  └── Social proof ticker (auto-scrolling logos)

βœ“ Interactive Demo Section
  β”œβ”€β”€ Split view: input textarea | AI output
  β”œβ”€β”€ Real-time typing animation
  β”œβ”€β”€ Suggestion cards with hover effects
  β”œβ”€β”€ "Try it yourself" interactive mode
  └── Smooth transitions between demo states

βœ“ Feature Tabs
  β”œβ”€β”€ Tab navigation with animated indicator
  β”œβ”€β”€ Content fade-in with stagger effect
  β”œβ”€β”€ Feature illustrations (custom SVG)
  β”œβ”€β”€ Code examples with syntax highlighting
  └── Scroll-triggered animations

βœ“ Social Proof
  β”œβ”€β”€ Testimonial carousel (smooth auto-play)
  β”œβ”€β”€ Customer logos (grayscale β†’ color on hover)
  β”œβ”€β”€ Statistics counter (animated on scroll into view)
  └── Video testimonials (modal overlay)

βœ“ Pricing Section
  β”œβ”€β”€ Comparison table with feature highlights
  β”œβ”€β”€ Toggle (monthly/annual) with slider animation
  β”œβ”€β”€ Recommended plan highlight
  β”œβ”€β”€ Tooltip icons for feature explanations
  └── CTA buttons with loading states

βœ“ Footer
  β”œβ”€β”€ Multi-column layout with links
  β”œβ”€β”€ Newsletter signup with validation
  β”œβ”€β”€ Social icons with hover animations
  └── Legal links and copyright

Micro-Interactions:
βœ“ Button hovers: scale(1.02) + shadow increase
βœ“ Card hovers: lift effect + border glow
βœ“ Input focus: border color transition + scale
βœ“ Scroll progress indicator (top bar)
βœ“ Smooth scroll with offset for fixed header
βœ“ Toast notifications (slide + fade)
βœ“ Loading spinners (pulsing brand logo)

Animations:
βœ“ Hero gradient: slow animation (20s loop)
βœ“ Text reveal: fade up with stagger (100ms)
βœ“ Demo typing: realistic typing speed (60ms/char)
βœ“ Feature tabs: slide + fade (300ms)
βœ“ Scroll reveals: intersection observer (fade up)
βœ“ Pricing toggle: smooth width transition
βœ“ Logo ticker: seamless infinite scroll

Performance:
βœ“ Lazy loading for images and videos
βœ“ Preload critical assets
βœ“ Optimize gradient rendering (GPU)
βœ“ Debounce scroll animations
βœ“ Use will-change for animations
βœ“ Code splitting by section
βœ“ Total bundle: <150KB gzipped

Accessibility:
βœ“ Semantic HTML throughout
βœ“ ARIA labels for interactive elements
βœ“ Keyboard navigation (Tab, Enter, Esc)
βœ“ Focus visible indicators (2px blue outline)
βœ“ Color contrast: all text 4.5:1 minimum
βœ“ Skip to main content link
βœ“ Screen reader announcements
βœ“ Captions for video content
βœ“ Reduced motion support

Generated Files:
βœ“ src/pages/Landing.tsx (main page)
βœ“ src/components/Hero.tsx
βœ“ src/components/InteractiveDemo.tsx
βœ“ src/components/FeatureTabs.tsx
βœ“ src/components/SocialProof.tsx
βœ“ src/components/PricingTable.tsx
βœ“ src/components/Footer.tsx
βœ“ src/animations/gradientMesh.ts
βœ“ src/animations/scrollReveal.ts
βœ“ src/styles/design-system.css
βœ“ src/utils/intersectionObserver.ts
βœ“ docs/design-system.md

Time: 6-8 hours
Quality: Production-ready, award-worthy

E-commerce Product Page

/design:good [luxury watch product page with 3D viewer, detailed specifications, size comparison tool, and immersive shopping experience]

Implementation Highlights:

Premium Features:
βœ“ 3D Product Viewer (Three.js)
  β”œβ”€β”€ 360Β° rotation with momentum
  β”œβ”€β”€ Zoom to see details (2x, 4x)
  β”œβ”€β”€ Material switcher (metal, leather)
  β”œβ”€β”€ Lighting presets (studio, outdoor, dramatic)
  └── AR preview button

βœ“ Image Gallery
  β”œβ”€β”€ Main large image (zoom on hover)
  β”œβ”€β”€ Thumbnail carousel (smooth scroll)
  β”œβ”€β”€ Full-screen lightbox (swipe gestures)
  β”œβ”€β”€ Video integration
  └── Lazy loading with blur placeholders

βœ“ Product Details
  β”œβ”€β”€ Accordion specifications (smooth expand)
  β”œβ”€β”€ Size comparison tool (interactive overlay)
  β”œβ”€β”€ Material information with tooltips
  β”œβ”€β”€ Care instructions
  └── Warranty details

βœ“ Purchase Section
  β”œβ”€β”€ Size selector with stock availability
  β”œβ”€β”€ Quantity selector (+ / - with validation)
  β”œβ”€β”€ Add to cart (with animation feedback)
  β”œβ”€β”€ Add to wishlist (heart animation)
  β”œβ”€β”€ Price display (sale price highlight)
  └── Shipping calculator

βœ“ Social Features
  β”œβ”€β”€ Share buttons (copy link, social)
  β”œβ”€β”€ Review section (5-star with filters)
  β”œβ”€β”€ Q&A section
  └── Recently viewed products

Design Excellence:
βœ“ Luxury aesthetic (generous whitespace, serif accents)
βœ“ Premium photography (high resolution, consistent lighting)
βœ“ Smooth animations (buttery 60 FPS)
βœ“ Attention to detail (every state designed)
βœ“ Mobile-optimized (thumb-friendly zones)

Time: 10-14 hours

Creative Portfolio

/design:good [creative portfolio for photographer with full-screen image galleries, custom cursor, smooth page transitions, and unique navigation]

Creative Implementation:

Unique Features:
βœ“ Custom Cursor
  β”œβ”€β”€ Default: small dot + large ring
  β”œβ”€β”€ Hover links: expands with "View" text
  β”œβ”€β”€ Hover images: becomes magnifier icon
  β”œβ”€β”€ Smooth follow (slight delay for effect)
  └── Hide on touch devices

βœ“ Page Transitions
  β”œβ”€β”€ Smooth fade + scale effect (500ms)
  β”œβ”€β”€ Loading animation (brand logo)
  β”œβ”€β”€ Route-based transitions
  └── Preload next page content

βœ“ Hero Section
  β”œβ”€β”€ Full-screen background video
  β”œβ”€β”€ Parallax text overlay
  β”œβ”€β”€ Scroll indicator (animated)
  └── Signature/logo placement

βœ“ Project Gallery
  β”œβ”€β”€ Masonry grid layout (responsive)
  β”œβ”€β”€ Hover: project title + category reveal
  β”œβ”€β”€ Click: expand to full-screen detail
  β”œβ”€β”€ Smooth transitions between views
  └── Keyboard navigation (arrow keys)

βœ“ Project Detail Page
  β”œβ”€β”€ Full-screen image viewer
  β”œβ”€β”€ Swipe/arrow navigation
  β”œβ”€β”€ Project information sidebar (slide in/out)
  β”œβ”€β”€ Next project preview (bottom)
  └── Back button with transition

βœ“ About Page
  β”œβ”€β”€ Split layout: large portrait | bio
  β”œβ”€β”€ Animated stats counter
  β”œβ”€β”€ Services list with icons
  β”œβ”€β”€ Client logos
  └── Contact CTA

βœ“ Contact Page
  β”œβ”€β”€ Full-screen split design
  β”œβ”€β”€ Animated contact form
  β”œβ”€β”€ Alternative contact methods
  β”œβ”€β”€ Social links
  └── Availability calendar widget

Artistic Details:
βœ“ Typography: Mix of serif + sans-serif
βœ“ Whitespace: Generous, breathing room
βœ“ Animations: Subtle, refined, never distracting
βœ“ Photography: Hero treatment, full bleed
βœ“ Color: Monochrome with accent color

Performance:
βœ“ Image optimization (WebP, lazy load)
βœ“ Progressive image loading (blur up)
βœ“ Route preloading
βœ“ Efficient animations (GPU accelerated)
βœ“ Fast page transitions

Time: 12-16 hours

When to Use /design

βœ… Use /design
for:

  • Customer-Facing Products: Landing pages, marketing sites
  • Brand-Critical Pages: Homepage, product pages, about pages
  • Portfolio/Showcase: Personal brand, creative work
  • Premium Products: Luxury brands, high-end services
  • Competitive Markets: Stand out with exceptional design
  • Award Submissions: Awwwards, CSS Design Awards, FWA
  • Long-Term Projects: Worth the investment in quality
  • Learning Excellence: Study and apply best practices

❌ Don’t use /design
for:

  • Quick Prototypes: Use /design:fast instead
  • Internal Tools: Quality vs. speed tradeoff
  • Time Constraints: Requires 6-16 hours minimum
  • Low-Traffic Pages: ROI consideration
  • Temporary Pages: Not worth the effort

Design Excellence Standards

Visual Hierarchy

Clear hierarchy in every design:
β”œβ”€β”€ Primary action: most prominent
β”œβ”€β”€ Secondary actions: visible but secondary
β”œβ”€β”€ Tertiary: minimal, supportive
└── Content: F-pattern or Z-pattern reading flow

Micro-Interactions

Every interaction designed:

  • Button hover: scale + shadow
  • Input focus: border + scale
  • Form submit: loading state + success animation
  • Error: shake animation + icon
  • Success: checkmark animation + confetti (subtle)

Loading States

Never leave users waiting without feedback:

  • Skeleton screens (not spinners)
  • Progressive image loading
  • Optimistic UI updates
  • Loading percentage indicators
  • Smooth content reveals

Empty States

Beautiful empty states:

  • Illustration or icon
  • Helpful message
  • Primary action (CTA)
  • Examples or suggestions

Error States

Friendly error handling:

  • Clear error messages
  • Suggestions to fix
  • Visual indicators
  • Retry actions
  • Support contact info

Research Sources

Inspiration Platforms

Dribbble (dribbble.com)

  • Latest design trends
  • UI/UX patterns
  • Micro-interactions
  • Color schemes

Behance (behance.net)

  • Full project case studies
  • Design process insights
  • Brand guidelines
  • Complete design systems

Awwwards (awwwards.com)

  • Award-winning websites
  • Cutting-edge interactions
  • Technical excellence
  • Innovation in web design

Mobbin (mobbin.com)

  • Mobile app patterns
  • User flows
  • Screen designs
  • iOS/Android patterns

Land-book (land-book.com)

  • Landing page inspiration
  • Contemporary web design
  • Clean, modern aesthetics

Design Systems to Study

Industry Leaders:

  • Material Design (Google)
  • Human Interface Guidelines (Apple)
  • Fluent Design (Microsoft)
  • Polaris (Shopify)
  • Carbon (IBM)
  • Ant Design (Alibaba)

Startups with Great Design:

  • Linear (linear.app)
  • Stripe (stripe.com)
  • Vercel (vercel.com)
  • Notion (notion.so)
  • Figma (figma.com)

Quality Checklist

Before delivery, verify:

Visual Design

  • Pixel-perfect alignment
  • Consistent spacing (design system)
  • Color harmony and contrast
  • Typography hierarchy clear
  • High-quality assets
  • Brand consistency

Interaction Design

  • All states designed (hover, active, disabled, loading, error)
  • Smooth transitions (60 FPS)
  • Purposeful animations
  • Clear feedback on actions
  • Intuitive navigation
  • Micro-interactions polished

Responsive Design

  • Mobile (320px - 767px)
  • Tablet (768px - 1023px)
  • Desktop (1024px - 1919px)
  • Ultra-wide (1920px+)
  • Touch-friendly targets
  • Readable text sizes

Accessibility

  • WCAG 2.1 AA compliant
  • Color contrast 4.5
    minimum
  • Keyboard navigable
  • Screen reader friendly
  • Focus indicators visible
  • Semantic HTML
  • ARIA labels where needed
  • Skip links present

Performance

  • Optimized images
  • Lazy loading
  • Code splitting
  • Fast load time (<3s)
  • Smooth animations
  • Efficient rendering

Code Quality

  • Clean, readable code
  • Type safety (TypeScript)
  • Commented where needed
  • Reusable components
  • Design system documented
  • No console errors

Best Practices

Provide Detailed Briefs

βœ… Excellent:

/design:good [E-learning platform homepage targeting college students. Modern, friendly aesthetic with purple/blue gradient brand colors. Include: hero with video demo, course categories grid with hover effects, student testimonials carousel, pricing comparison table, and FAQ accordion. Emphasize trust and accessibility. Inspired by: Coursera, Udemy, but more youthful and dynamic.]

βœ… Good:

/design:good [Portfolio site for UI designer showcasing 6 projects. Minimal, elegant design with black/white/accent color. Smooth page transitions, custom cursor, full-screen project images.]

❌ Too vague:

/design:good [make a nice website]

Include References

/design:good [Dashboard similar to Linear.app but for project management. Include: task kanban board, timeline view, team activity feed. Use their modern aesthetic with shadows and subtle animations.]

Specify Brand Guidelines

/design:good [Corporate website following brand guidelines:
- Colors: Navy #1E3A8A (primary), Orange #F97316 (accent)
- Font: "Proxima Nova" for all text
- Style: Professional, trustworthy, innovative
- Sections: Hero, services, case studies, team, contact]

After Delivery

Documentation Provided

docs/
β”œβ”€β”€ design-system.md        # Complete design system documentation
β”œβ”€β”€ components.md           # Component library reference
β”œβ”€β”€ animations.md           # Animation specifications
└── accessibility.md        # Accessibility compliance notes

Design Tokens

/* Generated design system CSS */
:root {
  /* Colors */
  --color-primary-50: #F5F3FF;
  --color-primary-500: #7C3AED;
  --color-primary-900: #4C1D95;

  /* Typography */
  --font-display: "Cal Sans", sans-serif;
  --font-body: "Inter Variable", sans-serif;
  --text-xs: 0.75rem;
  --text-base: 1rem;
  --text-4xl: 2.25rem;

  /* Spacing */
  --space-1: 0.25rem;
  --space-4: 1rem;
  --space-8: 2rem;

  /* Shadows */
  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
  --shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1);

  /* Animation */
  --duration-fast: 200ms;
  --duration-base: 300ms;
  --ease-in-out: cubic-bezier(0.4, 0.0, 0.2, 1);
}

Troubleshooting

Takes Too Long

Problem: Design process taking longer than expected

Solution:

  • Consider /design:fast for non-critical pages
  • Focus quality on high-impact pages only
  • Iterate: start fast, upgrade to good later

Need Revisions

Problem: Design doesn’t match vision

Solution:

# Be specific about changes
/design:good [revise hero section - make headline more prominent, reduce CTA button size, use purple gradient instead of blue]

# Provide reference
/design:good [update pricing section to match this style: [reference-image.png]]

Performance Issues

Problem: Animations causing lag

Solution:

/fix:ui [optimize animations - reduce complexity while maintaining smooth feel]

Next Steps


Key Takeaway: /design:good creates exceptional, award-worthy designs by researching best-in-class examples and applying meticulous attention to every detail. Worth the time investment for customer-facing, brand-critical pages. Excellence matters.