Todos os artigos

· 3 min de leitura

Migrei meu site para Astro e Cloudflare Pages

Meu site pessoal rodava num template de 2019, com jQuery, 16 MB de dependências e um Apache para servir uma página. O que mudou na migração e por quê.

  • Astro
  • Cloudflare
  • Front-end

Casa de ferreiro, espeto de pau. Passo o dia cuidando de arquitetura e infraestrutura dos outros, mas meu próprio site estava abandonado: um template Bootstrap de 2019, editado à mão ao longo dos anos, servido por um Apache em um servidor que eu precisava manter atualizado só para isso.

Esta semana eu finalmente resolvi isso.

O ponto de partida

Quando parei para olhar com calma, a lista de problemas era maior do que eu imaginava:

  • A foto de perfil estava quebrada. Ela apontava para uma URL do LinkedIn com assinatura temporária, que tinha expirado havia anos.
  • O Google Analytics não coletava nada. O site ainda usava o Universal Analytics, desativado pelo Google em 2023.
  • 16 MB de dependências na pasta vendor, incluindo todos os arquivos do Font Awesome, para exibir onze ícones.
  • O build não funcionava mais. O Gulp dependia de uma versão do node-sass que não compila em Node.js moderno. As últimas alterações tinham sido feitas direto no CSS compilado, então o código-fonte SCSS estava desatualizado.
  • No celular, o título estourava a tela e o menu aberto ficava transparente sobre o conteúdo.

Nada disso era grave isoladamente. Juntos, mostravam um site que ninguém (eu) estava cuidando.

Por que Astro

Eu já usava o Astro no site da CFLG e na TeraSis, e ele resolve exatamente o problema de um site como este: conteúdo estático, gerado no build, com zero JavaScript por padrão.

Os pontos que mais pesaram:

  • Componentes sem custo no navegador. Escrevo o site em componentes, mas o resultado final é HTML e CSS puros.
  • Content collections. Os posts deste blog são arquivos Markdown no repositório, com frontmatter validado por um schema. Se eu esquecer a data ou escrever a descrição longa demais, o build falha.
  • Internacionalização nativa. O site agora existe em português, inglês e italiano, com rotas e hreflang corretos.
  • Otimização de imagens embutida, gerando WebP no tamanho certo.

Por que Cloudflare Pages

O domínio já estava na Cloudflare, então o Pages foi uma escolha natural:

  • Deploy a cada push. Cada commit no master vai para produção; cada branch ganha uma URL de preview.
  • Nenhum servidor para manter. O Apache e o servidor que existiam só para servir uma página podem ser desligados.
  • Headers configurados por arquivo. Um _headers no repositório define a política de segurança (CSP, HSTS) e as regras de cache.

Alguns detalhes que gostei de resolver

Tema claro e escuro sem “piscar”. O tema segue a preferência do sistema, mas pode ser trocado manualmente. Para aplicar a escolha antes da primeira pintura da tela, sem exigir 'unsafe-inline' na Content Security Policy, o script fica em um arquivo externo bem pequeno, carregado de forma síncrona no <head>.

Ícones em SVG inline. Os 16 MB do Font Awesome viraram um componente com nove ícones desenhados em SVG.

Posts agendados. O site só publica posts cuja data já passou no momento do build. Com um deploy hook do Pages disparado uma vez por dia, posso deixar artigos prontos no repositório com data futura, e eles aparecem sozinhos no dia certo.

O resultado

Um site mais leve, mais rápido, em três idiomas, sem servidor para administrar e com um blog que, espero, vai ter um artigo novo toda semana.

Se quiser trocar uma ideia sobre a migração ou sobre o seu próprio site, é só me chamar.