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.
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.
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.
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.