Communitygithub.com

Diseño de Sistemas

Linguagem visual e UX para sistemas de gestão como CRMs, ERPs, painéis internos e portais B2B, em desktop e mobile. Use ao projetar ou revisar essas interfaces.

O que é Diseño de Sistemas?

Esta skill fornece uma linguagem visual e de UX completa para sistemas de gestão (CRMs, ERPs, dashboards, portais B2B). Ela define um sistema de design neutro e estruturado, que ganha vida através dos dados: cores, gráficos e protagonistas por tela. A base (menus, fundos, bordas) é calma e neutra, enquanto os dados recebem cor, forma e movimento, garantindo que a interface nunca pareça vazia ou genérica. A skill oferece tokens CSS prontos, exemplos em HTML, receitas para Tailwind e análises detalhadas de cada tema, garantindo que diferentes sistemas da mesma empresa compartilhem a mesma família visual. Princípios como fricção zero, uma ação principal por tela, estados vazios/de carregamento/de erro, e testes em mobile (390 px) e modo escuro são fundamentais. A personalização por sistema é feita através de `tokens.css` e `marcas.local.md`, que definem o acento e o tom dos neutros, permitindo que cada produto tenha sua identidade sem perder a coesão.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brandon4320/skill-diseno-sistemas/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

Design de Sistemas: uma única linguagem para todos

Neutro na base, vivo nos dados. A estrutura (fundos, menu, bordas) é calma e neutra, e sobre ela os dados têm cor, forma e movimento: gráficos, progresso, pessoas e projetos com sua cor. Uma tela sem gráficos, sem cor por entidade e sem um protagonista parece morta. Veja a seção "Vida" e abra 06, 07, 08 e 14 antes de projetar um painel. Vários sistemas de uma mesma empresa parecem da mesma família porque compartilham tokens, tipografia, raios, estados e peças. O que muda por sistema é o acento e o matiz dos neutros.

Neutro não significa cinza. A base pode ter o tom que a marca ou o uso de cada sistema exigir:

  • Matiz de marca: fundo com um leve matiz do acento, por exemplo um violeta ou azulado muito suave.
  • Fundo com tom: um fundo com tom e um menu escuro e opaco da marca (por exemplo azul marinho) em vez do branco plano.
  • Quente ou frio conforme o segmento.
  • Escuro para monitoramento.

A regra é a saturação e o contraste, não a cor: os neutros têm croma muito baixo (OKLCH C ≤ 0,02, ou até ~0,03 na tela), sempre do mesmo matiz em todo o sistema. Eles devem deixar que os estados e o acento sejam lidos como a única coisa com cor de verdade. Os hex cinza deste documento são o ponto de partida, não uma obrigação: cada sistema monta sua rampa de neutros com seu matiz (ver tokens.css).

  • Tokens prontos para colar: tokens.css. Nomes em português (fundo, superficie, tinta, texto-2, acento, verde-fundo…).

  • Exemplos em exemplos/:

    • tablero-crm.html: tela completa de um CRM.
    • componentes.html: galeria de todas as peças, com claro, escuro e celular.
    • recetas-tailwind.md: as peças em React + Tailwind v4 para copiar.

    Abra-os e sobreponha-os.

  • Capturas de referência: referencias/01…14-*.jpg. Abra a que corresponder antes de projetar algo semelhante.

  • Análise completa por tema, com valores e exemplos: analisis/01-estrutura.md … analisis/15-homogeneidade.md. Leia a do tema que estiver tratando.

Se existir marcas.local.md nesta pasta, leia-o primeiro: ele tem o acento, o matiz e as regras próprias de cada marca de quem usa a skill. O que ele diz prevalece sobre os valores de exemplo deste documento.

Receita rápida para uma tela nova:

  1. Escolha qual tela é (painel, lista, ficha, calendário, formulário, celular) e abra sua referência e seu exemplo em exemplos/.
  2. Defina o acento e o matiz dos neutros do sistema (tokens.css).
  3. Monte o quadro: barra lateral sobre a tela e o painel com migalhas de pão.
  4. Escreva o cabeçalho: título display grande e leve, subtítulo com números reais, um único botão preenchido.
  5. Linha de 3 a 6 KPIs: um protagonista e o restante em bandeja com cartão dentro, cada um com seu desenho.
  6. Corpo: cartões de entidade para o que está em andamento, tabela ou lista para o restante e um painel lateral de contexto.
  7. Dê vida: cor por entidade, avatares, um gráfico com estado e movimento ao carregar.
  8. Projete os estados vazio, carregando e erro (seção 6b).
  9. Teste a 390 px e no modo escuro.
  10. Passe a lista da seção 8, comparando-a ao lado das referências.

Princípios base: fricção zero, uma ação principal por tela, nada de textos de preenchimento, e todo botão que leva a uma lista te deixa parado na linha que corresponde.

1. Quadro do aplicativo (referências 02, 03, 07, 13)

  • A tela é bg-fundo (#F4F4F5). A barra lateral vai diretamente sobre a tela, com 240–256 px.
  • O conteúdo vai em um painel bg-painel ou bg-superficie, rounded-[var(--radius-quadro)], separado 8 px da borda e da barra, com borda de 1 px.
  • Barra lateral:
    • Em cima, logotipo ou seletor de empresa. Opcionalmente, buscador ⌘K.
    • Grupos com rótulo de 11 px em texto-3, maiúscula e tracking-wider.
    • Itens de 32–36 px com ícone de 16 px cinza e contagem cinza à direita.
    • O item ativo é uma pílula bg-superficie (ou bg-tinta text-white): nunca cor de marca.
    • Usuário (avatar, nome e cargo) no rodapé.
  • Barra superior do painel: 56 px com border-b. À esquerda, migalhas de pão ("Seção / Página", o pai em cinza). À direita, buscador ⌘K, notificações e avatar.
  • Cabeçalho da página:
    • Título de 20–24 px, peso 500–600, tracking-tight.
    • Abaixo, um subtítulo cinza com números reais do estado: "12 a faturar · 3 vencidas", nunca uma descrição genérica.
    • Ações à direita, na mesma linha.
  • Ordem vertical fixa: cabeçalho → filtros e visualização (segmentado) → linha de KPIs → corpo.
  • Corpo com contexto: grid-cols-[1fr_360px], com lista ou calendário à esquerda e painel de detalhes à direita (01, 02, 07).
  • Ficha: 3 colunas [1fr_1.6fr_1fr], com dados, atividade em abas com contagem e a empresa relacionada (03).

1b. Vida (o que a impede de ser uma planilha arrumada)

Veja 06 (Gr8r), 07 (Loops), 08 (Finora) e 14 (Solexa). Todo painel leva pelo menos 5 destes recursos:

  1. Cor por entidade. Cada projeto, cliente, pessoa ou serviço tem sua cor fixa, da paleta de dados e atribuída por id. Aparece em:

    • seu ícone ou avatar;
    • sua barra de progresso;
    • seu sparkline;
    • a linha da tabela. É o que mais dá vida (06: cada projeto e cada pessoa com sua cor).
  2. Todo número com um desenho. Um sparkline com área degrade, uma barra de ticks (07: risquinhas finas coloridas até a %), uma barra segmentada (06: blocos de 1 de 10) ou um anel de progresso (09, 13, 14). Um número sozinho é um número morto.

  3. Um protagonista por tela. Um cartão cheio de cor com degrade do acento, número grande em branco e um gráfico de linha branco com um ponto marcado (08 "Total Expenses", 09 "halfway there").

  4. Cartões de entidade, não apenas tabelas. Para o que está "em andamento" (projetos, serviços, oportunidades grandes) vão cartões em grade como em 06:

    • pílula de prioridade e etiquetas;
    • título grande com descrição de 2 linhas;
    • barra segmentada com "3 de 6 feitas · Vence 15 dez";
    • sparkline de atividade;
    • "Próximos passos" com checks e "+ Adicionar".
  5. Gente com rosto. Foto ou avatar ilustrado. Se não houver, monograma colorido. Pilhas de avatares sobrepostos para participantes. A equipe vai em cartões com sua barra de carga (06 "Team").

  6. Gráficos com estado. A barra ou o ponto ativo vai sólido e o restante tracejado ou tênue. Tooltip escuro com "valor | participação | vs. outro" (08). Mês em curso tracejado "MTD" (07).

  7. Fundo com clima. Um degrade muito suave do matiz do sistema na parte de cima do painel (08), ou uma foto ou ilustração na faixa do cabeçalho (14) ou no cartão de promoção ou plano (06 e 14, ilustração de linha).

  8. Movimento com propósito. Ao carregar, os números contam até seu valor (~600 ms), as barras crescem desde 0 e as linhas são desenhadas. Ao passar o mouse, o cartão sobe 1–2 px e a borda se destaca. O sucesso é visto no local com um toast. Tudo ease-out e respeitando prefers-reduced-motion.

  9. Bandeja com cartão dentro (o que parece "premium"). O KPI não é uma caixa plana: é uma bandeja bg-suave com raio 16 e padding 4 que leva:

    • em cima, o rótulo com ícone e ⋯ sobre a bandeja (07);
    • dentro, um cartão branco com raio 12, o número e seu desenho;
    • embaixo, o rodapé sobre a bandeja com ícone, contexto e delta (06). Mesmo padrão para os ícones: um quadrado branco de 36–40 px com borda e sombra mínima, sobre a bandeja (08).
  10. Ar. Padding generoso (20–24 em cartões grandes) e gaps de 16–20. Números de 28–40 px. O premium respira: se parecer apertado, remova coisas antes de diminuir.

Limite: a cor vive nos dados, nas entidades e em um protagonista. O quadro (menu, fundos, bordas, textos) permanece neutro.

2. Tipografia (análise 02)

  • Duas vozes, não uma:
    • Display para títulos, saudação e números: uma geométrica ou grotesca com personalidade como Outfit, General Sans, Satoshi ou Plus Jakarta (08 usa uma deste tipo).
    • Texto para a interface: Plus Jakarta Sans, Manrope ou Inter.
    • Mono com personalidade (JetBrains Mono, Geist Mono) para códigos (PR-0241, FAC-01101) e, em painéis técnicos ou de monitoramento, também para os números (14).
    • Geist ou Inter sozinhas parecem "básicas".
  • Títulos grandes e leves: a saudação ou título da página vai a 36–44 px no peso 400, com tracking-tight (06 "Good evening, Alex", 08). O grande não precisa de negrito.
  • Escala: 11 / 12 / 13 / 14 / 16 / 20 / 24 / 32 / 40. Um cartão não mistura mais de 3 tamanhos.
  • Pesos: 400 para texto e títulos grandes, 500 para títulos de cartão e ações, 500–600 para números. Nada de 700.
  • Dado = rótulo cinza de 12–13 px em cima e valor tinta de 14 px embaixo. Nunca "Rótulo: valor" na mesma linha dentro de uma ficha.
  • Números com tabular-nums, valores alinhados à direita. O símbolo da moeda, os centavos e a unidade vão em texto-3, um passo menor: $ 24.957,81.
  • Metadados em uma linha de 12 px cinza, unidos com " · ": "Cobranças · FAC-01101 · há 2 min".
  • A maiúscula fica apenas para os rótulos de grupo do menu. Cabeçalhos de tabela, botões e abas vão em minúscula inicial.

3. Cor (análise 03)

  • Existem três planos (fundo → painel → superficie) e a profundidade vem do tom mais uma borda de 1 px e sombras mínimas (ver a seção 4).

  • Neutros sob medida para cada sistema:

    • Uma única rampa: cada sistema escolhe o matiz de seus neutros (de sua marca ou de seu uso) e o usa em toda a rampa: fundo, painel, bordas e os três textos.
    • Croma baixo: o matiz deve ser percebido como "clima", não como cor. Se o fundo competir com uma pílula de estado, está muito saturado.
    • Sem misturas: nunca combinar uma rampa fria e uma quente no mesmo sistema.
    • Pode ir além do cinza: um fundo com tom ou um menu escuro de marca também são válidos. A condição é que o conteúdo continue em superfícies claras e legíveis, com os estados como a única nota forte.
  • Texto em tinta / texto-2 / texto-3, que são neutros com o mesmo matiz. Proibido #000 sobre #FFF.

  • Um único acento por sistema, usado apenas no botão principal, no toggle, no foco, no ponto de não lido e na aba ativa do celular. Nunca em títulos, fundos de cartão ou no menu.

  • Acento por sistema: cada sistema ou empresa tem um único acento (sua cor de marca). Se não tiver marca definida, grafite #18181B. O resto da skill é igual para todos.

  • Estados = pílula: fundo a 10% + texto saturado + ponto de 6 px. Nunca um fundo saturado com texto branco e nunca apenas cor: sempre com palavra.

    • Verde: feito, cobrado, online.
    • Âmbar: pendente, parcial, a vencer.
    • Vermelho: vencido, falhou, sem conexão.
    • Azul: em andamento, informativo.
    • Cinza: rascunho, anulado, reintegrado.
  • O normal não é colorido. O vermelho é apenas para o que exige ação. Se houver mais de 3 vermelhos na tela, eles são agrupados em um aviso.

  • A paleta de dados (dado-1…6, máximo 6) vive apenas em gráficos, barras de progresso e ícones de tipo. Em uma tabela, repete-se como risquinha de 3 px, nunca pintando a linha.

  • O projetado, parcial ou não selecionado vai tracejado ou a 30%; o real, sólido. Por exemplo, o mês em curso "MTD" (07, 08).

  • No máximo um cartão herói preenchido de cor por tela (08, 09).

  • Antes de terminar, conte as cores: cinzas + 1 acento + até 4 de estado + até 6 de dados.

4. Superfícies, raios e espaços (análise 04)

Raios em camadas. Cada nível interno é um pouco menos arredondado do que o que o contém (raio interno ≈ raio externo − padding). Não inventar outros valores:

ElementoRaio
Quadro do aplicativo (todo o sistema em uma caixa)26
Painel principal20
Cartão / bandeja / folha20
Cartão dentro da bandeja16
Botão / campo / buscador / ícone em quadro11–12
Botão pequeno / pílula / etiqueta7–9, ou redondo para filtros e "+12 %"

Em celular, os cartões vão a 20–24.

Espaços. Escala 4 / 8 / 12 / 16 / 20 / 24 / 32 / 40, sem 10, 14 nem 18.

  • Padding: 16–20 no cartão (12 se denso ou em celular) e 26–28 no painel.
  • Gap da grade: 14.
  • Entre blocos grandes: 28.
  • Entre seções: 32–40 de ar mais um título. Nunca uma linha grossa nem um fundo colorido.

Bordas e sombras.

  • Borda sempre de 1 px borda. Nada de 2 px nem bordas coloridas, exceto o foco.
  • Sombras em três níveis, sempre suaves e do tom da tinta (nunca preto puro):
    • Mínima (0 1px 2px /.05): em botões com borda, o cartão dentro da bandeja, o item ativo do menu e os ícones em quadro. É o que lhes dá "relevo" premium.
    • Ao passar o mouse (0 14px 30px -18px /.3, junto com subir 2 px): nos cartões clicáveis.
    • Flutuante (0 24px 48px -16px /.22): em menu, folha, modal e toast. O botão preto principal leva sombra própria e um brilho em cima (inset 0 1px 0 /.12).
    • Um cartão parado de conteúdo vai com borda, sem sombra grande.

Subdivisões. Para subdividir um cartão, use faixas de largura total (border-t ou um fundo suave) ou o padrão bandeja + cartão branco (ver "Vida", ponto 9). O que não funciona é empilhar três níveis de caixas com borda. As métricas em linha são separadas com divide-x.

5. Peças

Cartão KPI (06, 07, 13, 14 · análise 06)

  • Leva rótulo + número + linha de contexto, sempre. Um número sem seu "do quê" ou "em relação a quê" não funciona.
  • O número vai em tinta (24–28 px, 600, tabular-nums). A cor vai apenas no delta, na pílula ou na barra.
  • O delta diz seu período ("+12% vs. mês anterior", "+3 esta semana"), leva seta ↗/↘ e sua cor vem de se é bom ou ruim para o negócio, não do sinal: se a inadimplência cai, é verde.
  • Se houver algo vencido, o rodapé leva um ícone de alerta e um texto vermelho com quantos ("2 vencidas · Requer atenção").
  • O progresso contra um

...

[truncado para tradução]

Habilidades Relacionadas