Minha aventura migrando para o Astro: do susto à vitória!
Olá povo! Aqui é o Diego, e hoje vou contar como transformei nosso site simples num projeto moderno com Astro — e como quase dei um pulo quando o GitHub Pages resolveu pregar uma peça! Spoiler: no final, deu tudo certo e aprendi um truque massa pra compartilhar com vocês.
Tá, mas por que migrar?
Nosso site era daqueles bem “anos 2000”: HTML/CSS puro, estático, sem graça. Toda vez que precisava atualizar algo, era aquela trabalheira — editar manualmente, sem componentes, sem dinamismo… Tava na hora de dar um upgrade!
Foi aí que conheci o Astro e me apaixonei! Ele prometia performance incrível, manutenção fácil e aquele toque moderno que nosso site precisava. E olha, não me arrependi nem um pouco!
A migração: tudo ia bem… até que…
Peguei um template maneiro, ajustei as cores pro nosso branding e, em poucas horas, voilà! Site novinho em folha, lindo e funcional. Fiquei todo orgulhoso! Aí pensei: “Vou hospedar no GitHub Pages, é grátis e super prático”.
MAS… (sempre tem um “mas”)
Quando subi o site… Pá! Tudo quebrado! O CSS sumiu, o JS não funcionava… Que diabos estava acontecendo?
O mistério do GitHub Pages (e a solução mágica)
Depois de uma breve pesquisa (a documentação do Astro é ótima!), descobri o problema: o GitHub Pages usa Jekyll nos bastidores, e ele ignora pastas que começam com “_” — exatamente onde o Astro guarda os arquivos gerados!
Mas calma, a solução foi mais fácil do que eu imaginava:
✨ Basta criar um arquivo vazio chamado .nojekyll na raiz do projeto! ✨
Pronto! Problema resolvido, site funcionando liso que só!
O que aprendi (e por que você também deve experimentar o Astro)
- GitHub Pages tem suas manhas, mas nada que um truque simples não resolva;
- O Astro é demais! Fácil de usar, rápido e super versátil;
- Sempre vale a pena pesquisar — a solução muitas vezes está mais perto do que você imagina.
E aí, curtiu a aventura? Se você já passou por algo parecido ou tá pensando em migrar pro Astro, conta aqui nos comentários! Vamos trocar ideias e rir juntos dos perrengues de dev. 😄