Communitygithub.com

Sistema de Iconografia

Projete e implemente uma estrutura sistemática de iconografia que garanta consistência visual, clareza semântica e acessibilidade técnica em todo o site.

O que é Sistema de Iconografia?

Este skill estabelece uma metodologia completa para criação e implementação de um sistema de iconografia, indo além da simples escolha de ícones 'bonitos'. Ele define regras claras para estilo visual (traço, preenchimento, cantos), escalas de tamanho e espaçamento, mapeamento semântico de ícones a ações, e diretrizes de acessibilidade para usuários de leitores de tela. O sistema é útil para desenvolvedores e designers que desejam garantir consistência e usabilidade em projetos web, suportando plataformas que utilizam SVG, sprites ou fontes de ícones. O fluxo de trabalho inclui desde a definição da metáfora visual até a entrega técnica com SVG e ARIA, além de fornecer critérios de validação para evitar padrões de falha comuns, como ícones sem rótulo ou pesos inconsistentes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/iconography-system

Perguntar na sua IA favorita

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

Documentação

O que Sistema de Iconografia faz?

Propósito

O skill de Sistema de Iconografia fornece uma metodologia para selecionar, dimensionar e implementar ícones como elementos funcionais de UI. Ele vai além de "escolher imagens bonitas" para um sistema estruturado que garante que os ícones sejam usados de forma consistente para reduzir a carga cognitiva, reforçar a identidade da marca e permanecer totalmente acessíveis a todos os usuários. Um sistema de iconografia robusto garante que os ícones sirvam como sinalizações claras, em vez de poluição visual.

Casos de Uso

  • Definir o estilo do ícone (contorno, preenchido, duotone) para um novo site.
  • Estabelecer escalas padrão de tamanho e espaçamento para ícones em diferentes contextos (botões, navegação, grids de funcionalidades).
  • Auditar um site para "inchaço de ícones" ou metáforas visuais inconsistentes.
  • Implementar um fluxo de trabalho acessível com SVG ou fontes de ícones para desenvolvedores.
  • Selecionar ícones que se alinhem com atributos específicos da marca (ex.: ícones arredondados "amigáveis" vs. ícones pontiagudos "técnicos").

Quando NÃO Usar

  • Ilustrações e Gráficos de Destaque: Imagens narrativas grandes e complexas que contam uma história em vez de um único conceito funcional. Use habilidades de layout geral ou otimização de herói.
  • Logotipos e Branding: A identidade primária da marca geralmente tem suas próprias regras inegociáveis; os ícones apoiam a UI, eles não substituem o logotipo da marca.
  • Padrões Decorativos de Fundo: Quando os ícones são usados como papel de parede sem significado semântico.

Entradas

  1. Voz e Estilo da Marca: A marca é minimalista, técnica, lúdica ou corporativa?
  2. Ambiente Técnico: O site é construído com um framework que prefere componentes SVG, sprites ou fontes de ícones?
  3. Contextos de Uso: Onde os ícones aparecerão? (ex.: Navegação principal, botões CTA, listas de funcionalidades, status do painel).
  4. Design Tokens Existentes: Sistemas de espaçamento fluido e cores para garantir alinhamento.

Saídas

  1. Guia de Estilo de Ícones: Regras definidas para espessura do traço, raio do canto e tipos de preenchimento.
  2. Escala de Tamanho de Ícones: Um conjunto de tokens (ex.: icon-sm, icon-md, icon-lg) mapeados para valores específicos em pixels ou rem.
  3. Biblioteca Semântica: Um conjunto curado de ícones mapeados para ações ou conceitos específicos (ex.: "Chevron-para-baixo" para Dropdowns).
  4. Especificação de Acessibilidade: Regras para rótulos ARIA, role="img" e atributos aria-hidden.

Fluxo de Trabalho

1. Estabelecer a Metáfora Visual

Escolha ícones que usem símbolos universalmente compreendidos.

  • Pesquisa: Lupa.
  • Configurações: Engrenagem ou Sliders.
  • Usuário: Silhueta ou Círculo-usuário. Evite metáforas "inteligentes" que exijam que os usuários adivinhem o significado do ícone.

2. Definir o Estilo Visual

Garanta que todos os ícones no sistema compartilhem o mesmo DNA:

  • Espessura do Traço: Use espessura de linha consistente (ex.: 2px para todos os ícones de 24px).
  • Tratamento dos Cantos: Cantos arredondados parecem mais acessíveis; cantos afiados parecem mais técnicos/precisos.
  • Nível de Detalhe: Simplifique os ícones à medida que ficam menores para manter a legibilidade.

3. Construir uma Escala de Tamanho e Espaçamento

Aplique o sistema-de-espaçamento-fluido aos contêineres de ícones:

  • Pequeno (16px): Em linha com texto, breadcrumbs.
  • Médio (24px): Botões padrão, navegação principal.
  • Grande (48px+): Cartões de funcionalidades, destaques de herói.
  • Centralização Óptica: Ajuste manualmente ícones que parecem descentralizados devido à sua forma (ex.: um triângulo "Play").

4. Implementar Cor e Lógica de Estado

Vincule ícones ao sistema-de-estado-interativo:

  • Ativo/Hover: Os ícones devem mudar de cor ou peso junto com seu elemento pai.
  • Cor Semântica: Use Vermelho para ícones de excluir/erro, Verde para sucesso.
  • Contraste: Os ícones devem atender ao WCAG AA (3:1 para objetos gráficos).

5. Entrega Técnica e Acessibilidade

  • SVG vs. Fonte de Ícones: Prefira SVGs para melhor desempenho, acessibilidade e qualidade de renderização.
  • Funções Aria:
    • Se decorativo: Use aria-hidden="true".
    • Se funcional (ex.: um botão apenas com ícone): Use role="img" e um aria-label claro.

Regras de Decisão

  • A Regra do "Rótulo Primeiro": Os ícones quase sempre devem ser acompanhados de rótulos de texto. Use ícones "sozinhos" apenas para ações universalmente reconhecidas (Pesquisar, Fechar, Menu) e somente se tiverem rótulos acessíveis.
  • Consistência sobre Variedade: Use uma única biblioteca de ícones (ex.: Lucide, Heroicons) em vez de misturar estilos de várias fontes.
  • Escala da Espessura do Traço: Se um ícone for ampliado, sua espessura de traço deve idealmente permanecer proporcional ao seu tamanho para manter o "peso" visual em todo o layout.
  • Equilíbrio Óptico: Nem todos os ícones são criados iguais. Um ícone quadrado parece maior do que um circular da mesma largura. Use uma abordagem de "caixa delimitadora", mas ajuste manualmente o tamanho visual para equilíbrio.

Restrições

  • Acessibilidade: Ícones usados como links ou botões DEVEM ter uma alternativa de texto para leitores de tela.
  • Alvos de Toque: Ícones dentro de botões não devem reduzir a área de toque abaixo de 24x24px (WCAG 2.2 SC 2.5.8 mínimo); 44x44px é preferido para ações primárias apenas com ícone.
  • Responsividade: Em telas pequenas, os ícones podem precisar ser simplificados ou removidos se apertarem o texto, embora geralmente ajudem na leitura em dispositivos móveis.

Padrões Comuns de Falha

  • O Ícone "Carne Misteriosa": Usar um ícone sem rótulo que os usuários não reconhecem.
  • Pesos Inconsistentes: Misturar um ícone de contorno de 1px com um ícone em negrito de 3px na mesma linha.
  • Complexidade Excessiva: Usar ícones com muitas linhas finas que "borram" ou desaparecem em telas de baixa resolução ou tamanhos pequenos.
  • Acessibilidade Ausente: Usar ícones SVG sem títulos ou rótulos ARIA, deixando usuários de leitores de tela cegos para a ação.
  • Alinhamento Óptico Quebrado: Um botão "Play" que parece estar escorregando para fora do lado esquerdo de seu círculo porque está matematicamente centralizado, mas não opticamente centralizado.

Critérios de Validação

  • Todos os ícones pertencem a um único estilo visual coeso.
  • Os ícones têm uma escala de tamanho definida (ex.: 16, 24, 32, 48).
  • Ícones autônomos (se houver) têm aria-label ou alternativas de texto equivalentes.
  • Ícones decorativos estão marcados com aria-hidden="true".
  • Os ícones mantêm uma taxa de contraste de 3:1 contra seu fundo.
  • Elementos interativos apenas com ícone atendem ao alvo de toque mínimo de 24x24px da WCAG 2.2 (44x44px preferido).
  • As metáforas visuais são claras e padrão (sem "adivinhação").

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for non-overlay notifications, managing global announcements and contextual inline alerts to communicate system states without interrupting the user's flow.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Habilidades Relacionadas