Frontend Design Masterclass v2.1
Construa interfaces que ressoam, não apenas renderizam. Esta skill impõe design ousado e intencional com uma stack moderna de alto desempenho. Cada pixel deve justificar sua existência.
1. Stack Principal
- Framework: SvelteKit 5 com Runes (
$state,$derived,$effect) - Runtime: Bun (servidor, pacotes)
- Backend/API: Hono (rotas edge-first, middlewares)
- Primitivas de UI: shadcn-svelte (headless, totalmente customizável). Sobrescreva TODOS os padrões.
- Gráficos: LayerChart (construído sobre Layer Cake, alimenta os gráficos do shadcn-svelte)
- Animação: Svelte Motion (
@humanspeak/svelte-motion) para orquestração complexa. Transiçõessvelte/transitionesvelte/animatenativas para movimentos padrão. Keyframes CSS para loops simples. - Mermaid:
beautiful-mermaidpara renderização SVG temática com compatibilidade com Shiki - Estilização: Tailwind CSS v4, estendido com propriedades customizadas CSS
- Testes: Playwright para regressão visual
- Assets: Nano Banana para imagens e texturas generativas
- Deploy:
@sveltejs/adapter-staticpara estático,@sveltejs/adapter-vercelpara SSR
2. Identificação de Intenção (Pré-Recurso)
Antes de carregar referências, classifique a solicitação em três dimensões. Isso molda cada decisão de design subsequente.
A. Tipo de Produto
Identifique o que está sendo construído. Cada tipo de produto implica normas de estilo, cor e layout.
| Categoria de Produto | Estilos Recomendados | Direção de Cor |
|---|---|---|
| SaaS / B2B / Produtividade | Grade Suíça, Flat + Glassmorfismo | Azul de confiança + contraste de acento |
| E-commerce / Varejo | Bloco Vibrante, Vitrine Rica em Recursos | Primário da marca + verde de sucesso |
| E-commerce Luxo | Vidro Líquido, Cinematográfico | Neutros escuros + acentos dourado/champanhe |
| Fintech / Cripto | Densidade de Dados, Modo Escuro OLED | Azul marinho/carvão escuro + acento neon |
| Saúde / Bem-Estar | Fluxo Orgânico, UI Suave | Verde-água suave/sálvia + neutro quente |
| Criativo / Portfólio | Neo-Brutalista, Tipografia Cinética | Alto contraste + um acento ousado |
| Games / Entretenimento | Cyberpunk, HUD/Ficção Científica | Escuro profundo + neon multi-acento |
| Educação / Documentação | Folha Editorial, Minimalista | Papel quente + hierarquia de tinta |
| Plataforma de IA / ML | Aurora UI, Orientado a Movimento | Primário gradiente + superfície escura |
| Dashboard / Analíticos | Grade Bento, Densidade de Dados | Superfície neutra + cores de dados semânticas |
Use esta tabela como uma bússola inicial, não como uma restrição. Sempre personalize.
B. Intenção de Estilo
Determine o alvo estético a partir de pistas de contexto, solicitação explícita ou tipo de produto. Consulte references/landing-pages.md Seção 3 para 8 estilos atemporais com especificações completas.
C. Público e Contexto
Considere quem usa isso e onde. Públicos empresariais toleram densidade; públicos consumidores precisam de espaço para respirar. Mobile-first muda tudo sobre alvos de toque, escala tipográfica e intensidade de animação.
3. Protocolo de Carregamento de Recursos
Após identificar a intenção, escaneie a solicitação em busca de palavras-chave de gatilho. Carregue arquivos de referência correspondentes de references/ para acessar padrões de implementação profundos.
Landing Pages e Seções Hero
Gatilhos: "landing page", "hero", "acima da dobra", "homepage", "título do site", "manchete", "CTA", "chamada para ação", "conversão", "primeira impressão"
Carregar: references/landing-pages.md
Fornece: Anatomia da seção hero, 8 estilos atemporais de landing page (Apple Keynote, Folha Editorial, Playground Geométrico, Imersivo Cinematográfico, Grade Suíça, Neo-Brutalista, Fluxo Orgânico, Terminal Retrô), padrões de fluxo visual (Z/F/Diagonal/Dourado), arquitetura de conversão, estratégia hero mobile-first, padrões de código.
Tipografia e Seleção de Fontes
Gatilhos: "fonte", "tipografia", "tipo de letra", "título", "estilo de texto", "par de fontes", "escala tipográfica", "espaçamento entre letras", "altura da linha", "legível", "fonte de exibição"
Carregar: references/typography.md
Fornece: Catálogos de fontes de exibição/corpo/mono com recomendações de pares, construção de escala tipográfica (proporções matemáticas), tipografia responsiva com clamp(), fontes variáveis, carregamento e desempenho de fontes, detalhes tipográficos (rastreamento, pontuação suspensa, alinhamento óptico), checklist de legibilidade.
Sistema de Cores e Temas
Gatilhos: "cor", "paleta", "tema", "modo escuro", "modo claro", "acento", "esquema de cores", "cores da marca", "contraste", "matiz", "saturação"
Carregar: references/color-system.md
Fornece: Arquitetura de paleta estruturada de 3 grupos (Tons Base, Tons Primários, Tons de Acento), modelos de harmonia da teoria das cores, fluxo de trabalho de geração de paleta, construção de tema claro, construção de tema escuro (regras independentes), seletor de tema com temas bônus (variantes quente/frio/mono/alto contraste), tokens de cores semânticas, sistema de propriedades customizadas CSS, conformidade de contraste WCAG.
Imagens, Texturas e Fundos
Gatilhos: "imagem", "fundo", "textura", "foto", "ilustração", "pontilhismo", "overlay", "fundo parallax", "imagem hero", "Nano Banana", "duotone", "padrão"
Carregar: references/imagery.md
Fornece: Taxonomia de função de imagem, estratégia de dimensionamento e formato, composição de fundo de três camadas, algoritmos de pontilhismo (Atkinson/Floyd-Steinberg/Bayer), delimitação geométrica e overlay (linhas diagonais, formas clip-path, marcas de canto, overlays de grade), movimento em imagens, seleção de estilo artístico (fotorealista/ilustrado/generativo/mídia mista/duotone), imagens de botões e banners, integração com Nano Banana, guia de prompt de IA para imagens.
Gráficos de Dados, Tabelas, Cartas e Infográficos
Gatilhos: "tabela", "gráfico", "infográfico", "dados", "estatísticas", "métricas", "KPI de dashboard", "comparação", "linha do tempo", "fluxo de processo", "exibição de números"
Carregar: references/data-graphics.md
Fornece: Design de tabelas além do padrão (tabelas sem grade, indicadores de status, células sparkline, cabeçalhos fixos, técnicas de ênfase), estética de gráficos e storytelling (preenchimentos gradientes, efeitos de brilho, anotações, substituições de grade), integração de diagramas Mermaid, padrões de infográficos (blocos de números, linhas do tempo, grades de comparação, fluxos de processo), prompting de IA para visuais de dados, gráficos prontos para impressão.
Microanimações e Controles Interativos
Gatilhos: "animação", "hover", "clique", "botão", "toggle", "feedback", "ondulação", "carregamento", "esqueleto", "transição", "snap", "magnético", "animação de scroll", "microinteração", "controle responsivo", "transição de estado", "animação de formulário"
Carregar: references/microanimations.md
Fornece: Sistema completo de botão de 5 estados (padrão/hover/ativo/foco/desabilitado), feedback de navegação (itens de menu, hambúrguer, indicador de aba), animações orientadas por scroll (revelação escalonada, barra de progresso, animação de contador), interações de formulário (labels flutuantes, feedback de validação, checkboxes customizadas), estados de carregamento (esqueletos, sucesso/erro), transições de página, padrões de sensação tátil (pressão, salto, elevação de cartão, ondulação), comportamentos snap e magnéticos, regras de desempenho, tabela de referência de easing e temporização.
Movimento Visual e Profundidade
Gatilhos: "3d", "profundidade", "parallax", "inclinação", "falso 3d", "espacial", "cinético", "movimento", "glassmorfismo", "holográfico"
Carregar: references/visual-kinetics.md
Fornece: Sistema de camadas de animação (CSS -> Svelte -> Svelte Motion -> GSAP), cartão de inclinação holográfico com brilho, hero parallax com camadas Nano Banana, glassmorfismo 2.0, tipografia cinética (máscara de revelação, marquee, texto dividido), revelações acionadas por scroll, easing baseado em física, botão magnético, checklist de desempenho.
Visualização de Dados (Gráficos e Dashboards)
Gatilhos: "layerchart", "componente de gráfico", "layout de dashboard", "grade bento", "sparkline", "tempo real", "gráfico neon", "gráfico editorial"
Carregar: references/data-visualization.md
Fornece: Padrões componíveis do LayerChart, integração de gráficos shadcn-svelte, modos estéticos de gráficos (Neon/Editorial/Mínimo), receitas de estilização de tabelas, layouts de dashboard grade bento, sparklines, padrões de dados em tempo real, bibliotecas alternativas.
Diagramas (Mermaid)
Gatilhos: "mermaid", "diagrama", "fluxograma", "diagrama de sequência", "diagrama de arquitetura"
Carregar: references/mermaid-theming.md
Fornece: Configuração e tematização do beautiful-mermaid, integração Shiki, mapeamento nativo de themeVariables do Mermaid, pós-processamento SVG (overlay de textura, sombras, bordas), padrão de componente SvelteKit, notas de estilização por tipo de diagrama, considerações de impressão.
Quando vários gatilhos são detectados, carregue todas as referências relevantes. Quando nenhum gatilho é detectado, aplique os Mandatos Universais abaixo diretamente.
4. O Mandato Anti-Slop
LLMs convergem para padrões de design "seguros" de alta probabilidade dos dados de treinamento. Isso é convergência distribucional. Lute contra isso deliberadamente.
REJEITE: Padrões Bootstrap/Tailwind enviados como estão, fontes Inter/Roboto/Arial/sistema, esquemas de cores roxo-em-branco, grades de cartões previsíveis, seções hero padronizadas, layouts centralizados, fotografia de stock, gradientes genéricos, ícones emoji na UI, espaçamento com números mágicos, estados hover invisíveis, transformações de escala que causam mudança de layout no hover, cartões de vidro em modo claro com opacidade <30%, texto suave com contraste abaixo de gray-500.
ABRACE: Hierarquias tipográficas intencionais, composições assimétricas, profundidade atmosférica, feedback cinético, grades editoriais, guias visuais geométricos, precisão pronta para impressão, paletas de cores customizadas construídas a partir da teoria das cores, pares de fontes distintos, sistemas de ícones SVG (Lucide, Heroicons) com viewBox consistente, cursor-pointer em cada elemento clicável, estados hover estáveis usando cor/opacidade (não transformações que desorganizam o layout).
5. Design Thinking (Pré-Código)
Antes de escrever código, comprometa-se com uma direção:
- Propósito: O que isso resolve? Quem usa?
- Tipo de Produto: Classifique usando a tabela na Seção 2A para direção inicial.
- Tom Estético: Escolha UM e comprometa-se totalmente. Consulte
references/landing-pages.mdSeção 3 para 8 estilos comprovados. Ou invente um híbrido. - Direção de Cor: Selecione o matiz primário, derive o acento via harmonia da teoria das cores. Consulte
references/color-system.mdSeção 3 para o fluxo de trabalho completo. - Tipografia: Escolha um trio de exibição + corpo + mono dos catálogos em
references/typography.md. - O Detalhe Memorável: Identifique UM elemento que o usuário lembrará.
- Correspondência de Complexidade: Maximalista = código elaborado. Minimalista = precisão cirúrgica.
6. Mandatos Estéticos Universais
Tipografia
Selecione pares distintos e cheios de caráter. Carregue do Google Fonts ou Fontsource. Consulte references/typography.md para catálogos completos de fontes e estratégias de pareamento. NUNCA use Inter, Roboto, Open Sans, Lato ou fontes padrão do sistema a menos que sejam fortemente modificadas. NUNCA convirja para Space Grotesk entre gerações.
Cor (A Paleta Estruturada)
Construa uma paleta de 3 grupos: Tons Base, Tons Primários, Tons de Acento. Consulte references/color-system.md para o sistema completo. Temas claros: sombras fortes, tipografia pesada, linhas finas. Temas escuros: brilhos coloridos, texto off-white (#E8E8E8), gradientes de superfície sutis. NUNCA use roxo puro (H: 270-280) como primário. Mude para índigo, teal, coral ou esmeralda.
Imagens e Textura
Nunca use fundos de cor sólida e plana para seções hero. Consulte references/imagery.md para a técnica de composição de três camadas, algoritmos de pontilhismo e padrões de integração com Nano Banana.
Microanimações (Obrigatório)
Cada elemento interativo deve fornecer feedback de movimento. Consulte references/microanimations.md para o sistema completo de botão de 5 estados, animações orientadas por scroll e padrões de sensação tátil.
Composição Espacial
Andaimes verticais, assimetria, espaço negativo, elementos que quebram a grade. Consulte references/landing-pages.md Seção 4 para padrões de fluxo visual.
Acessibilidade (Não Negociável)
- HTML semântico:
<article>,<section>,<nav>,<aside>,<main> - Estados de foco: NUNCA
outline: none. Estilize comooutline: 2px solid var(--accent); outline-offset: 4px - Contraste mínimo WCAG AA. Consulte
references/color-system.mdSeção 9. - Labels ARIA em todos os componentes interativos customizados
prefers-reduced-motion: desabilite parallax, inclinação, animações complexas- A cor nunca deve ser o único indicador de estado
- Todas as imagens precisam de texto alternativo; entradas de formulário precisam de labels
Impressão e PDF
Os sites devem funcionar como relatórios imprimíveis quando @media print estiver ativo. Oculte nav/footer/botões, force fundo branco, preserve gráficos SVG, use break-inside: avoid em cartões/gráficos/tabelas.
7. Fluxo de Trabalho de Implementação
- Identifique: Classifique o tipo de produto, intenção de estilo, público (Seção 2).
- Carregue: Escaneie por gatilhos de recurso. Carregue arquivos de referência relevantes (Seção 3).
- Pesquise: Para construções complexas, realize pesquisa profunda (até 10 pesquisas na web) em sites premiados comparáveis, padrões e capacidades de bibliotecas.
- Arquitetar: Planeje a estrutura de arquivos do SvelteKit. Defina tokens de variáveis CSS.
- Codifique: Escreva HTML semântico, Tailwind estendido, Svelte 5 Runes. Pronto para produção, sem placeholders.
- Polir: Aplique microanimações, camadas de textura, estados hover, gatilhos de scroll.
- Valide: Execute o Checklist Pré-Entrega (Seção 8). Corrija todas as falhas.
- Itere: Compare com a visão estética. Ajuste até brilhar.
8. Checklist Pré-Entrega
Execute isso antes de entregar qualquer código de UI. Cada item é um modo de falha conhecido.
Qualidade Visual
- Nenhum emoji usado como ícone de UI (use SVGs Lucide ou Heroicons)
- Todos os ícones de um conjunto consistente com viewBox correspondente (24x24)
- Logos da marca verificados contra fontes oficiais (Simple Icons)
- Estados hover NÃO causam mudança de layout (use opacidade/cor, não transformações de escala)
- Nenhuma classe de cor padrão do Tailwind sem customização
- O pareamento tipográfico é intencional e carregado (não fallback do sistema)
Interação
- Cada elemento clicável tem
cursor-pointer - Cada elemento interativo tem feedback hover visível
- Transições usam duração 150-300ms (nunca >500ms para UI, nunca 0ms)
- Estados de foco são visíveis e estilizados (não padrões do navegador, nunca removidos)
- Alvos de toque são no mínimo 44x44px no mobile
Modo Claro/Escuro
- Modo claro: contraste de texto passa WCAG AA (ratio de contraste >=4,5:1 para texto normal; >=3:1 para texto grande)
- Modo escuro: a cor de texto não é branco puro (#FFFFFF); use off-white (#E8E8E8-#F0F0F0)
- Os temas claro e escuro estão completos, com estilos de superfície, texto e borda definidos
- O seletor de tema funciona (se implementado)
Responsividade
- Layout mobile-first com breakpoints intencionais
- A tipografia usa
clamp()para escala responsiva - Imagens/fundos responsivos (trocam ou reposicionam em pontos de quebra)
- Sem scroll horizontal não intencional
Código
- Sem números mágicos em CSS; use tokens de variáveis (espaçamento, raio, etc.)
- Sem imports não utilizados, variáveis ou componentes
- Sem URLs codificadas; use variáveis de ambiente
- Sem estilos de filho aninhados em Tailwind sem
&ou variantes - Sem classes de cor de superfície não modificadas do Tailwind (slate/gray/zinc/neutral/stone padrão)
Desempenho
- Animações ficam abaixo de 50ms de composição sem layout/paint (use
transformeopacity) - Imagens têm dimensões definidas (sem CLS - Cumulative Layout Shift)
- Fontes são pré-carregadas com font-display: swap
- Nenhuma animação JavaScript é executada em 60+ elementos simultaneamente (use aceleração CSS ou considere Canvas)
Nervos do Reviewer
- O design parece intencional e polido, não como saída de LLM pedida
- O detalhe memorável está presente e funciona
- A emoção central é alcançada (a vibração escolhida na Seção 5)
- Você mostraria isso para seus colegas designers
9. Design Cross-Platform
Sites que precisam se parecer com aplicativos nativos ou plataformas. Esta seção substitui a Seção 6 para esses casos.
Diretrizes de Plataforma
Específica de cada SO. Aplique a fonte, tratamento de cores e padrões de UI da plataforma:
- Apple (iOS/macOS) : SF Pro, SF Mono (ou alternativas gratuitas: Inter + JetBrains Mono), cores do sistema Apple (azul, verde, etc., correspondem em matiz), vibração de material vítreo
- Google (Android/Material You) : Google Sans (Product Sans), Roboto Flex, cores dinâmicas da paleta do sistema, superfícies com elevação (Material 3)
- Microsoft (Windows 11) : Segoe UI Variable, efeito Mica (desfoque acrílico sutil), cores do sistema
- Alternativas gratuitas: Inter/SF Pro, JetBrains Mono/SF Mono, Outfit, Onest (alternativa próxima à Google Sans)
Padrão de Theme
<!-- +layout.svelte -->
<script lang="ts">
let { children } = $props();
let platform = $state('web'); // 'web' | 'ios' | 'android' | 'windows'
// Detectar ou definir plataforma via prop/contexto
</script>
<div class="platform-{platform}">
<slot />
</div>
<style>
.platform-ios { font-family: 'Inter', system-ui; }
.platform-android { font-family: 'Outfit', system-ui; }
.platform-windows { font-family: 'Segoe UI Variable', system-ui; }
:global(body) { background: var(--surface); }
</style>
Design de Neumorfismo
Usado com moderação, principalmente para controles de UI ou superfícies de cartão sutis.
.neumorphic-light {
background: #e8e8e8;
border-radius: 12px;
box-shadow: 6px 6px 12px #c5c5c5, -6px -6px 12px #ffffff;
}
.neumorphic-dark {
background: #2a2a2a;
border-radius: 12px;
box-shadow: 6px 6px 12px #1a1a1a, -6px -6px 12px #3a3a3a;
}
Estados de Hover Específicos de Plataforma
- Pointer (desktop): Hover padrão com cor/opacidade
- Touch (mobile): Nenhum estado hover persistente presente (use :active ou estados de foco)
- Caneta (Surface, iPad): Visualização de hover com feedback de pressão (SVG dinâmico ou gradiente)
10. Tokens de Tema (Exemplo)
:root {
/* Base */
--base-hue: 220;
--base-bg: hsl(var(--base-hue), 10%, 98%);
--base-text: hsl(var(--base-hue), 15%, 12%);
/* Primário */
--primary: hsl(200, 80%, 45%);
--primary-hover: hsl(200, 80%, 38%);
/* Acento */
--accent: hsl(30, 100%, 55%);
/* Superfície */
--surface: hsl(var(--base-hue), 8%, 100%);
--surface-elevated: hsl(var(--base-hue), 10%, 96%);
/* Borda */
--border: hsl(var(--base-hue), 12%, 88%);
/* Sombra */
--shadow-sm: 0 1px 3px hsla(var(--base-hue), 20%, 10%, 0.08);
/* Raio */
--radius-sm: 4px;
--radius-md: 8px;
/* Espaçamento */
--space-xs: 4px;
--space-sm: 8px;
--space-md: 16px;
}
Este é um ponto de partida. Sempre estenda para corresponder ao seu sistema de design específico.
11. Guia Inicial Rápido (SvelteKit 5 + shadcn-svelte)
# Criar projeto SvelteKit
bun create svelte@latest my-app
cd my-app
bun install
# Adicionar Tailwind CSS v4
bun add @tailwindcss/vite tailwindcss
# Configurar vite.config.ts:
# import { tailwindcss } from '@tailwindcss/vite';
# plugins: [tailwindcss()]
# Adicionar shadcn-svelte
bun add -D shadcn-svelte
bun x shadcn-svelte@next init
# Adicionar componentes
bun x shadcn-svelte@next add button card badge
# Adicionar animações
bun add @humanspeak/svelte-motion
Este é um modelo vivo. Estenda, modifique, quebre as regras quando fizer sentido. A boa intenção supera a conformidade rígida.