Pular para o conteúdo

Design do sistema

Como a Proffy é desenhada.

As regras e as peças que formam cada tela do sistema, abertas para quem quiser ver. Tudo abaixo é o componente de verdade funcionando, com o trecho de uso ao lado.

Princípios

Quatro ideias que decidem quase toda dúvida de desenho.

1
Branco e respiro

Fundo branco, muito espaço e quase nenhum cartão. A informação se separa por régua fina e espaço, não por caixas.

2
Uma cor de ação

O verde lima é só para a ação principal e para o que está valendo. O resto é tinta, cinza e os tons de situação.

3
Tudo é pílula

Botão, filtro e selo são arredondados por inteiro. Caixas usam cantos fixos em pixel.

4
Dado com motivo

Nenhuma célula fica vazia ou com traço. Quando falta o dado, a tela diz por quê: "Ainda sem rastreio", "Sem descrição".

Marca

A logo principal vai sobre o branco; a versão branca, sobre o verde escuro. O site usa uma paleta própria, mais forte, em volta da do sistema.

Logo principal
Logo principalBaixar
Logo branca
Logo brancaBaixar
Cores do site
Verde profundo
#163300
Cabeçalho, rodapé e aberturas do site
Lima
#9FE870
O que se clica no site e títulos sobre o verde
Cinza claro
#F2F5F0
Cartões e seções alternadas

Cores

Só estes tokens. Nada de cor nova, gradiente, brilho ou emoji. O valor vem em HSL, como está no tema, e em hexadecimal.

--acao
hsl(102 77% 64%)
#87EA5D
Ação principal: botão e ação redonda
--acao-hover
hsl(102 76% 55%)
#69E335
Botão principal ao passar o mouse
--acao-soft
hsl(100 70% 93%)
#E9FAE1
Fundo do que está valendo
--foreground
hsl(111 100% 10%)
#083300
Texto principal, nunca preto puro
--muted-foreground
hsl(196 16% 41%)
#587079
Texto de apoio e rótulos
--secondary
hsl(100 12% 91%)
#E7EBE5
Botão secundário, filtros, pílulas pequenas
--border
hsl(200 16% 88%)
#DCE2E5
Régua, contorno de ícone e de cartão
--border-2
hsl(100 8% 72%)
#B6BDB2
Borda de campo
--background
hsl(0 0% 100%)
#FFFFFF
Fundo da página
--up
hsl(138 100% 25%)
#008026
Positivo: entregue, pago
--amber
hsl(39 100% 30%)
#996300
Alerta: pendente, aguardando
--red
hsl(0 67% 49%)
#D12929
Erro e valor debitado
<button className="bg-[hsl(var(--acao))] text-[hsl(var(--acao-ink))]">Salvar</button>
<p className="text-muted-foreground">Texto de apoio</p>
<div className="border-t border-border" />

Tipografia

Títulos em Manrope, o resto em Inter. Valor e código usam algarismos de largura igual (classe nums), para as colunas alinharem.

Título de página, 32 px, Manrope 800
Envios da semana
Título de seção, 18 px, Manrope 700
Aguardando coleta
Texto de linha, 14 a 16 px
Caixa de papelão P, 3 peças
Apoio, 12,5 a 14 px, cinza
Pedido 07/11, etiqueta 07/11 14:41
Código e rastreio, mono 12 px
AA000000000BR
Valor, nums
R$ 1.284,60

Cantos

Sempre em pixel. Os utilitários relativos do tema arredondam demais caixas pequenas e viram oval.

rounded-full
Pílula, círculo, selo
rounded-[6px]
Controle pequeno, caixa de marcar
rounded-[10px]
Campo
rounded-[12px]
Bloco de código copiável
rounded-[16px]
Aviso, opção grande
rounded-[24px]
Cartão de saldo e de apresentação

Espaçamento e medidas

  • Contêiner de toda tela: até 1440 px
  • Coluna de página de lista: 900 px
  • Passo central: 480, 560 ou 700 px
  • Respiro lateral: 16 px no celular, 24 a 40 px no computador
  • Campo: 48 px de altura, borda de 1 px
  • Pílulas: 32, 40 e 48 px de altura
  • Linha de lista: ícone de 48 px, título de 16 px, apoio de 14 px
  • Entre seções: 40 px; entre linhas: 12 px
4 px
8 px
12 px
16 px
24 px
40 px

Ícones

Ícones de linha da biblioteca lucide, dentro de um círculo com contorno. O fundo verde pálido é só para o que está valendo.

neutro
acao
alerta
erro
apagado
32
64
import { Truck } from 'lucide-react';
import { IconeContorno } from '@/components/ui/padrao';

<IconeContorno icone={Truck} tom="acao" tamanho={48} />

Botões

Todo botão é pílula. Uma ação principal por tela, no verde de ação; o resto em cinza ou só texto.

Variantes
Tamanhos: 32, 40 e 48 px
import { Plus } from 'lucide-react';
import { BotaoPilula, classePilula } from '@/components/ui/padrao';

<BotaoPilula variante="primario" tamanho="m" icone={Plus}>Novo envio</BotaoPilula>
<BotaoPilula variante="secundario" tamanho="p">Editar</BotaoPilula>
<BotaoPilula largo>Continuar</BotaoPilula>

// Link com cara de botão
<a href="/envios" className={classePilula({ variante: 'secundario', tamanho: 'm' })}>Ver envios</a>

Campos

Rótulo forte em cima, campo de 48 px e a ajuda ou o erro embaixo. Os campos aceitam label, ajuda e erro.

Aparece na sugestão de cada pedido.

import { CampoTexto, CampoSelecao, CampoMarcar, LinhaInterruptor } from '@/components/ui/padrao';

<CampoTexto label="Nome da embalagem" ajuda="Aparece na sugestão de cada pedido." />
<CampoTexto label="Altura (cm)" erro="Informe a altura em centímetros." />
<CampoSelecao label="Tipo"><option value="caixa">Caixa</option></CampoSelecao>
<LinhaInterruptor label="Enviar estoque às lojas" checked={ligado} onChange={...} />

Avisos

Mensagem calma, com canto de 16 px. A ação, quando existe, vai à direita.

Falta o endereço de coleta. Sem ele, a transportadora não libera a retirada.
As etiquetas compradas hoje entram no lote de impressão de amanhã cedo.
import { Aviso, BotaoPilula } from '@/components/ui/padrao';

<Aviso tom="alerta" acao={<BotaoPilula variante="secundario" tamanho="p">Cadastrar</BotaoPilula>}>
  Falta o endereço de coleta.
</Aviso>
<Aviso tom="info">...</Aviso>
<Aviso tom="erro">...</Aviso>

Situações e selos

A situação vai numa pílula pequena, com a bolinha na cor do tom. O positivo usa sempre o verde escuro, para ser lido de longe.

StatusPill (tabelas)
Entregue Em andamento Aguardando nota Falhou Rascunho Esperando coleta
SeloSituacao (listas)
PagaPendenteVencidaCanceladaEm vigor
import { SeloSituacao } from '@/components/ui/padrao';
import { DOT, StatusPill } from '@/components/ui/status-pill';

<StatusPill label="Entregue" dot={DOT.ok} />
<SeloSituacao tom="alerta" rotulo="Pendente" />

Estado vazio

Lista sem itens diz o porquê e o que fazer em seguida.

Nenhuma fatura ainda

A primeira fatura aparece quando o período fechar com etiquetas coletadas.

import { Wallet } from 'lucide-react';
import { EstadoVazio, BotaoPilula } from '@/components/ui/padrao';

<EstadoVazio
  icone={Wallet}
  titulo="Nenhuma fatura ainda"
  texto="A primeira fatura aparece quando o período fechar."
  acao={<BotaoPilula variante="secundario" tamanho="m">Ver envios</BotaoPilula>}
/>

Listas e linhas de dado

Linhas sem cartão. O passar do mouse pinta um cinza claro. Rótulo e valor, nos detalhes, vão em linhas de dado.

LinhaLista
  • Endereço de coletaAinda sem endereço cadastrado
  • Transportadoras2 ativas na contaEm dia
LinhaDado

Envio

  • DestinoCampinas, SP
  • Prazo3 dias úteis
  • RastreioAinda sem rastreio
  • FreteR$ 21,90
import { ListaLinhas, LinhaLista, LinhaDado, RotuloSecao } from '@/components/ui/padrao';

<ListaLinhas>
  <LinhaLista icone={Building2} titulo="Dados da empresa" subtitulo="..." seta aoClicar={abrir} />
</ListaLinhas>

<RotuloSecao>Envio</RotuloSecao>
<ul>
  <LinhaDado rotulo="Rastreio" valor="Ainda sem rastreio" />
  <LinhaDado rotulo="Frete" valor="R$ 21,90" forte />
</ul>

Filtros

Filtros de lista em pílulas. A escolhida fica escura.

<FiltroPilulas
  rotulo="Filtrar faturas"
  valor={filtro}
  aoMudar={setFiltro}
  opcoes={[{ valor: 'todos', rotulo: 'Todas' }, { valor: 'pagas', rotulo: 'Pagas' }]}
/>

Gaveta lateral

O detalhe que abre de lado no computador e em tela cheia no celular. O corpo rola e o rodapé fica preso.

import { GavetaLateral, BotaoPilula, LinhaDado, RotuloSecao } from '@/components/ui/padrao';

<GavetaLateral
  aberta={aberta}
  aoFechar={() => setAberta(false)}
  titulo="Envio"
  descricao="Pedido #1042, 07/11"
  rotuloFechar="Fechar"
  rodape={<BotaoPilula largo>Rastrear</BotaoPilula>}
>
  <RotuloSecao>Envio</RotuloSecao>
  <ul><LinhaDado rotulo="Destino" valor="Campinas, SP" /></ul>
</GavetaLateral>

Passos e código

Fluxos em passos mostram o progresso no alto. Código de confirmação tem uma caixa por dígito. Antes de enviar, a revisão lista o que foi preenchido.

Passo 2 de 4
Código de confirmação

Seu cadastro

  • Empresa

    Loja Exemplo Ltda
  • Endereço

    Ainda sem endereço
import { Progresso, CaixasCodigo, SecaoRevisao, LinhaRevisao } from '@/components/ui/padrao';

<Progresso passo={2} total={4} rotulo="Passo 2 de 4" />
<CaixasCodigo valor={codigo} aoMudar={setCodigo} rotulo="Código de confirmação" />
<SecaoRevisao titulo="Seu cadastro">
  <LinhaRevisao icone={Building2} rotulo="Empresa" valor="Loja Exemplo Ltda" acao="Alterar" aoAcao={voltar} />
</SecaoRevisao>

Carregando

Espera curta mostra o indicador no lugar do conteúdo, sem tirar a tela do lugar.

Carregando…

Como escrever

  • Frase curta e direta, na voz de quem usa: "Gerar etiqueta", não "Efetuar a geração".
  • Sem travessão no meio da frase. Se pedir um, reescreva a frase.
  • Célula sem dado mostra o motivo em texto, nunca "-" nem vazio.
  • Erro diz o que aconteceu e o que fazer: "Não deu para salvar. Tente de novo."
  • Sem emoji e sem nome de fornecedor de tecnologia na interface.
  • Todo texto passa pelo dicionário, em português e inglês.

Faça e não faça

Faça
  • Use as peças do padrão e ajuste por propriedade, não por classe solta.
  • Comece pela tela parecida que já existe e repita o desenho.
  • Confira no computador (1440 px) e no celular (390 px).
  • Separe com régua fina e espaço.
Não faça
  • Cartão em volta de lista, cartão dentro de cartão, sombra forte.
  • Cor fora dos tokens, gradiente, brilho.
  • Botão retangular ou canto relativo em controle pequeno.
  • Ícone preenchido de cor forte, avatar colorido.