Communitygithub.com

design-de-dashboard-de-analytics

Construa, redesenhe ou critique um painel de analytics de produto com layout calmo no estilo Cloudflare — linha de KPIs com deltas e sparklines, abas de métricas sobre um gráfico, tabela de países classificável, funil de site-para-app-para-pago, jornadas de compradores, coortes de retenção, saúde do app, fontes de tráfego e um registro de eventos — com números honestos, rastreamento centrado em privacidade e uma verificação de qualidade por capturas de tela. Use para uma página de estatísticas, um app indie ou dashboard de SaaS, uma página 'como está meu produto', uma tela de métricas de administrador, ou quando perguntarem por que os números de um dashboard não batem.

O que é design-de-dashboard-de-analytics?

Esta skill orienta o design e a implementação de um dashboard de analytics de produto focado em clareza, honestidade e privacidade, inspirado em layouts como o da Cloudflare. Ela foi destilada da experiência real de construir e operar o dashboard de um aplicativo Mac enviado, cobrindo desde a definição de contratos de dados até a verificação de qualidade final por capturas de tela. A skill suporta plataformas como Claude Code, Cursor e Codex, e guia o usuário por seis etapas principais: contrato de dados, layout da página, construção de componentes, verificação de honestidade, verificação de privacidade e QA de screenshots. Elas enfatizam a importância de comparar períodos iguais, rotular janelas de tempo, tratar dados desconhecidos como uma linha visível, e garantir que o dashboard responda à pergunta 'o produto está crescendo?' em um relance. O resultado é um dashboard enxuto e sem dependências externas, utilizando SVG e CSS, com um guia de estilo claro e regras rígidas de acessibilidade.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boburjonmavlonov/analytics-dashboard-design-skill/tree/main/skills/analytics-dashboard-design

Perguntar na sua IA favorita

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

Documentação

Design de dashboard de analytics

Um dashboard para um produto responde a uma pergunta à primeira vista: está crescendo e onde as pessoas estão desistindo? Tudo na página existe para responder a isso e, em seguida, permitir que o proprietário investigue o porquê.

Esta skill foi destilada da construção e operação do dashboard de analytics de um aplicativo Mac enviado (site → download → instalação → trial → pago) e de cada bug que o proprietário pegou em uma captura de tela. O exemplo funcional está em examples/product-analytics.html com dados de amostra fixos.

Como trabalhar

Siga os passos em ordem. Cada um termina em um pronto quando você puder verificar.

1. Escreva o contrato de dados primeiro

Antes de qualquer UI, liste cada número que a página mostrará e, para cada um: o evento que ele conta, a janela de contagem, único ou total, o fuso horário e com qual 'período anterior' ele é comparado. Coloque-o na forma da resposta da API, não no código da UI. Veja references/metrics.md.

Pronto quando cada bloco, coluna e gráfico tiver uma linha no contrato, e dois lugares que mostram 'o mesmo' número o lerem do mesmo campo.

2. Faça o layout da página

Sidebar com links de seção, uma barra superior fixa com status de atualização e o seletor de período, depois seções na ordem da jornada: visão geral → países → funil → compradores → app → retenção → site → eventos. Uma coluna de conteúdo, máximo 1280 px. Veja references/layout.md.

Pronto quando a visão geral responder à pergunta de relance sem rolagem em 1440 × 900.

3. Construa os componentes a partir da referência

Use os padrões em references/components.md e o código em references/snippets.md: linha de KPI com traço fino, deltas com uma linha de base 'era', sparklines na janela do gráfico, abas de métricas sublinhadas sobre um único gráfico com alternância de tabela, tabela de países classificável com uma barra de participação na coluna ordenada, barras de funil com conversão por etapa, linhas de compradores expansíveis com uma linha do tempo, donuts com uma fatia explícita 'não informado', mapa de calor de retenção com níveis classificados.

As cores vêm apenas dos tokens em references/tokens.md; claro e escuro são obrigatórios.

Pronto quando nenhum componente inventar uma cor, raio ou tamanho de fonte fora dos tokens.

4. Verificação de honestidade

Percorra references/metrics.md seção por seção. Os culpados comuns: um '−100%' em uma base de 1, receita que atrasa em relação ao provedor de pagamento, pedidos de $0 contados como clientes, somas de únicos diários rotuladas como únicos, fatias de donut que silenciosamente descartam as pessoas que não informaram, uma 'fonte' que é um palpite mostrado como fato.

Pronto quando cada número declarar sua janela e cada estimativa disser que é uma.

5. Verificação de privacidade

Analytics para um produto em que as pessoas confiam não deve se tornar aquilo em que elas desconfiam. Siga references/privacy.md: sem cookies no site, sem IPs armazenados, sem conteúdo do usuário em eventos, IDs aleatórios por instalação, uma opção de exclusão no app e jornadas unidas por um hash diário com sal, nunca por identidade.

Pronto quando você puder colar o esquema de eventos na política de privacidade do produto sem editá-lo.

6. QA de captura de tela

Execute references/qa.md: capturas de tela reais em 1440, 1024 e 390 px, claro e escuro, cada período, com os totais verificados em relação a números calculados fora da página. Olhe para as imagens, não para o código.

Pronto quando todas as capturas de tela estiverem limpas e os totais conhecidos corresponderem.

Regras que se aplicam em todos os lugares

  • Ordem da jornada. As seções seguem o caminho que um cliente percorre, para que uma desistência seja lida de cima para baixo.
  • Uma janela por número, declarada. 'período', 'hoje', 'últimos 30 dias' fica sob a coluna ou na dica do bloco.
  • Compare semelhante com semelhante. O período anterior tem a mesma duração e termina onde o atual começa.
  • Sem alarde em bases pequenas. 0 → 3 é 'novo', não '+∞%'; um delta em 1 → 2 é mostrado, mas discreto.
  • Desconhecido é uma linha, não um buraco. Países desconhecidos, permissões não informadas e fontes não correspondidas são mostrados, classificados por último e contados nos totais.
  • Atualização é visível. 'Atualizado 09:00 UTC' e 'pagamentos sincronizados 08:57' no cabeçalho; um ponto vermelho e um erro em linguagem simples quando o carregamento falha.
  • A tabela está sempre a um clique de distância. Cada gráfico tem os valores diários exatos por trás de uma alternância 'Tabela'.
  • Teclado e leitores de tela. Gráficos recebem foco e percorrem os pontos com ← →; cabeçalhos classificáveis são botões com aria-sort; linhas expansíveis são role="button" com aria-expanded.
  • Sem dependências. SVG, gradientes cônicos CSS e Intl cobrem todos os gráficos aqui; o exemplo é um único arquivo HTML.

Estilo da casa

Cinzas neutros, uma cor de série azul, verde e vermelho apenas para bom e ruim, laranja apenas para a marca. Texto base de 13,5 px, valores de KPI de 24 px, peso 600 para números e títulos, figuras tabulares em todos os lugares onde um número pode mudar. Traços finos, não sombras. Raio de card de 8 px, controles de 6 px, barras de 4 px. Veja references/tokens.md.

Formato de crítica

Quando for solicitado a revisar um dashboard (código, uma URL ou uma captura de tela), responda nesta ordem:

  1. Veredito em uma frase: ele responde à pergunta de relance?
  2. Números que discordam — a mesma métrica mostrando dois valores, totais que não somam, janelas que não correspondem. Estes vêm primeiro porque destroem a confiança.
  3. Problemas de honestidade de references/metrics.md.
  4. Problemas de privacidade de references/privacy.md.
  5. Problemas de layout e componente, classificados por quanto eles atrasam o proprietário.
  6. O que funciona — seja breve, mas diga, para que um redesenho não o perca.

Cada problema: o que você viu, por que engana ou retarda, a correção.

Referências

ArquivoO que cobre
metrics.mdcontrato de dados, janelas de contagem, deltas, receita, atribuição, funis, coortes
layout.mdsidebar, barra superior, ordem das seções, grids, pontos de quebra, layout para celular
components.mdcada componente na página, seus estados e sua acessibilidade
tokens.mdtokens de cor claro e escuro, escala de tipo e espaçamento
snippets.mddelta, ticks de eixo bonitos, buckets, sparkline, donut, lista de barras, níveis de heatmap, plural
privacy.mdvisitas sem cookies, redes com hash, IDs de instalação, opção de exclusão, o que nunca coletar
qa.mdprotocolo de captura de tela, totais conhecidos, tabela de cheiros
case-study-typecorrect.mdo dashboard real de onde isso veio e os bugs que cada regra corrigiu

Habilidades Relacionadas