Communitygithub.com

Ringophilia/estilo-combina-com-a-função

Antes de projetar ou estilizar qualquer UI (web, desktop, Electron, mobile, relatórios HTML, dashboards, componentes), determine o contexto de uso e defina o estilo visual: para negócios, produtividade, ferramentas internas, backends de dados e ferramentas de desenvolvedor, use um estilo contido, claro e com alta densidade de informação; para entretenimento, jogos, criatividade, redes sociais e interesses pessoais, ousadia com cores, ilustrações, animações e fontes especiais é bem-vinda. Evite estilos de IA por inércia: vidro fosco (glassmorphism), neumorfismo, gradientes roxo-azul, brilho neon, manchas de luz gradiente no fundo, cards com bordas muito arredondadas e ícones emoji, que fazem ferramentas sérias parecerem jogos; evite também transformar coisas divertidas em painéis cinzentos e sem graça. Quando o projeto já tiver um sistema de design, siga-o; quando o cenário não for claro, apresente duas ou três direções específicas e pergunte ao usuário.

O que é estilo-combina-com-a-função?

Este guia prático ajuda desenvolvedores e designers a escolher o estilo visual adequado para cada tipo de interface de usuário, evitando tanto o estilo genérico de IA (glassmorphism, neumorfismo, gradientes roxo-azul, brilho neon) quanto a monotonia de painéis corporativos sem graça. O processo é dividido em etapas claras: primeiro, verificar se o projeto já possui um sistema de design, tema ou componentes; depois, analisar o contexto de uso (quem vai usar, por quanto tempo, qual o custo do erro); em seguida, escolher entre uma abordagem contida (para ferramentas de produtividade, business, dados) ou criativa e ousada (para entretenimento, jogos, redes sociais). O guia também ensina como perguntar ao usuário quando o contexto não é claro, oferecendo direções concretas, e inclui uma checklist de autoavaliação para garantir que cada elemento decorativo tenha um propósito. Suporta qualquer plataforma de desenvolvimento de UI (web, desktop, mobile, etc.) e é especialmente útil para desenvolvedores que usam assistentes de IA para gerar interfaces, pois os orienta a evitar os padrões estéticos automáticos que frequentemente surgem.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ringophilia/agent-rules-of-thumb/tree/HEAD/skills/style-fits-the-job

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Estilo Combina com a Função

Problema

A IA que escreve UIs tem um senso estético inercial, aplicando sempre o mesmo estilo, não importa o que esteja sendo criado:

  • Cards de vidro fosco (backdrop-filter: blur() + branco semitransparente)
  • Neumorfismo (sombras de relevo e reentrância)
  • Gradientes roxo para azul, botões gradientes, texto gradiente, bordas gradientes
  • Manchas de luz coloridas desfocadas em fundos escuros
  • box-shadow neon brilhante, com ampliação, flutuação e rotação ao passar o mouse
  • Cada bloco é um card com borda arredondada de 24px, com um emoji antes do título
  • Textos do tipo "✨ Impulsionado por IA", "🚀 Comece agora"

Resultado: uma ferramenta de aprovação de reembolsos para finanças, ou um visualizador de logs para operações, parecem um inicializador de jogos ou uma página de aterrissagem de criptomoedas. O usuário usa por oito horas por dia, a aparência é chamativa, é difícil encontrar as coisas, e também parece pouco profissional e pouco confiável.

O estilo não é uma questão de "ser bonito ou feio", é uma questão de "ser adequado ou não".

Primeiro Passo: Veja o que o Projeto Já Tem

Prioridade do mais alto para o mais baixo:

  1. Sistema de design / biblioteca de componentes / arquivo de tema existente no projeto (tailwind.config, theme.ts, variáveis CSS, link do Figma, guia de marca): siga-o, não crie algo novo.
  2. Páginas já existentes no projeto: a nova página deve parecer da mesma família.
  3. Diretrizes da plataforma: aplicativos nativos Windows seguem Fluent / WinUI, macOS seguem HIG, Android seguem Material. Os materiais das diretrizes da plataforma (como Mica / Acrylic do Windows 11) são legítimos, usados nos locais determinados pela plataforma (fundo da janela, menus flutuantes), não para adicionar desfoque a cada card.
  4. Se nada disso existir, só então você decide com base no cenário.

Segundo Passo: Analise o Cenário

Observe estes sinais:

SinalTende a ContidoTende a Animado
Quem usaFuncionários, profissionais, clientes de clientesJogadores comuns, amigos, crianças, fãs
Como usaUso prolongado diário, repetindo a mesma tarefaAcesso ocasional, para se divertir um pouco
ConteúdoTabelas, números, formulários, logs, códigoImagens, personagens, histórias, conquistas, interação
Custo do erroAlto: dinheiro, dados, contratos, ambiente de produçãoBaixo: basta recomeçar
Sensação desejada pelo usuárioConfiável, eficiente, profissional, não intrusivoDivertido, surpreendente, personalizado, que dá vontade de compartilhar

Terceiro Passo: Escolha a Direção com Base no Cenário

Negócios / Produtividade / Ferramentas Internas / Backend de Dados / Ferramentas de Desenvolvedor

  • Cores: Predominância de cores neutras (branco, cinza claro, cinza escuro), uma cor de destaque usada na ação principal e em estados críticos; cores de estado (sucesso/alerta/erro) têm significado fixo, não são usadas para decoração.
  • Fontes: Fonte do sistema ou uma fonte sem serifa madura; números usam largura fixa ou font-variant-numeric: tabular-nums para alinhamento de colunas.
  • Densidade: Densidade de informação média a alta, linhas de tabela compactas, espaços em branco servem para agrupar, não para parecer "sofisticado".
  • Decoração: Quase nenhuma. Cantos levemente arredondados (4~8px), bordas finas ou sombras muito sutis, sem gradientes, brilhos, vidro fosco ou manchas de luz no fundo.
  • Animações: Usadas apenas para feedback (carregamento, expansão, mudança de estado), 150~200ms, sem animações de entrada, ampliação ao passar o mouse ou parallax.
  • Ícones: Um conjunto de ícones lineares de estilo consistente (Lucide, Fluent Icons, Material Symbols), sem emoji.
  • Texto: Direto e específico: "Salvar", "Exportar CSV", "3 registros aguardando aprovação".

Entretenimento / Jogos / Criatividade / Redes Sociais / Crianças / Interesses Pessoais

  • Cores: Pode ser vibrante, ousado, colorido, com pontos de destaque memoráveis; pode ter esquema de cores temático, gradientes, fundo com ilustrações.
  • Fontes: Os títulos podem usar fontes de exibição com personalidade, mas o corpo do texto ainda deve ser legível.
  • Decoração: Ilustrações, adesivos, texturas, personagens, elementos desenhados à mão podem ser usados, mas devem estar alinhados ao tema, não apenas aplicando efeitos genéricos "legais". Um jogo pixel art deve ser pixel art, um tema de conto de fadas deve ter uma sensação de conto de fadas, não um neon roxo genérico.
  • Animações: Podem ser mais ricas: elasticidade, partículas, animações de celebração, efeitos sonoros, para dar uma sensação de recompensa à interação.
  • Texto: Pode ter tom, personalidade e humor.

Zona Intermediária

Ferramentas voltadas para o consumidor comum (controle de gastos, lista de tarefas, calendário, registro de exercícios), portfólios, páginas de aterrissagem de produtos: tom contido, usabilidade em primeiro lugar, com toques de personalidade em alguns lugares (estados vazios, momentos de conclusão, cor da marca, ilustrações).

Animado não é igual a estilo de IA inercial. Vidro fosco, gradientes roxo-azul, brilho neon, mesmo em um contexto de entretenimento, são apenas "estilo IA genérico", não o estilo do produto. Um bom visual animado é temático.

Quando Estiver em Dúvida: Pergunte ao Usuário

Quando o cenário não é claro, ou a necessidade do usuário pode ser abordada de várias maneiras, pergunte primeiro, depois escreva. A pergunta deve ser específica, oferecendo direções que possam ser escolhidas diretamente, em vez de "Que estilo você gosta?":

✓ "Para o estilo desta ferramenta, você prefere qual?
   A. Profissional e limpo: fundo claro, cores neutras, tabelas compactas, como Linear / Notion
   B. Amigável e leve: mais arredondado, cores suaves, algumas ilustrações, como a página de configurações do Duolingo
   C. Personalizado: cores e animações ousadas, adequado para exibição ou entretenimento
   Se não souber, vou começar com a opção A."

Se o ambiente permitir renderização, você também pode fazer duas ou três amostras (apenas diferentes cores e fontes para a mesma interface) para o usuário escolher.

Não pergunte quando não for necessário: quando o usuário já declarou o propósito ("é para o financeiro da empresa"), o projeto já tem um estilo, ou a necessidade é óbvia ("fazer um joguinho de Tetris"), vá direto e, no final, mencione a direção escolhida para que o usuário possa corrigir.

Quarto Passo: Autoavaliação

Pegue cada elemento decorativo da interface e pergunte: se eu remover isso, o que o usuário perderá? Se a resposta for "nada", e for uma interface do tipo ferramenta, remova-o.

Verifique item por item:

  • Pesquise no código por backdrop-filter, linear-gradient, box-shadow com brilho colorido, animation, emoji: cada um deles é intencional?
  • A cor de destaque aparece apenas na ação principal e em estados críticos? Ou está em todo lugar?
  • Dê uma olhada em uma captura de tela (veja background-friendly): a primeira coisa que se vê é o conteúdo e a ação principal, ou a decoração?
  • Coloque-se no lugar do usuário: usando-o por oito horas por dia / por dez minutos, esse estilo é adequado?

Limites

  • Se o usuário pedir explicitamente um estilo específico ("quero cyberpunk mesmo", "faz bem chamativo"), siga o que ele pede, mesmo que seja uma ferramenta.
  • Se o usuário fornecer imagens de referência, sites de referência ou guia de marca, baseie-se neles.
  • Páginas de demonstração, marketing ou exibição podem ser mais expressivas que ferramentas do dia a dia, mas ainda devem estar alinhadas com a marca e o público.

Checklist

  • O projeto tem um sistema de design, tema ou páginas existentes? Eu os segui?
  • Qual é o cenário? Quem usa, por quanto tempo, e qual é o custo do erro?
  • Quando o cenário não era claro, eu perguntei ao usuário com direções específicas?
  • Interface do tipo ferramenta: sem vidro fosco, gradiente roxo-azul, brilho neon, fundo com manchas de luz, ícones emoji ou animações sem sentido?
  • Interface de entretenimento: tem personalidade alinhada ao tema, em vez de tabela cinza ou estilo IA genérico e chamativo?
  • A cor de destaque é usada apenas onde deve?
  • Cada elemento decorativo tem um propósito claro?

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas