Pular para o conteúdo
Sistema

Design system

Os tokens, as superfícies, a escala e o movimento deste site. Nada aqui é transcrito: cada amostra lê o token de verdade ou chama o mesmo módulo que a página chama.

Cor

Tokens

Declarados em oklch. Trocar o tema no canto da barra repinta tudo abaixo — a amostra é o token, não uma cópia dele.

--backgroundfundo da página
--foregroundtexto
--cardcartão opaco
--muted-foregroundtexto secundário
--primaryação principal
--accentacento
--successsucesso
--warningatenção
--destructivedestrutivo
--borderdivisa
--glow-1brilho violeta
--glow-2brilho ciano
Superfície

Três planos

O site tinha um só: quase todo card era bg-card com uma opacidade escolhida no lugar. Nomear os três papéis é o que dá estrutura antes do texto.

surface

vidro de repouso — todo card do site

surface-raised

a mesma peça vindo à frente

surface-sunken

recuado — chip, rótulo, meta

Profundidade

Elevação

Em superfície escura a profundidade vem de luz no topo, não de sombra preta — que sobre um fundo quase preto é invisível. Por isso elev-* traz um realce interno no tema escuro e some com ele no claro.

elev-1

repouso

elev-2

hover, popover

elev-3

sobreposição

Tipografia

Escala

Dois degraus abaixo do xs, com nome. Eram cinco valores avulsos para o mesmo papel de rótulo miúdo.

Engenharia de softwarenano0.625rem · contador, tecla
Engenharia de softwaremicro0.6875rem · tag, rótulo miúdo
Engenharia de softwarexsmeta do cartão
Engenharia de softwaresmcorpo secundário
Engenharia de softwarebasecorpo
Engenharia de software2xlnúmero de destaque
Engenharia de softwaretitlefluido · título de seção
Engenharia de softwaredisplay-smfluido · título de página
Engenharia de softwaredisplayfluido · abertura
Movimento

Três perfis

Uma primitiva só, aplicada igual em tudo, faz o olho parar de registrar em três segundos. Cada bloco abaixo entrou com o perfil que ele nomeia.

hero

abertura

28px · 700ms

section

título de seção

16px · 500ms

item

card em lista

12px · 420ms

A curva é uma só — --ease-out-expo — e tudo aqui para de se mexer quando o sistema pede movimento reduzido, inclusive o que é animado por JavaScript.

Teclado

Foco

Um contrato só, em outline: o anel de sombra apagaria a elevação do elemento justamente quando ele está em evidência. Navegue com Tab para ver.

Link
Capa

Arte procedural

O artigo sem imagem ganha uma capa derivada do próprio slug — determinística, e sempre dentro da faixa ciano→violeta da marca. A mesma função desenha o cartão que vai para as redes.

arquitetura-hexagonal
cloud-run-vs-fargate
java-21-virtual-threads
lideranca-tecnica
Peças

Primitivos

Os componentes que o site monta. Todos consomem os tokens acima — trocar o tema repinta cada um, sem que nenhum saiba qual tema está ativo.

Button

Badge

Padrão
Acento
Secundário
Sucesso
Atenção
Erro
Contorno

Campos

Os primitivos do painel — Kbd, StatusPill, Table — não aparecem aqui: eles leem tokens declarados só dentro do shell do painel, e fora dele renderizariam sem fundo e sem cor. São o mesmo sistema, em outro escopo.

Prova

Contraste medido

Números calculados agora, com as mesmas funções que os testes usam. Se um par cair abaixo do mínimo, ele cai aqui também — a página não sabe mentir.

Terminal do herói · --term-dim6.83:1
Terminal do herói · --term-fg12.45:1
Terminal do herói · --term-strong16.42:1
Capa procedural · pior matiz da família (78 medidas)14.78:1

Mínimo WCAG AA para texto normal: 4.5:1