Frontend Design
frontend-design
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.
SKILL.md
Full skill instructions
This skill guides creation of distinctive, production-grade frontend interfaces that avoid generic "AI slop" aesthetics. Implement real working code with exceptional attention to aesthetic details and creative choices.
The user provides frontend requirements: a component, page, application, or interface to build. They may include context about the purpose, audience, or technical constraints.
Design Thinking
Before coding, understand the context and commit to a BOLD aesthetic direction:
- Purpose: What problem does this interface solve? Who uses it?
- Tone: Pick an extreme: brutally minimal, maximalist chaos, retro-futuristic, organic/natural, luxury/refined, playful/toy-like, editorial/magazine, brutalist/raw, art deco/geometric, soft/pastel, industrial/utilitarian, etc. There are so many flavors to choose from. Use these for inspiration but design one that is true to the aesthetic direction.
- 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.
Then implement working code (HTML/CSS/JS, React, Vue, etc.) that is:
- Production-grade and functional
- Visually striking and memorable
- Cohesive with a clear aesthetic point-of-view
- Meticulously refined in every detail
Frontend Aesthetics Guidelines
Focus on:
-
Typography: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics; unexpected, characterful font choices. 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. NEVER repeat the same color palette across projects - vary between vibrant/citrus, earthy/natural, metallic, neon, pastel, high-contrast monochromatic, etc. Avoid overused colors like #FF6B6B, #06D6A0, and generic purple/blue gradients.
-
Contrast & Accessibility (CRITICAL): NEVER use white text on light backgrounds or dark text on dark backgrounds. Maintain WCAG AA minimum contrast ratio (4.5:1 for normal text, 3:1 for large text). If using a dark background, use white/light text. If using a light background, use dark text. TEST YOUR COLORS - this is a common failure point.
-
Motion: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Use Motion library for React when available. 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. Never default to standard 12-column grids without purpose.
-
Backgrounds & Visual Details: Create atmosphere and depth rather than defaulting to solid colors. Add contextual effects and textures that match the overall aesthetic. Apply creative forms like gradient meshes, noise textures, geometric patterns, layered transparencies, dramatic shadows, decorative borders, custom cursors, and grain overlays.
-
Navigation & Headers: MUST have a background. Use glassmorphism (
backdrop-blur-md+ semi-transparent bg) or a solid color. Avoid fully transparent headers that blend into the page content. -
Icons & Visual Elements: NEVER create placeholder elements like empty squares or circles. If you need an icon, either use a proper icon library (lucide-react, heroicons, etc.) or create a meaningful SVG. Empty boxes with shadows are unacceptable.
IMPORTANT: 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.
Aesthetic Styles Reference
When choosing a direction, consider these distinct aesthetics (but don't limit yourself to these):
- Cyberpunk/Neon: Vibrant neon colors, glitch effects, visible grids, dystopian futurism
- Brutalist: Aggressive geometric shapes, high contrast, massive typography, thick borders
- Organic/Natural: Fluid forms, earthy colors, natural textures, rounded edges, organic layouts
- Japanese Minimalism: Generous negative space, monochromatic palette, precise grid, subtlety
- Pop Art/Maximalist: Screaming colors, bold patterns, overlap, controlled chaos
- Retro-Futurism (Y2K): Chrome, metallic gradients, space fonts, 2000s aesthetic
- Glassmorphism: Transparencies, blur, glass effects, depth, colored shadows
- Neo-Brutalism (Soft): Pastel colors, simple geometric shapes, hard but soft shadows
- Dark Luxury: Deep black, gold/bronze, elegant serif typography, minimalism
- Editorial/Magazine: Magazine layouts, broken grid, varied typography, large images
- Playful/Toy-like: Rounded corners, happy colors, fun shapes, cute animations
- Industrial: Technical appearance, monospaced fonts, visible structure, utilitarian
Remember: Claude is capable of extraordinary creative work. Don't hold back, show what can truly be created when thinking outside the box and committing fully to a distinctive vision.
CRITICAL: HIERARCHY & CONTRAST RULES (READ FIRST!)
AVISO: Quando gerar landing pages ou layouts de UI, NÃO priorize estéticas "minimal" ou "luxury" em detrimento da hierarquia visual e contraste.
Regras Obrigatórias de Design:
1. Hierarquia Visual Clara é OBRIGATÓRIA
- O headline principal deve VISUALMENTE DOMINAR a seção hero (tamanho, peso, contraste)
- Texto secundário deve APOIAR o headline, não competir nem desaparecer
- Use tamanhos de fonte DRAMATICAMENTE diferentes (ex: headline 6xl+, body base/lg)
- Se o headline não é imediatamente o elemento mais visível, está errado
2. Limiares Mínimos de Contraste DEVEM Ser Respeitados
- PROIBIDO: texto cinza claro ou baixa opacidade em fundos brancos para conteúdo principal
- Luxury ≠ baixo contraste. Luxury requer CLAREZA primeiro
- Contraste mínimo: 4.5:1 para texto normal, 3:1 para texto grande
- Teste: se você precisa fazer força para ler, está errado
3. Whitespace Deve Ser Ancorado
- Áreas vazias grandes devem ser visualmente justificadas por elementos dominantes (headline, imagens, formas ou backgrounds sutis)
- NUNCA deixe seções grandes em branco sem um ponto focal
- Espaço negativo deve ter propósito, não ser "vazio por acaso"
4. CTA Deve Ser Visualmente Apoiado
- Botões CTA devem estar visualmente conectados a elementos contextuais fortes
- EVITE CTAs isolados flutuando em layouts de baixo contraste
- O CTA deve ser o segundo ou terceiro elemento mais chamativo após o headline
- Use cores complementares, sombras, ou posicionamento estratégico
5. Presença da Marca Deve Estabilizar o Layout
- Header e elementos da marca devem ter presença visual suficiente
- NUNCA faça headers transparentes que desaparecem no background
- Logotipo/nome deve estar sempre visível e com contraste adequado
Exemplo do QUE NÃO FAZER:
// ❌ ERRADO - Luxury minimalismo sem hierarquia
<section className="bg-white text-gray-400 p-20">
<h1 className="text-2xl font-light text-gray-500">Nossos Serviços</h1>
<p className="text-sm text-gray-300 mt-4">Descrição sutil...</p>
<button className="border border-gray-300 text-gray-400 px-4 py-2">
Saiba Mais
</button>
</section>
Exemplo do QUE FAZER:
// ✅ CORRETO - Hierarquia forte com contraste
<section className="bg-neutral-900 text-white p-20">
<h1 className="text-7xl font-black text-white tracking-tight">
NOSSOS SERVIÇOS
</h1>
<p className="text-xl text-neutral-300 mt-6 max-w-2xl">
Descrição clara que apoia o headline...
</p>
<button className="mt-8 bg-white text-black px-8 py-4 font-bold text-lg hover:bg-neutral-200">
Saiba Mais →
</button>
</section>
Regra de Ouro: Em caso de dúvida, vá para MAIOR contraste e MAIOR hierarquia, não menos.
