~/design-system
Terminal Noir, peça por peça
Superfícies frias em degraus de luminância, um único acento âmbar, títulos em serifa editorial e uma voz monoespaçada para a máquina. Tudo aqui sai do código que serve o site.
Design tokens
Os valores abaixo são lidos do src/styles/global.css no build: o que aparece aqui é o que o navegador pinta. Nenhum componente usa cor ou medida fora desta escala.
Cores
Terminal Noir: superfícies frias separadas por degraus de luminância e um único acento âmbar. Noir é o padrão; Paper entra pelo sistema ou pelo botão de tema. A razão de contraste é medida contra o token indicado, nos dois temas.
- NoirPaper
--color-background
Fundo da página.
Noir #0b0b0cPaper #fbfaf7
- NoirPaper
--color-surface
Cards e painéis (camada 1).
Noir #121214Paper #f1efea
- NoirPaper
--color-surface-elevated
Popovers, diálogos e elementos flutuantes (camada 2).
Noir #18181bPaper #e9e6df
- NoirPaper
--color-border
Fio decorativo. Nunca o único limite de um alvo interativo.
Noir #222226Paper #dcd8cf1,24:1 / 1,36:1 sobre background
- NoirPaper
--color-border-strong
Contorno de campo, de alvo interativo e de hover.
Noir #6b6b74Paper #88837a3,73:1 / 3,61:1 sobre background
- NoirPaper
--color-selection
Fundo da seleção de texto.
Noir #52525bPaper #d6d2c87,03:1 / 11,50:1 sobre foreground
- NoirPaper
--color-foreground
Texto primário.
Noir #f4f4f5Paper #1c1a1717,90:1 / 16,63:1 sobre background
- NoirPaper
--color-muted-foreground
Texto secundário e metadados. Nada mais escuro que ele vira texto.
Noir #a1a1aaPaper #5e5a537,68:1 / 6,57:1 sobre background
- NoirPaper
--color-primary
Acento: CTA, link, comando e anel de foco. Nunca decoração.
Noir #f5a623Paper #8657009,71:1 / 5,96:1 sobre background
- NoirPaper
--color-primary-foreground
Texto sobre o acento.
Noir #0b0b0cPaper #fbfaf79,71:1 / 5,96:1 sobre primary
- NoirPaper
--color-success
Disponível, build passando.
Noir #34d399Paper #0b765610,23:1 / 5,38:1 sobre background
- NoirPaper
--color-whatsapp
Só o botão flutuante do WhatsApp.
Noir #25d366Paper #075e549,92:1 / 7,35:1 sobre background
- NoirPaper
--color-whatsapp-foreground
Ícone sobre o botão do WhatsApp.
Noir #0b0b0cPaper #fbfaf79,92:1 / 7,35:1 sobre whatsapp
- NoirPaper
--color-warning
Aviso, projeto arquivado.
Noir #facf9ePaper #8a530013,57:1 / 6,06:1 sobre background
- NoirPaper
--color-destructive
Erro de formulário, estado de falha.
Noir #ffb7b0Paper #b4231811,85:1 / 6,30:1 sobre background
Texto passa de 4,5:1 sobre background, surface e surface-elevated nos dois temas. O border reprova de propósito: é separador, e contorno que precisa ser percebido usa border-strong ou primary. Nenhuma informação depende só da cor.
Espaçamento
Grupos apertados, separação generosa. Valor fora da escala é a causa mais comum de um site parecer inacabado.
- --spacing-xs0.25rem · 4pxEntre ícone e rótulo.
- --spacing-sm0.5rem · 8pxInterno de badge e de botão.
- --spacing-md1rem · 16pxPadding padrão de componente.
- --spacing-lg1.5rem · 24pxPadding de card, entre blocos próximos.
- --spacing-paragraph1.25rem · 20pxEntre parágrafos do Prose.
- --spacing-xl2.5rem · 40pxEntre blocos dentro de uma seção.
- --spacing-2xl4rem · 64pxEntre seções no celular.
- --spacing-3xl6rem · 96pxEntre seções no desktop.
- --spacing-hero-top12.5rem · 200pxRespiro acima do texto do hero no desktop.
- --spacing-hero-bottom7.5rem · 120pxRespiro abaixo do texto do hero no desktop.
Raios e bordas
Borda de 1px em tudo; 2px só no anel de foco. Nada de botão em pílula.
- --radius-sm0.25rem · 4pxBadge, tag de tecnologia, chip e kbd.
- --radius-md0.375rem · 6pxBotão, campo, card.
- --radius-lg0.5rem · 8pxPainel, bloco de código, janela de terminal.
- --radius-full9999pxAvatar e ponto de status. Nunca botão.
Elevação e sombras
Profundidade vem de degraus de luminância e do fio, nunca de sombra sobre a página. Modal é o nível 2 com um fundo escurecido por trás.
- Nível 0Páginabackground, sem borda
- Nível 1Card, painelsurface + fio border
- Nível 2Popover, paletasurface-elevated + border-strong
- --shadow-glow0 0 24px rgb(245 166 35 / 0.25)Halo âmbar no hover do botão primário. O único brilho do sistema.
- --shadow-window0 12px 32px rgb(0 0 0 / 0.45)Só sob as janelas empilhadas do hero de vendas. A única sombra projetada.
Movimento
Três durações e uma curva. Só transform, opacity e cor animam. Com prefers-reduced-motion, o movimento para e a mudança de estado fica.
- --duration-fast
- 150ms
- Hover e troca de cor.
- --duration-base
- 250ms
- Entrada de elemento e revelação.
- --duration-slow
- 500ms
- Transição de página, entrada dos blocos e sublinhado do menu.
- --ease-out
- cubic-bezier(0, 0, 0.2, 1)
- Saída exponencial para toda transição.
Larguras e pontos de quebra
Mobile-first, sem rolagem horizontal a partir de 320px. Quebras em 640, 1024 e 1280px; a trava horizontal é overflow-x: clip, para o cabeçalho fixo continuar funcionando.
- --container-page
- 80rem · 1280px
- Coluna da página, alinhada à moldura.
- --container-frame
- 80rem · 1280px
- Cabeçalho e rodapé.
- --container-list
- 53rem · 848px
- Coluna central das listas: blog, arquivo, listas da home.
- --container-measure
- 42rem · 672px
- Medida de leitura das páginas de venda.
- --container-narrow
- 48rem · 768px
- Coluna estreita das páginas de venda.
- --container-sheet
- 64rem · 1024px
- Folha do currículo.
Components
Componentes próprios em Astro, sem biblioteca de UI e sem ilha de cliente. Cada um abaixo é renderizado de verdade, com as mesmas props que as páginas usam.
<Button />
Ação. Vira link com href e botão sem ele. Alvo mínimo de 44px e anel de foco âmbar.
src/components/ui/Button.astro
- primary: um por dobra; no hover acende o halo glow, o único brilho do sistema.
- secondary: surface com border-strong; o contorno vira âmbar no hover.
- ghost: só texto; ganha surface-elevated e texto âmbar no hover.
- arrow põe uma seta que avança no hover; disabled baixa a opacidade para 60%.
<Card />
Camada 1: surface delimitada pelo fio. O interativo sobe o fio para border-strong no hover, sem sombra.
src/components/ui/Card.astro
Padrão
Superfície estática para agrupar conteúdo.
Interativo
Passe o ponteiro: o fio sobe para border-strong.
- window acrescenta a sombra das janelas empilhadas, só no hero de vendas.
- Card dentro de card não existe.
<TerminalWindow />
Camada 2: uma janela rebaixada no fundo, com barra de título e slot de ações. Carrega o brief para agentes em /contato.
src/components/ui/TerminalWindow.astro
POST /api/hire
200 "Briefing recebido."<CodeBlock />
Endpoint ou payload de exemplo, com o rótulo da linguagem. Os blocos dos posts vêm do Shiki com o tema Terminal Noir.
src/components/ui/CodeBlock.astro
curl https://nandomoreira.dev/api/resume.json<CopyButton />
Copia o texto de um elemento pelo id. Funciona pelo script do SiteControls; sem JavaScript, o texto continua selecionável.
src/components/ui/CopyButton.astro
https://nandomoreira.dev/api/mcp- iconOnly: quadrado de 44px com o rótulo só para leitor de tela.
- compact: 32px de altura, para barras de ferramenta.
<TechBadge />
Tecnologia de um case. Ícone da marca quando existe, sempre com o nome escrito.
src/components/ui/TechBadge.astro
<StatusDot />
Ponto de disponibilidade, na marca do cabeçalho e nas pills. A cor segue o status e só pulsa enquanto está aberto; o texto ao lado diz o status.
src/components/ui/StatusDot.astro
<StatItem />
Um número da trajetória. Lança erro sem rótulo e contexto: número solto engana.
src/components/ui/StatItem.astro
<Alert />
Confirmação depois de uma ação, como o envio do formulário. O título diz o que aconteceu; a cor nunca carrega isso sozinha.
src/components/ui/Alert.astro
<EmptyState />
Lista sem itens ou resultado de uma ação sem conteúdo para mostrar. Ícone, título e o próximo passo.
src/components/ui/EmptyState.astro
Confira seu e-mail
Enviei um link de confirmação. A inscrição só vale depois do clique.
<ListRow />
Linha de lista da home: a linha inteira é o link, com data, até três marcadores e uma seta.
src/components/ui/ListRow.astro
<SectionHeader />
Título de seção. Padrão em mono com fio embaixo; accent para a home; step numera quando a ordem importa.
src/components/ui/SectionHeader.astro
Padrão
Mono, caixa alta, com o fio decorativo embaixo.
Accent
Numerado
<SectionRule />
Fio de ponta a ponta entre as seções da home. Decorativo: cada seção já tem o próprio título.
src/components/ui/SectionRule.astro
<UpdatedAt />
Faixa de data das páginas que mudam com o tempo: Setup, Agora e Privacidade.
src/components/ui/UpdatedAt.astro
Atualizada em .
<Prose />
Corpo de texto longo: Inter 18px/1.7, medida de 68ch e títulos em Newsreader.
src/components/ui/Prose.astro
Por que uma camada única
Só a camada de acesso chama getCollection. Sem essa regra, a primeira página com pressa lê direto e as superfícies divergem. Veja a página Sobre.
- Um teste varre src/ e reprova a chamada fora do lugar.
- O agente responde com o mesmo dado que a página mostra.
Um portão que nunca falhou não é portão.
Icons
(134)Todo ícone que o site renderiza, servido pelo astro-icon a partir dos pacotes Iconify instalados. Um teste reprova ícone usado e ausente desta lista, ou listado e sem uso. Ícone decorativo leva aria-hidden; controle só com ícone leva aria-label.
Interface (101)
Lucide, traço de contorno, 16 a 20px, herdando a cor do texto por currentColor. Os ícones de serviço ficam em 20px numa caixa de 32px.
- lucide:activity
- lucide:a-large-small
- lucide:app-window
- lucide:archive
- lucide:arrow-down
- lucide:arrow-right
- lucide:arrow-up
- lucide:arrow-up-right
- lucide:badge-check
- lucide:ban
- lucide:bell-off
- lucide:book-open
- lucide:bot
- lucide:calendar-days
- lucide:chart-no-axes-column-increasing
- lucide:check
- lucide:check-circle
- lucide:chevron-down
- lucide:circle-check
- lucide:circle-slash
- lucide:circle-x
- lucide:clipboard-check
- lucide:clipboard-list
- lucide:clock
- lucide:cloud-upload
- lucide:command
- lucide:copy
- lucide:credit-card
- lucide:database
- lucide:dot
- lucide:download
- lucide:external-link
- lucide:eye
- lucide:file
- lucide:file-check
- lucide:files
- lucide:file-text
- lucide:file-warning
- lucide:flask-conical
- lucide:gauge
- lucide:gift
- lucide:git-commit-horizontal
- lucide:git-pull-request
- lucide:globe
- lucide:hammer
- lucide:hand
- lucide:handshake
- lucide:image
- lucide:key-round
- lucide:layers
- lucide:layout-dashboard
- lucide:layout-grid
- lucide:layout-list
- lucide:layout-template
- lucide:life-buoy
- lucide:list
- lucide:list-checks
- lucide:lock
- lucide:lock-keyhole
- lucide:mail
- lucide:mail-check
- lucide:menu
- lucide:message-circle
- lucide:messages-square
- lucide:minus
- lucide:moon
- lucide:package
- lucide:package-check
- lucide:pause
- lucide:pencil
- lucide:play
- lucide:plug
- lucide:plus
- lucide:quote
- lucide:receipt
- lucide:receipt-text
- lucide:rocket
- lucide:rss
- lucide:scale
- lucide:scan-search
- lucide:search
- lucide:server
- lucide:settings
- lucide:shield-alert
- lucide:shield-check
- lucide:shield-off
- lucide:shirt
- lucide:shopping-bag
- lucide:shopping-cart
- lucide:sparkles
- lucide:sun
- lucide:table-of-contents
- lucide:tag
- lucide:terminal
- lucide:trending-up
- lucide:user
- lucide:user-round-check
- lucide:users
- lucide:workflow
- lucide:wrench
- lucide:x
Marcas e tecnologias (33)
Simple Icons, só para marcas: redes no rodapé e nos contatos, e as tecnologias do TechBadge. Sempre ao lado do nome, nunca sozinhos.
- simple-icons:astro
- simple-icons:claude
- simple-icons:cloudflare
- simple-icons:cursor
- simple-icons:docker
- simple-icons:fastapi
- simple-icons:firebase
- simple-icons:github
- simple-icons:githubactions
- simple-icons:githubcopilot
- simple-icons:googlecloud
- simple-icons:googlegemini
- simple-icons:googlesearchconsole
- simple-icons:hono
- simple-icons:instagram
- simple-icons:linkedin
- simple-icons:nextdotjs
- simple-icons:nodedotjs
- simple-icons:openai
- simple-icons:pandas
- simple-icons:polars
- simple-icons:postgresql
- simple-icons:python
- simple-icons:react
- simple-icons:replit
- simple-icons:supabase
- simple-icons:tailwindcss
- simple-icons:twitch
- simple-icons:typescript
- simple-icons:v0
- simple-icons:whatsapp
- simple-icons:x
- simple-icons:youtube
Typography
Três famílias, uma por trabalho, servidas do próprio site em WOFF2 com font-display: swap e subset latino. Nenhuma requisição a host de fonte externo.
Famílias
- Newsreader--font-serif"Newsreader", Georgia, "Times New Roman", serifPesos 400 a 500, variável, tamanho óptico de 24 a 72.Títulos. Dá peso editorial ao h1 e às seções do texto longo.
- Inter--font-sans"Inter", system-ui, sans-serifPesos 400 a 600, variável.Corpo e interface. Carrega o texto longo e todo o chrome.
- JetBrains Mono--font-mono"JetBrains Mono", ui-monospace, monospacePesos 400 e 500.Voz da máquina: navegação, datas, tecnologias, contadores e código.
Escala
Cada tamanho como o site o usa. Título em Newsreader fica em 400 ou 500; o texto corrido fica entre 65 e 75 caracteres por linha; o tracking nunca passa de -0.04em, e só o sobrescrito abre para 0.2em.
- --text-hero4.2rem · 67.2px / 1.05Newsreader
Software que chega à produção
Título do hero da home e das páginas de venda.
- --text-display3rem · 48px / 1.1Newsreader
Decisões técnicas explicadas
h1 das páginas internas a partir de 640px.
- --text-h12.25rem · 36px / 1.2Newsreader
Um portfólio que agentes leem
h1 no celular, título de post e de case, valor do StatItem.
- --text-h21.5rem · 24px / 1.3Newsreader
Por que Astro em modo servidor
Seção de texto longo (Prose).
- --text-h31.25rem · 20px / 1.4Inter
Fonte única de verdade
Subseção, título de card, lead do PageHeader.
- --text-lead1.2rem · 19.2px / 1.65Inter
Construo o produto, a esteira de dados e o padrão de engenharia que fazem a IA entregar resultado.
Parágrafo de abertura sob um título de hero.
- --text-prose1.125rem · 18px / 1.7Inter
O corpo de texto longo é sem serifa, 18px com entrelinha 1,7: no fundo escuro, leu melhor que a serifada.
Corpo de post e de case, sempre dentro do Prose, com medida de 68ch.
- --text-body1rem · 16px / 1.625Inter
Todo case precisa de ao menos um link verificável.
Texto de interface, resumos e rótulos de botão.
- --text-small0.875rem · 14px / 1.5Inter
Atualizado com o último build de produção.
Metadado e legenda.
- --text-caption0.8125rem · 13px / 1.5Inter
Disponível para projetos
Rótulo compacto no celular: a pill do hero, o TechBadge.
- --text-mono0.875rem · 14px / 1.6JetBrains Mono
POST /api/hire 200 OK
Navegação, data, endpoint e código em bloco.
- --text-micro0.6875rem · 11px / 1.4JetBrains Mono
Astro · Firebase · MCP
Marcadores de linha e rótulos de tabela, sempre em caixa alta.
- --text-code-inline0.875emJetBrains Mono
Só a camada de acesso chama
getCollection.Código em linha: 0.875em, segue o tamanho do texto em volta.