Design system da interface
Esta página mostra como a janela do CoboGov é desenhada: cores, tipografia, componentes, padrões de tela e regras de escrita. Serve a quem quer entender as escolhas da interface, a quem avalia o produto e a quem projeta algo parecido. Ela vale para a interface do plugin. O Padrão Digital de Governo (DS gov.br), que o plugin ajuda a verificar, é outro assunto: aqui o gov.br é a base visual, e o desenho final é próprio do CoboGov.
Os valores abaixo são os usados na versão atual e podem mudar.
Princípios
- Interface enxuta. A janela mostra só o que a pessoa faz agora. Referências a normas ficam nas fichas e nos artefatos do canvas, nunca na janela. A mecânica interna da coleta de dados também não aparece.
- Nada repetido. Cada informação aparece em um lugar só. O nome do projeto está no topo; a descrição de um card não repete a explicação da dica.
- Cada tela explica para que serve. Toda ferramenta, tela e etapa tem uma dica "?" curta, em linguagem simples.
- Uma ação principal por tela. Consultas eventuais ficam recolhidas.
- Acessibilidade desde o projeto. A janela é projetada para o nível AA do WCAG 2.1: nomes acessíveis nos botões, foco visível, foco preso nos modais, avisos para leitor de tela, estado que não depende só de cor e contraste conferido nos dois temas. Veja os limites em Acessibilidade.
- Identidade gov.br, desenho próprio. Paleta e escalas vêm do DS gov.br (V3). O símbolo, a organização por etapas e os componentes são do CoboGov.
- Cobogó como textura. No site, o topo azul da página inicial leva um fundo de módulos de cobogó (quadrado com vazado circular, a mesma geometria da faixa de cobogó dos artefatos), em azul da V3 com transparência: é só decoração, fora do alcance de leitores de tela, sem movimento, e o texto por cima mantém contraste AA.
Fundamentos
Cor
A interface usa somente a paleta V3 do DS gov.br . As cores abaixo são as do tema claro.
| Função | Token do DS | Valor |
|---|---|---|
| Interativo (links, botões, seleção) | blue-warm-vivid-70 | #1351b4 |
| Fundo | branco | #ffffff |
| Fundo alternativo | cinza claro | #f8f8f8 |
| Fundo escuro (cabeçalho, rodapé, balão de dica) | blue-warm-vivid-90 | #071d41 |
| Texto | cinza escuro | #333333 |
| Texto secundário | cinza médio | #636363 |
| Borda de artefatos e divisórias | cinza claro | #cccccc |
| Borda de campo (contraste 3:1 ou mais) | cinza médio | #767676 |
| Foco | gold-vivid-40 | #c2850c |
| Destaque da introdução | blue-warm-vivid-5 | #edf5ff |
Cabeçalho e rodapé usam blue-warm-vivid-90 (#071d41) com texto branco e logo em negativo.
Um acento por área. Cada área tem uma cor para o ícone, o fio lateral, a faixa e o contador.
| Área | Cor do acento | Faixa | Contador |
|---|---|---|---|
| Projeto | #1351b4 (azul) | #edf5ff | #d4e5ff |
| Design | #783cb9 (violet-vivid-60) | #f7f2ff | #ede3ff |
| Acessibilidade | #0e4f5c (cyan-vivid-70) | #e5faff | #a8f2ff |
| Gestão | #8c471c (orange-vivid-60) | #fdf5e6 | #fce2c5 |
Verde e vermelho são só para estados. Não são usados como decoração.
| Situação | Cor | Fundo | Texto sobre o fundo |
|---|---|---|---|
| Sucesso | #168821 | #e3f5e1 | #0e5f18 |
| Erro e perigo | #e52207 | #fde0db | #a81905 |
| Atenção | #ffcd07 | #fff5c2 | #5c4809 |
| Informação | #155bcb | #d4e5ff | #333333 |
Tema escuro. O tema escuro troca as cores por pares de contraste conferido.
| Item | Claro | Escuro |
|---|---|---|
| Fundo | #ffffff | #1b1b1b |
| Fundo alternativo | #f8f8f8 | #252f3e |
| Interativo | #1351b4 | #adcdff |
| Texto | #333333 | #fcfcfc |
| Texto secundário | #636363 | #adadad |
| Borda | #cccccc | #555555 |
| Borda de campo | #767676 | #8c8c8c |
| Foco | #c2850c | #ffbe2e |
No escuro, os acentos de área ficam nos tons claros da mesma família (por exemplo, Design #d5bfff sobre #39215e). O tema segue o Figma por padrão e a pessoa pode forçar claro ou escuro na Personalização.
Tipografia
A fonte é a Rawline, a do DS gov.br, com Raleway e a fonte do sistema como reserva. O tamanho base é de 13 px, com entrelinha de 1,45.
| Uso | Tamanho | Peso |
|---|---|---|
| Título da tela (h1) | 20 px | 600, com fio de 4 px na cor interativa à esquerda |
| Título de seção | 14 px | 700 |
| Título de etapa na home | 15 px | 700 |
| Texto corrente | 13 px | 400 |
| Rótulo de campo | 12 px | 600 |
| Texto de apoio e dica | 12 px | 400 |
| Contador, selo, rótulo de parte | 10 a 11 px | 700 |
O tamanho do texto da Personalização multiplica todos esses valores. Ícones e imagens mantêm o tamanho.
Espaçamento
A interface trabalha em passos de 4 px.
| Uso | Valor |
|---|---|
| Entre itens de uma linha de ações | 8 px |
| Respiro vertical de uma ação ou campo | 12 px |
| Entre seções (linha divisória, depois respiro) | 16 a 20 px |
| Recuo interno da tela | 16 px |
| Recuo interno de card e de painel | 12 px |
| Recuo interno de modal | 20 px de altura por 24 px de largura |
Raio e elevação
| Elemento | Raio |
|---|---|
| Campos, tags, código | 4 px |
| Botões, cards, modais, avisos | 8 px |
| Abas da documentação, contadores, selo de plano, botões de ícone | totalmente arredondado |
Só têm sombra o painel de Personalização, o balão de dica e o modal.
Foco
O foco é um contorno tracejado de 4 px, com 2 px de afastamento, na cor de foco do tema. No cabeçalho e no rodapé azuis ele fica branco. Dentro de uma área da home, ele assume a cor de acento da área. O contorno de foco não é removido de nenhum controle.
Componentes
Botões
| Tipo | Quando usar | Aparência |
|---|---|---|
| Primário | A ação principal da tela. Uma por tela. | Fundo na cor interativa, texto na cor do fundo |
| Secundário | Ações de apoio | Contorno de 1 px na cor interativa, fundo transparente |
| Terciário | Ações discretas | Sem contorno, texto interativo |
| Perigo | Ações que apagam ou desfazem | Contorno e texto em vermelho legível |
| Mini | Ações dentro de cards e listas | Altura de 24 px, texto de 11 px |
| Ícone | Fechar, subir, descer | Redondo, 32 px |
Altura mínima de 32 px, recuo lateral de 16 px, texto em peso 600. O botão desabilitado fica com 45% de opacidade e cursor de bloqueio. Botões de mesma importância lado a lado dividem a largura. Botão só com ícone leva nome acessível com a ação e o alvo.
Campos
Um único desenho para a interface inteira, inclusive para o seletor: rótulo de 12 px em peso 600 acima, controle de 36 px de altura, borda de controle de 1 px (#767676 no claro), raio de 4 px. No passar do mouse, a borda assume a cor interativa. Texto de apoio vem abaixo, em cor secundária. Campo desabilitado fica com 45% de opacidade.
Seletor
Os componentes de seleção têm a identidade do CoboGov, e tema e tamanho do texto valem também para eles.
- Lista curta, de até cerca de 30 opções: seletor do CoboGov. A lista abre sempre abaixo do campo e rola dentro da janela. Grupos têm título pequeno e divisor.
- O seletor nativo do sistema não é usado, porque o pop-up dele abre sobre o campo.
Campo de busca com lista abaixo
Para listas longas (órgãos, unidades, jornadas), o campo de texto filtra e uma lista com rolagem própria aparece logo abaixo, no fluxo da página, com até 6 linhas visíveis e no máximo 100 resultados. A busca ignora acento e maiúsculas e aceita partes do texto. No teclado: seta para baixo entra na lista, Enter escolhe, Esc volta ao campo. A contagem de resultados é anunciada para leitor de tela.
Quando a escolha é complexa (Órgão e Unidade), o valor escolhido aparece numa linha do formulário, com sigla em destaque e os botões Escolher ou Trocar e Remover, e a busca acontece num modal.
Modais
Centralizados, com margem de 16 px até a borda da janela, fundo escurecido a 45% e largura total disponível. O título fica fixo no topo enquanto o conteúdo rola. Ao abrir, o foco vai para o primeiro campo ou para o item marcado como inicial; Tab fica preso dentro do modal; Esc fecha; ao fechar, o foco volta a quem abriu. O modal de carregamento fica acima de tudo, sem botões, com o texto do que está acontecendo.
Cartões de etapa na home
Cada etapa do fluxo é um cartão horizontal, com uma cor própria por etapa (da paleta V3, com contraste AA nos dois temas). O cartão mostra número, nome, descrição curta e o contador do que foi criado. Ao escolher um cartão, abre a página da etapa, com as ferramentas e os artefatos dela. Uma trilha no alto mostra onde a pessoa está e deixa voltar aos níveis acima; ela não repete a página aberta. A dica "?" fica ao lado do nome, sem competir com o clique do cartão.
Escolha de tela e de etapa da documentação
Na documentação por tela, duas listas deixam escolher a tela e a etapa da documentação (design: componentes, navegação, funcionamento, entrega; acessibilidade: leitor de tela, ordem de foco e, em apps, gestos). A etapa concluída mostra um sinal de feito. A dica fica ao lado das listas.
Dica "?"
Botão redondo de 24 px (20 px nas linhas da home) que abre um balão escuro com a explicação, no padrão de dica por clique: o texto é anunciado ao abrir; Esc ou um clique fora fecham. O balão abre centrado no botão, sempre dentro da janela, e vai para cima quando falta espaço embaixo. O nome do botão é "O que é" seguido do assunto.
Selo de plano
Pílula escura (mesma cor do cabeçalho) com o nome do plano, ao lado do nome do que está travado. Veja o padrão de convite mais abaixo.
Tags, avisos e carregamento
| Componente | Uso | Regra |
|---|---|---|
| Tag | Situação curta de um item (atende, não atende, sem evidência) | Sempre com texto; nunca só cor |
| Aviso de atenção | Algo que pede cuidado | Fundo amarelo claro e fio de 4 px à esquerda |
| Aviso de informação | Esclarecimento | Fundo azul claro e fio de 4 px à esquerda |
| Aviso passageiro | Resultado de uma ação | Cartão escuro na base; verde para sucesso, vermelho para erro; tempo proporcional ao texto; Esc dispensa |
| Estado vazio | Lista sem itens | Texto secundário em caixa tracejada |
| Carregamento | Desenho no canvas ou varredura | Modal com girador e texto; abre só após 0,25 s para não piscar; "X de Y" quando há lote |
Os avisos também são anunciados para leitor de tela, com mais urgência quando é erro.
Outros componentes
| Componente | Detalhe |
|---|---|
| Interruptor | Trilho de 40 por 22 px, botão de 16 px; ligado na cor interativa |
| Seleção em passos | Menos, valor, mais, em pílula; o valor é anunciado |
| Opção em grupo | Marcação com ✓ além da cor |
| Estrelas | Cheia e vazia pela forma, não só pela cor |
| Tabela | Linhas finas, cabeçalho em 600, texto de 12 px |
Padrões
Home por etapas
A home segue o fluxo de design: um cartão por etapa, na ordem da jornada. Acima, o logo do CoboGov, o mesmo do cabeçalho (quadrado azul com quatro módulos vazados de cobogó), com os dois vazados de cima como olhos que piscam, e uma frase de introdução. O mesmo logo animado abre a home deste site. As animações do símbolo são curtas, acontecem uma vez por sessão e são desligadas por quem prefere movimento reduzido.
Documentação por tela
A lista de telas do serviço mostra o progresso de cada uma. Ao abrir uma tela, a pessoa escolhe a etapa da documentação: componentes, navegação, funcionamento e entrega no caso de design; leitor de tela, ordem de foco e gestos no caso de acessibilidade. Gestos só existe para telas de aplicativo.
Seções
Assuntos diferentes ficam em seções: título com contagem quando há lista, linha divisória e respiro. A ordem típica é a ação principal logo abaixo do título, depois o que se cria, o que já existe e o que falta. Ação perigosa fica numa seção própria, longe das ações seguras. O título da seção não repete o texto do botão.
Convite do plano
Quando uma ferramenta ou recurso exige um plano maior, a linha ganha o selo do plano e, ao clicar, abre um convite em modal. O convite diz o que travou, lista o que o plano libera e explica como liberar. Nada fica escondido: a pessoa vê que o recurso existe.
Confirmação com o que vai acontecer
Antes de apagar ou desfazer algo, a confirmação diz o que vai acontecer: uma frase em negrito com a consequência e uma lista dos itens afetados (cards, telas, marcações no canvas). O botão de perigo repete o verbo da ação (por exemplo, "Apagar tela"), e o outro botão cancela. Quando a exclusão mexe no canvas, o aviso informa que marcações apagadas direto no canvas não podem ser reconhecidas depois.
Personalização
A Personalização fica no cabeçalho e é uma preferência de cada pessoa, guardada no computador dela e nunca no arquivo do Figma.
| Ajuste | Opções |
|---|---|
| Tamanho da interface | 100%, 115% e 130% |
| Tamanho do texto | 100%, 125% e 150% (muda só as letras) |
| Tema | Igual ao Figma, claro ou escuro, em miniaturas |
| Espaçamento de texto | Liga o espaçamento de linhas, letras e palavras do critério 1.4.12 do WCAG 2.1 (entrelinha de 1,5, letras com 0,12 e palavras com 0,16) |
| Leitura em voz alta | Lê o que recebe foco ou fica sob o mouse, e os avisos; voz do sistema, nada sai do computador; Esc interrompe; velocidade devagar, normal ou rápida |
O painel tem o botão "Restaurar padrão". A leitura em voz alta não substitui o leitor de tela e fica indisponível quando o sistema não oferece síntese de voz.
Escrita
- Português simples, em voz ativa, com verbo de ação nos botões ("Escolher órgão", "Apagar tela").
- Sistemas, portais, sites e painéis do serviço público. O texto fala no que se projeta (sistemas, portais, sites e painéis), não em "serviços" genéricos.
- Card da home: nome e descrição de até 8 palavras, só o essencial.
- Ajuda ("?"): de 8 a 45 palavras, dizendo para que serve a ferramenta.
- Tela: no máximo uma frase de abertura, sem repetir o card.
- Sem norma na janela. eMAG, WCAG, páginas do DS e autores de métodos aparecem apenas nas fichas e nos artefatos do canvas.
- Termo em inglês consagrado (Benchmarking, Service Blueprint, Persona) é o nome principal do método, marcado como inglês para o leitor de tela; o nome em português aparece abaixo, em texto menor.
- Mensagem de erro diz o que aconteceu e como resolver.
- Termos do plugin: artefato, tela, jornada, Prumo, ficha, réplica.
Identidade dos artefatos no canvas
O que o plugin desenha no Figma usa a mesma paleta e a mesma fonte da janela.
| Artefato | Identidade |
|---|---|
| Artefatos | Desenhados com os componentes visuais do próprio plugin: caixas com auto layout, texto em Rawline com entrelinha de 145%, campos com borda de 1 px e raio de 4 px, faixa de cobogó como assinatura. Cores: interativo #1351b4, fundo escuro #071d41, título #0c326f, texto #333333, borda #cccccc |
| Tons de agrupamento | Informação #155bcb, sucesso #168821, atenção #947100, perigo #e52207, neutro #636363 e destaque #071d41, cada um com um fundo claro |
| Nome em inglês | Aparece no cabeçalho do artefato, em texto menor |
| Fichas | Abrem com a imagem da tela, têm versões (atualizar no lugar ou guardar a anterior ao lado, com data) e trazem a base do DS usada |
| Réplicas | Uma Section na página da tela, abaixo dela, com título, o selo Cópia de trabalho, a cópia sem interações e a legenda de que não é a tela original, com a data |
| Etiquetas da Inspeção | Numeradas e com o nome do elemento (por exemplo, #3-Botão), ficam fora da cópia, à esquerda, ligadas ao contorno do elemento por uma linha tracejada com ponto |
| Etiquetas F-n | Do Funcionamento, na cor da categoria, ligadas ao cartão da réplica |
| Fluxos | Linha em cotovelo ou reta na cor do tipo de conexão, ponto na origem, seta e círculos de início (verde) e fim (vermelho) |
A limpeza por etapa apaga só o que o plugin criou. As telas do designer nunca são apagadas.