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.
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.
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.
Botão, filtro e selo são arredondados por inteiro. Caixas usam cantos fixos em pixel.
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.
Cores
Só estes tokens. Nada de cor nova, gradiente, brilho ou emoji. O valor vem em HSL, como está no tema, e em hexadecimal.
<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.
Cantos
Sempre em pixel. Os utilitários relativos do tema arredondam demais caixas pequenas e viram oval.
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
Í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.
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.
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.
Informe a altura em centímetros.
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.
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.
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.
- Endereço de coletaAinda sem endereço cadastrado
- Transportadoras2 ativas na contaEm dia
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' }]}
/>Modal
Título e uma linha de contexto no alto, seções com rótulo no corpo e o rodapé com duas pílulas lado a lado. Com um botão só, ele ocupa as duas colunas.
import { Modal, ModalContent, ModalHeader, ModalBody, ModalFooter, BotaoModal } from '@/components/ui/modal';
<Modal open={aberto} onOpenChange={setAberto}>
<ModalContent largura="max-w-[560px]">
<ModalHeader titulo="Nova embalagem" descricao="Uma linha de contexto." />
<ModalBody className="space-y-8">
<section className="space-y-4">
<RotuloSecao>Identificação</RotuloSecao>
<CampoTexto label="Nome" />
</section>
</ModalBody>
<ModalFooter>
<BotaoModal variante="secundario">Cancelar</BotaoModal>
<BotaoModal variante="primario">Salvar</BotaoModal>
</ModalFooter>
</ModalContent>
</Modal>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.
Seu cadastro
Empresa
Loja Exemplo LtdaEndereç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.
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
- 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.
- 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.
