Migrating from Docusaurus to Astro

Docusaurus was and is great, I even made a nice GitHub action for folks to use for continuous deployment to AWS and Azure. I have used it at multiple places I have worked for making internal documentation and other quick sites. The reason changing to Astro was:

1. To learn a new ecosystem, because learning is fun
2. I really like Astro’s resuable components
3. Astro, to me, is way easier to customize

How

The Astro Docs do a great job of explaining how to migrate from docusaurus if you are already set up. For me though, I went through the tutorial on how to make an Astro site from scratch first. I did this in order to understand how everything works. I made a super ugly site, messed with it a bit, then came back and used the cli to create the blog template. After that I just copied content over and then used their guide to deploy to Azure.

What’s Next

I hope to write more in 2026. I have learned a ton in the last few years moving from product tech to a gaming studio that I think folks would find interesting and I want to share more about my side projects and the learnings along the way.