Frontend Design
A guide to creating distinctive, production-grade frontend interfaces with exceptional aesthetic quality and attention to detail.
Preferences
- Prefer distinctive, characterful typography over generic fonts
- Commit to cohesive aesthetic direction (bold minimalism OR refined maximalism)
- Use CSS variables for theming and consistency
- Prioritize CSS-only solutions where possible
- Focus on high-impact moments with orchestrated animations
- Create atmosphere with backgrounds and visual details
Core
| Topic |
Description |
Reference |
| Design Systems |
Component libraries, design tokens, theming, design principles |
design-systems |
| Typography |
Font selection, scale, line-height, readability, vertical rhythm |
typography |
| Color Theory |
Color palettes, contrast, semantic colors, dark mode |
color-theory |
Features
| Topic |
Description |
Reference |
| Layout & Spacing |
Grid, flexbox, spacing scales, responsive breakpoints |
layout-spacing |
| Accessibility |
ARIA, keyboard navigation, screen readers, WCAG guidelines |
accessibility |
| Motion & Animation |
Transitions, animations, micro-interactions, performance |
motion-animation |
Design Thinking
Before coding, understand the context and commit to a bold aesthetic direction:
Purpose
- What problem does this interface solve?
- Who is the target audience?
Tone
Pick an extreme and commit fully:
- Brutally minimal
- Maximalist chaos
- Retro-futuristic
- Organic/natural
- Luxury/refined
- Playful/toy-like
- Editorial/magazine
- Brutalist/raw
- Art deco/geometric
- Soft/pastel
- Industrial/utilitarian
Constraints
- Technical requirements (framework, performance, accessibility)
Differentiation
- What makes this UNFORGETTABLE?
- What's the one thing someone will remember?
CRITICAL: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.
Frontend Aesthetics Guidelines
Typography
Choose fonts that are beautiful, unique, and interesting:
- Avoid generic fonts: Arial, Inter, Roboto, system fonts
- Opt for distinctive choices that elevate the frontend's aesthetics
- Pair a distinctive display font with a refined body font
Color & Theme
- Commit to a cohesive aesthetic
- Use CSS variables for consistency
- Dominant colors with sharp accents outperform timid, evenly-distributed palettes
Motion
- Use animations for effects and micro-interactions
- Prioritize CSS-only solutions for HTML
- Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions
- Use scroll-triggering and hover states that surprise
Spatial Composition
- Unexpected layouts
- Asymmetry
- Overlap
- Diagonal flow
- Grid-breaking elements
- Generous negative space OR controlled density
Backgrounds & Visual Details
Create atmosphere and depth rather than defaulting to solid colors:
- Gradient meshes
- Noise textures
- Geometric patterns
- Layered transparencies
- Dramatic shadows
- Decorative borders
- Custom cursors
- Grain overlays
What to Avoid
NEVER use generic AI-generated aesthetics:
- Overused font families (Inter, Roboto, Arial, system fonts)
- Clichéd color schemes (purple gradients on white)
- Predictable layouts and component patterns
- Cookie-cutter design lacking context-specific character
NEVER converge on common choices - each design should be unique.
Implementation Tips
Match implementation complexity to the aesthetic vision:
- Maximalist designs need elaborate code with extensive animations and effects
- Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details
- Elegance comes from executing the vision well
Quick Reference
Distinctive Font Pairing
/* ❌ Generic */
font-family: 'Inter', system-ui, sans-serif;
/* ✅ Distinctive */
font-family: 'Playfair Display', serif;
font-family: 'JetBrains Mono', monospace;
Cohesive Color System
:root {
/* Dominant with sharp accent */
--color-bg: #0a0a0a;
--color-surface: #1a1a1a;
--color-primary: #f97316; /* sharp orange accent */
--color-text: #fafafa;
}
High-Impact Animation
.hero-title {
animation: fadeInUp 600ms cubic-bezier(0.16, 1, 0.3, 1) forwards;
}
.hero-title:nth-child(1) { animation-delay: 0ms; }
.hero-title:nth-child(2) { animation-delay: 100ms; }
.hero-title:nth-child(3) { animation-delay: 200ms; }
Atmospheric Background
.hero {
background:
radial-gradient(ellipse at 20% 80%, rgba(120, 50, 255, 0.15) 0%, transparent 50%),
radial-gradient(ellipse at 80% 20%, rgba(255, 50, 150, 0.1) 0%, transparent 50%),
linear-gradient(180deg, #0a0a0a 0%, #1a1a2e 100%);
}
1---2name: frontend-design3description: Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when building web components, pages, artifacts, or applications (websites, landing pages, dashboards, React/Vue components, HTML/CSS layouts). Generates creative, polished code and UI design that avoids generic aesthetics. Complete terms in LICENSE.txt.4---56# Frontend Design78> A guide to creating distinctive, production-grade frontend interfaces with exceptional aesthetic quality and attention to detail.910## Preferences1112- Prefer distinctive, characterful typography over generic fonts13- Commit to cohesive aesthetic direction (bold minimalism OR refined maximalism)14- Use CSS variables for theming and consistency15- Prioritize CSS-only solutions where possible16- Focus on high-impact moments with orchestrated animations17- Create atmosphere with backgrounds and visual details1819## Core2021| Topic | Description | Reference |22|-------|-------------|-----------|23| Design Systems | Component libraries, design tokens, theming, design principles | [design-systems](references/design-systems.md) |24| Typography | Font selection, scale, line-height, readability, vertical rhythm | [typography](references/typography.md) |25| Color Theory | Color palettes, contrast, semantic colors, dark mode | [color-theory](references/color-theory.md) |2627## Features2829| Topic | Description | Reference |30|-------|-------------|-----------|31| Layout & Spacing | Grid, flexbox, spacing scales, responsive breakpoints | [layout-spacing](references/layout-spacing.md) |32| Accessibility | ARIA, keyboard navigation, screen readers, WCAG guidelines | [accessibility](references/accessibility.md) |33| Motion & Animation | Transitions, animations, micro-interactions, performance | [motion-animation](references/motion-animation.md) |3435## Design Thinking3637Before coding, understand the context and commit to a bold aesthetic direction:3839### Purpose40- What problem does this interface solve?41- Who is the target audience?4243### Tone44Pick an extreme and commit fully:45- Brutally minimal46- Maximalist chaos47- Retro-futuristic48- Organic/natural49- Luxury/refined50- Playful/toy-like51- Editorial/magazine52- Brutalist/raw53- Art deco/geometric54- Soft/pastel55- Industrial/utilitarian5657### Constraints58- Technical requirements (framework, performance, accessibility)5960### Differentiation61- What makes this UNFORGETTABLE?62- What's the one thing someone will remember?6364> **CRITICAL**: Choose a clear conceptual direction and execute it with precision. Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.6566## Frontend Aesthetics Guidelines6768### Typography6970Choose fonts that are beautiful, unique, and interesting:7172- Avoid generic fonts: Arial, Inter, Roboto, system fonts73- Opt for distinctive choices that elevate the frontend's aesthetics74- Pair a distinctive display font with a refined body font7576### Color & Theme7778- Commit to a cohesive aesthetic79- Use CSS variables for consistency80- Dominant colors with sharp accents outperform timid, evenly-distributed palettes8182### Motion8384- Use animations for effects and micro-interactions85- Prioritize CSS-only solutions for HTML86- Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions87- Use scroll-triggering and hover states that surprise8889### Spatial Composition9091- Unexpected layouts92- Asymmetry93- Overlap94- Diagonal flow95- Grid-breaking elements96- Generous negative space OR controlled density9798### Backgrounds & Visual Details99100Create atmosphere and depth rather than defaulting to solid colors:101- Gradient meshes102- Noise textures103- Geometric patterns104- Layered transparencies105- Dramatic shadows106- Decorative borders107- Custom cursors108- Grain overlays109110## What to Avoid111112**NEVER use generic AI-generated aesthetics:**113114- Overused font families (Inter, Roboto, Arial, system fonts)115- Clichéd color schemes (purple gradients on white)116- Predictable layouts and component patterns117- Cookie-cutter design lacking context-specific character118119**NEVER converge on common choices** - each design should be unique.120121## Implementation Tips122123Match implementation complexity to the aesthetic vision:124- Maximalist designs need elaborate code with extensive animations and effects125- Minimalist or refined designs need restraint, precision, and careful attention to spacing, typography, and subtle details126- Elegance comes from executing the vision well127128## Quick Reference129130### Distinctive Font Pairing131132```css133/* ❌ Generic */134font-family: 'Inter', system-ui, sans-serif;135136/* ✅ Distinctive */137font-family: 'Playfair Display', serif;138font-family: 'JetBrains Mono', monospace;139```140141### Cohesive Color System142143```css144:root {145 /* Dominant with sharp accent */146 --color-bg: #0a0a0a;147 --color-surface: #1a1a1a;148 --color-primary: #f97316; /* sharp orange accent */149 --color-text: #fafafa;150}151```152153### High-Impact Animation154155```css156.hero-title {157 animation: fadeInUp 600ms cubic-bezier(0.16, 1, 0.3, 1) forwards;158}159160.hero-title:nth-child(1) { animation-delay: 0ms; }161.hero-title:nth-child(2) { animation-delay: 100ms; }162.hero-title:nth-child(3) { animation-delay: 200ms; }163```164165### Atmospheric Background166167```css168.hero {169 background: 170 radial-gradient(ellipse at 20% 80%, rgba(120, 50, 255, 0.15) 0%, transparent 50%),171 radial-gradient(ellipse at 80% 20%, rgba(255, 50, 150, 0.1) 0%, transparent 50%),172 linear-gradient(180deg, #0a0a0a 0%, #1a1a2e 100%);173}174```