Pedro Wiezel
voltar para blog

construindo meu site com ia

como este site tomou forma no SvelteKit, com Claude, Gemini e uma implacável garantia de qualidade humana

Meu portfólio antigo era um clichê constrangedor. Fundo quase preto, fonte monoespaçada verde terminal, cursor piscando no hero e breadcrumbs falsos de terminal (~/showcase/cascade). Parecia ter sido gerado em quatro segundos por alguém que nunca desenhou nada na vida.

Eu queria um site que parecesse colagem, um dos estilos de design que mais amo. Também queria que ele rodasse bem em celular fraco, então escolhi o SvelteKit, que atualiza a página direto, sem passar por um DOM virtual. O site deve ficar fluido até num iPhone 6s antigo como o que tenho aqui, e que usei muito nos testes.

Então abri uma pasta vazia e passei as semanas seguintes construindo e melhorando ele progressivamente com o Claude e o Gemini.

Um design antigo da página inicial: DEVELOPER recortado de uma foto da Terra sobre PSYCHOLOGIST numa faixa vermelha, com botões coloridos ME, SHOWCASE, BLOG e chat sobre papel jornal
A primeiríssima versão do novo redesign

escapando do conjunto de treino

Quando eu pedia designs sem nenhuma direção específica, o resultado caía no meio dos dados de treino, a depender da empresa. Pra maioria dos modelos, isso significa gradientes roxos e bento grids, o padrão que dominou a web nos últimos anos. No caso do Claude, o padrão puxa pra um estilo editorial exagerado: títulos enormes em serifada, tipografia de revista dos anos 90, paleta terrosa e toques pretensamente artesanais.

Pra sair desse padrão, pedi pro Claude pesquisar escolas de design e arte, olhando artistas e designers de épocas e regiões diferentes. Depois ele desenhou pranchas avulsas em HTML com opções de redesign: o mapa de ônibus de Curitiba, risografia, planos concretistas e algumas outras.

A que decidi manter foi a que o Claude chamou de "Antropofagia", baseada no manifesto de mesmo nome de 1928 de Oswald de Andrade: em linhas gerais, a ideia de pegar o que você aprende de fora e fazer algo próprio com isso em vez de copiar. Achei interessante pois batia com a forma como o trabalho realmente acontece pra mim: Swift aprendido com a Apple, depois design a partir de um cânone majoritariamente europeu, depois psicologia com livros de fora, e no fim eu, um brasileiro, tenho que fazer coisas a partir disso tudo.

Nos componentes do SvelteKit, essa ideia virou literal. Em vez de colocar capturas de tela dentro de molduras falsas de navegador, as letras do título devoram a imagem do projeto mais recente direto na tipografia com background-clip: text. O resto do site fica quieto com seu papel-jornal e tipografia serifada, com a colagem aparecendo só em outros dois lugares: os títulos de seção e as capas rasgadas dos projetos em meio-tom.

Pra grade da vitrine de projetos, também me inspirei no site do estúdio Molleindustria, que coloca todos os jogos em uma grade com legendas que sempre achei muito legais e convidativas.

Uma versão anterior chegou a carimbar a página inicial com Tupi or not Tupi — Andrade, 1928, mas cortamos. Era meio cringe.

IA não tem olhos, mas pode usar uma régua

O título da página inicial foi um dos primeiros lugares em que o Claude me fez dar com a cara no muro. Uma linha de código quebrada é fácil de notar. CSS válido, com uma explicação convincente, que ainda assim renderiza errado num navegador de verdade é bem mais difícil.

Como as letras do hero podem carregar capas de projetos diferentes, elas precisam de um piso de contraste garantido pra continuarem legíveis sobre o fundo de papel-jornal (#fffdf9). O Claude combinou background-color, modo multiply e recorte de texto, me garantindo que o contraste nunca cairia abaixo de 3:1. No Chromium, o background-color é descartado silenciosamente do grupo de mesclagem quando o recorte de texto está ativo. Sobre uma capa escura como a do Cascade, as letras viravam uma mancha ilegível, enquanto as ferramentas de desenvolvedor mostravam estilos computados perfeitamente normais.

Discutir com o Claude no chat não me levou a lugar nenhum. Ele não enxergava a tela, então só insistia em explicar por que as contas dele deviam funcionar. O que resolveu foi uma verificação automatizada. Pedi pra ele escrever o floor.js com Playwright e Sharp. Ele abre um navegador headless, tira print do título, apara as bordas com antialiasing de cada letra e afere cada pixel interno. Se qualquer pixel cair abaixo de 3:1 de contraste contra o fundo, o script encerra com erro.

Saída do npm run floor no terminal, com a palavra do título passando de 3:1 de contraste em inglês e português, nos temas claro e escuro
npm run floor verificando o contraste

Assim que o modelo pôde rodar o script e ver números reais no terminal, o problema levou dez minutos. Gradientes lineares dentro de background-image continuam no grupo de mesclagem, então colocar um gradiente sob a capa travou a luminosidade sem mexer em background-color.

botões no papel

Os botões tinham a versão deles do problema. A maioria dos sites responde ao hover inflando o elemento com scale(1.04), e os que os LLMs fazem mais ainda, mas papel não incha quando o dedo chega perto. Eu queria botões que parecessem recortes de papel sobre papel-jornal, com um chanfro duro de 3px embaixo. Ao clicar, o recorte afunda até nivelar com a página.

Quando testamos pela primeira vez, metade dos botões não se mexia. As animações de entrada seguravam os valores de keyframe no lugar, anulando o estado de clique. Mudar o deslocamento do clique pra propriedade CSS translate resolveu na hora, já que translate funciona de forma independente dos keyframes.

Pra garantir que esse comportamento não quebrasse depois, o Claude bolou o scripts/press.js. Ele roda o Playwright, segura o ponteiro pressionado em cada botão em seis rotas nos dois temas e confere se o elemento se move 3px com um clique.

Três estilos de botão

tinta certificada

O problema mais lento de notar foi a deriva. Cada componente que o Claude escrevia funcionava bem sozinho, mas de uma sessão pra outra ele perdia a noção do resto do site.

Neste site, por exemplo, cada seção usa uma tinta própria: carvão na home, azul na vitrine, verde no blog e vermelho no contato. Cada link, estado de hover e chip de filtro deve herdar a cor --accent daquela seção. Só que uma folha de estilos com quatro cores continua parecendo normal a olho nu, então por semanas a página inicial do blog ficou com um link de voltar azul e um chip de filtro preto, até eu chegar nisso. O Claude nunca percebeu.

Pra resolver esse desvio, o Claude escreveu mais dois scripts, colors.js e look.js. Em vez de conferir prints na mão ou reler CSS, os scripts inspecionam o DOM ao vivo num navegador headless. Eles imprimem uma tabela de valores computados, garantem que cada elemento use a tinta certa da seção e medem as larguras das colunas. Se uma rota pega uma cor emprestada de outra seção, o teste falha.

palavras que cabem

O site é bilíngue, o que trouxe um problema de layout. As palavras em português são visivelmente mais compridas do que em inglês. DEVELOPER tem nove letras; DESENVOLVEDOR tem treze. Se você escolher um tamanho fixo de fonte ou chutar com breakpoints, um idioma às vezes vai estourar a coluna ou o outro vai parecer frouxo.

Em vez de adivinhar tamanhos de fonte ou valores de breakpoint, fiz o Claude escrever um pequeno script em Python com fontTools pra calcular a largura exata de avanço de cada palavra do título até a milésima fração de em. Guardamos esse valor numa propriedade customizada (--k) e usamos unidades de container query (cqi) pro título se ajustar sozinho à coluna:

.head { --k: 15.56; font-size: calc(88 / var(--k) * 1cqi); }

Os dois idiomas travam na coluna, evitando qualquer estouro.

o que mudou

Construir o site assim não me deixou pular a parte de entender como o navegador funciona. Precisei entender ainda mais, porque quando o Claude dava cinco motivos plausíveis pra uma animação ter quebrado, ainda era eu quem tinha que descobrir qual camada tinha falhado.

Também mudou o meu jeito de escrever prompts. Parágrafos longos tentando convencer um modelo a ter bom gosto não me levaram longe. Um script que encerra com código diferente de zero quando uma regra quebra levou, e depois disso os meus prompts ficaram curtos: o teste falhou, tá aqui a saída, conserta.

E a velocidade é real. O Claude refatorou algo como trinta componentes de uma vez quando a gente renomeou os tokens de design, e o Gemini descobriu por que o Mobile Safari precisava de um listener vazio de touchstart no +layout.svelte antes de registrar um clique. Cada uma dessas coisas levou minutos. O link de voltar do blog, enquanto isso, ficou azul por semanas.