O que UX Pro Max - Inteligência de Design faz?
Guia de design abrangente para aplicações web e mobile. Contém 50+ estilos, 97 paletas de cores, 57 pares de fontes, 99 diretrizes de UX e 25 tipos de gráficos em 9 stacks de tecnologia. Banco de dados pesquisável com recomendações baseadas em prioridade.
Quando Aplicar
Consulte estas diretrizes quando:
- Projetar novos componentes ou páginas de UI
- Escolher paletas de cores e tipografia
- Revisar código quanto a problemas de UX
- Construir landing pages ou dashboards
- Implementar requisitos de acessibilidade
Categorias de Regras por Prioridade
| Prioridade | Categoria | Impacto | Domínio |
|---|---|---|---|
| 1 | Acessibilidade | CRÍTICO | ux |
| 2 | Toque e Interação | CRÍTICO | ux |
| 3 | Desempenho | ALTO | ux |
| 4 | Layout e Responsivo | ALTO | ux |
| 5 | Tipografia e Cor | MÉDIO | typography, color |
| 6 | Animação | MÉDIO | ux |
| 7 | Seleção de Estilo | MÉDIO | style, product |
| 8 | Gráficos e Dados | BAIXO | chart |
Referência Rápida
1. Acessibilidade (CRÍTICO)
color-contrast- Razão mínima de 4,5:1 para texto normalfocus-states- Anéis de foco visíveis em elementos interativosalt-text- Texto alternativo descritivo para imagens significativasaria-labels- aria-label para botões com apenas íconekeyboard-nav- Ordem de tabulação corresponde à ordem visualform-labels- Use label com atributo for
2. Toque e Interação (CRÍTICO)
touch-target-size- Alvos de toque de no mínimo 44x44pxhover-vs-tap- Use clique/toque para interações primáriasloading-buttons- Desabilite o botão durante operações assíncronaserror-feedback- Mensagens de erro claras perto do problemacursor-pointer- Adicione cursor-pointer a elementos clicáveis
3. Desempenho (ALTO)
image-optimization- Use WebP, srcset, carregamento preguiçosoreduced-motion- Verifique prefers-reduced-motioncontent-jumping- Reserve espaço para conteúdo assíncrono
4. Layout e Responsivo (ALTO)
viewport-meta- width=device-width initial-scale=1readable-font-size- Tamanho de fonte mínimo de 16px para texto do corpo no mobilehorizontal-scroll- Garanta que o conteúdo caiba na largura da viewportz-index-management- Defina escala de z-index (10, 20, 30, 50)
5. Tipografia e Cor (MÉDIO)
line-height- Use 1,5-1,75 para texto do corpoline-length- Limite a 65-75 caracteres por linhafont-pairing- Combine personalidades de fonte de título/corpo
6. Animação (MÉDIO)
duration-timing- Use 150-300ms para microinteraçõestransform-performance- Use transform/opacity, não width/heightloading-states- Telas esqueleto ou spinners
7. Seleção de Estilo (MÉDIO)
style-match- Corresponda o estilo ao tipo de produtoconsistency- Use o mesmo estilo em todas as páginasno-emoji-icons- Use ícones SVG, não emojis
8. Gráficos e Dados (BAIXO)
chart-type- Corresponda o tipo de gráfico ao tipo de dadocolor-guidance- Use paletas de cores acessíveisdata-table- Forneça alternativa de tabela para acessibilidade
Como Usar
Pesquise domínios específicos usando a ferramenta CLI abaixo.
Pré-requisitos
Verifique se o Python está instalado:
python3 --version || python --version
Se o Python não estiver instalado, instale-o com base no SO do usuário:
macOS:
brew install python3
Ubuntu/Debian:
sudo apt update && sudo apt install python3
Windows:
winget install Python.Python.3.12
Como Usar Esta Habilidade
Quando o usuário solicitar trabalho de UI/UX (design, construir, criar, implementar, revisar, corrigir, melhorar), siga este fluxo de trabalho:
Passo 1: Analisar Requisitos do Usuário
Extraia informações-chave da solicitação do usuário:
- Tipo de produto: SaaS, e-commerce, portfólio, dashboard, landing page, etc.
- Palavras-chave de estilo: minimalista, divertido, profissional, elegante, modo escuro, etc.
- Indústria: saúde, fintech, jogos, educação, etc.
- Stack: React, Vue, Next.js, ou padrão para
html-tailwind
Passo 2: Gerar Sistema de Design (OBRIGATÓRIO)
Sempre comece com --design-system para obter recomendações abrangentes com raciocínio:
python3 skills/ui-ux-pro-max/scripts/search.py "<tipo_produto> <indústria> <palavras-chave>" --design-system [-p "Nome do Projeto"]
Este comando:
- Pesquisa 5 domínios em paralelo (product, style, color, landing, typography)
- Aplica regras de raciocínio de
ui-reasoning.csvpara selecionar as melhores correspondências - Retorna sistema de design completo: padrão, estilo, cores, tipografia, efeitos
- Inclui antipadrões a evitar
Exemplo:
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
Passo 2b: Persistir Sistema de Design (Padrão Mestre + Substituições)
Para salvar o sistema de design para recuperação hierárquica entre sessões, adicione --persist:
python3 skills/ui-ux-pro-max/scripts/search.py "<consulta>" --design-system --persist -p "Nome do Projeto"
Isso cria:
design-system/MASTER.md— Fonte Única da Verdade com todas as regras de designdesign-system/pages/— Pasta para substituições específicas de página
Com substituição específica de página:
python3 skills/ui-ux-pro-max/scripts/search.py "<consulta>" --design-system --persist -p "Nome do Projeto" --page "dashboard"
Isso também cria:
design-system/pages/dashboard.md— Desvios específicos da página em relação ao Mestre
Como funciona a recuperação hierárquica:
- Ao construir uma página específica (ex.: "Checkout"), primeiro verifique
design-system/pages/checkout.md - Se o arquivo da página existir, suas regras substituem o arquivo Mestre
- Caso contrário, use
design-system/MASTER.mdexclusivamente
Prompt de recuperação sensível ao contexto:
Estou construindo a página [Nome da Página]. Por favor, leia design-system/MASTER.md.
Verifique também se design-system/pages/[nome-da-pagina].md existe.
Se o arquivo da página existir, priorize suas regras.
Caso contrário, use as regras Mestre exclusivamente.
Agora, gere o código...
Passo 3: Complementar com Pesquisas Detalhadas (conforme necessário)
Após obter o sistema de design, use pesquisas de domínio para obter detalhes adicionais:
python3 skills/ui-ux-pro-max/scripts/search.py "<palavra-chave>" --domain <domínio> [-n <max_resultados>]
Quando usar pesquisas detalhadas:
| Necessidade | Domínio | Exemplo |
|---|---|---|
| Mais opções de estilo | style | --domain style "glassmorphism dark" |
| Recomendações de gráfico | chart | --domain chart "real-time dashboard" |
| Melhores práticas de UX | ux | --domain ux "animation accessibility" |
| Fontes alternativas | typography | --domain typography "elegant luxury" |
| Estrutura de landing | landing | --domain landing "hero social-proof" |
Passo 4: Diretrizes de Stack (Padrão: html-tailwind)
Obtenha melhores práticas específicas de implementação. Se o usuário não especificar um stack, padrão para html-tailwind.
python3 skills/ui-ux-pro-max/scripts/search.py "<palavra-chave>" --stack html-tailwind
Stacks disponíveis: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose
Referência de Pesquisa
Domínios Disponíveis
| Domínio | Use para | Exemplos de Palavras-chave |
|---|---|---|
product | Recomendações de tipo de produto | SaaS, e-commerce, portfólio, saúde, beleza, serviço |
style | Estilos de UI, cores, efeitos | glassmorfismo, minimalismo, modo escuro, brutalismo |
typography | Pares de fontes, Google Fonts | elegante, divertido, profissional, moderno |
color | Paletas de cores por tipo de produto | saas, ecommerce, saúde, beleza, fintech, serviço |
landing | Estrutura de página, estratégias de CTA | hero, hero-centric, depoimento, preços, prova-social |
chart | Tipos de gráfico, recomendações de biblioteca | tendência, comparação, linha do tempo, funil, pizza |
ux | Melhores práticas, antipadrões | animação, acessibilidade, z-index, carregamento |
react | Desempenho React/Next.js | waterfall, bundle, suspense, memo, rerender, cache |
web | Diretrizes de interface web | aria, focus, keyboard, semantic, virtualize |
prompt | Prompts de IA, palavras-chave CSS | (nome do estilo) |
Stacks Disponíveis
| Stack | Foco |
|---|---|
html-tailwind | Utilitários Tailwind, responsivo, a11y (PADRÃO) |
react | Estado, hooks, desempenho, padrões |
nextjs | SSR, roteamento, imagens, rotas de API |
vue | Composition API, Pinia, Vue Router |
svelte | Runes, stores, SvelteKit |
swiftui | Views, Estado, Navegação, Animação |
react-native | Componentes, Navegação, Listas |
flutter | Widgets, Estado, Layout, Temas |
shadcn | Componentes shadcn/ui, temas, formulários, padrões |
jetpack-compose | Composables, Modificadores, Elevação de Estado, Recombinação |
Fluxo de Trabalho de Exemplo
Solicitação do usuário: "Criar landing page para serviço de cuidados com a pele profissional"
Passo 1: Analisar Requisitos
- Tipo de produto: Serviço de Beleza/Spa
- Palavras-chave de estilo: elegante, profissional, suave
- Indústria: Beleza/Bem-estar
- Stack: html-tailwind (padrão)
Passo 2: Gerar Sistema de Design (OBRIGATÓRIO)
python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"
Saída: Sistema de design completo com padrão, estilo, cores, tipografia, efeitos e antipadrões.
Passo 3: Complementar com Pesquisas Detalhadas (conforme necessário)
# Obter diretrizes de UX para animação e acessibilidade
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux
# Obter opções de tipografia alternativa, se necessário
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography
Passo 4: Diretrizes de Stack
python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind
Então: Sintetize o sistema de design + pesquisas detalhadas e implemente o design.
Formatos de Saída
O sinalizador --design-system suporta dois formatos de saída:
# Caixa ASCII (padrão) - melhor para exibição em terminal
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system
# Markdown - melhor para documentação
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown
Dicas para Melhores Resultados
- Seja específico com palavras-chave - "dashboard SaaS saúde" > "app"
- Pesquise várias vezes - Palavras-chave diferentes revelam insights diferentes
- Combine domínios - Estilo + Tipografia + Cor = Sistema de design completo
- Sempre verifique UX - Pesquise "animação", "z-index", "acessibilidade" para problemas comuns
- Use o sinalizador de stack - Obtenha melhores práticas específicas de implementação
- Itere - Se a primeira pesquisa não corresponder, tente palavras-chave diferentes
Regras Comuns para UI Profissional
Estes são problemas frequentemente negligenciados que fazem a UI parecer pouco profissional:
Ícones e Elementos Visuais
| Regra | Faça | Não Faça |
|---|---|---|
| Sem ícones de emoji | Use ícones SVG (Heroicons, Lucide, Simple Icons) | Use emojis como 🎨 🚀 ⚙️ como ícones de UI |
| Estados de hover estáveis | Use transições de cor/opacidade no hover | Use transformações de escala que deslocam o layout |
| Logotipos de marca corretos | Pesquise SVG oficial do Simple Icons | Adivinhe ou use caminhos de logotipo incorretos |
| Tamanho de ícone consistente | Use viewBox fixo (24x24) com w-6 h-6 | Misture tamanhos de ícone diferentes aleatoriamente |
Interação e Cursor
| Regra | Faça | Não Faça |
|---|---|---|
| Cursor pointer | Adicione cursor-pointer a todos os cards clicáveis/hoveráveis | Deixe o cursor padrão em elementos interativos |
| Feedback de hover | Forneça feedback visual (cor, sombra, borda) | Nenhuma indicação de que o elemento é interativo |
| Transições suaves | Use transition-colors duration-200 | Mudanças instantâneas de estado ou muito lentas (>500ms) |
Contraste Modo Claro/Escuro
| Regra | Faça | Não Faça |
|---|---|---|
| Card glass modo claro | Use bg-white/80 ou opacidade maior | Use bg-white/10 (muito transparente) |
| Contraste de texto claro | Use #0F172A (slate-900) para texto | Use #94A3B8 (slate-400) para texto do corpo |
| Texto suave claro | Use #475569 (slate-600) no mínimo | Use gray-400 ou mais claro |
| Visibilidade da borda | Use border-gray-200 no modo claro | Use border-white/10 (invisível) |
Layout e Espaçamento
| Regra | Faça | Não Faça |
|---|---|---|
| Navbar flutuante | Adicione espaçamento top-4 left-4 right-4 | Cole a navbar a top-0 left-0 right-0 |
| Preenchimento de conteúdo | Considere a altura fixa da navbar | Deixe o conteúdo se esconder atrás de elementos fixos |
| Largura máxima consistente | Use o mesmo max-w-6xl ou max-w-7xl | Misture larguras de contêiner diferentes |
Lista de Verificação Pré-Entrega
Antes de entregar o código de UI, verifique estes itens:
Qualidade Visual
- Nenhum emoji usado como ícone (use SVG)
- Todos os ícones de um conjunto consistente (Heroicons/Lucide)
- Logotipos de marca estão corretos (verificados do Simple Icons)
- Estados de hover não causam deslocamento de layout
- Use cores do tema diretamente (bg-primary), não wrapper var()
Interação
- Todos os elementos clicáveis têm
cursor-pointer - Estados de hover fornecem feedback visual claro
- Transições são suaves (150-300ms)
- Estados de foco visíveis para navegação por teclado
Modo Claro/Escuro
- Texto no modo claro tem contraste suficiente (4,5:1 no mínimo)
- Elementos de vidro/transparentes visíveis no modo claro
- Bordas visíveis em ambos os modos
- Teste ambos os modos antes da entrega
Layout
- Elementos flutuantes têm espaçamento adequado das bordas
- Nenhum conteúdo oculto atrás de navbars fixas
- Responsivo em 375px, 768px, 1024px, 1440px
- Nenhuma rolagem horizontal no mobile
Acessibilidade
- Todas as imagens têm texto alternativo
- Campos de formulário têm rótulos
- Cor não é o único indicador
-
prefers-reduced-motionrespeitado