Intro

Migrated the site from hugo to astro today.

Learned of Astro after the recent Cloudflare aquisition. It sounds like the Cloudflare and Astro teams are excited to be working together to build the future of the web. I’m looking forward to seeing where this goes.

Migration Notes

I started by installing Astro and creating a new project directory from their blog template inside of my Hugo installation. This was to allow me to easily compare the two and migrate content over while comparing them side-by-side.

npm create astro@latest -- --template blog

After having the blog template installed I started migrating over my markdown files, favicons, and other assets.

There were some minor differences between the “Frontmatter” (The YAML data at the top of each post defining the title, publish date, image, etc.). As example, Astro template uses a pubDate field instead of date which was easy enough to change with a quick find and replace.

After that I moved onto testing and playing around with the new site. I decided to use the starfield animation I had created last year as the background for the entire new site. I enjoy the slow spin of the stars collapsing towards the center as if being consumed by a black hole.

I wasn’t a fan of the default font that came with the Astro blog template so used the Astro Fonts integration. I settled on Geist for the body font and Geist Mono for code blocks.

After making sure the site was running locally I installed the Cloudflare adapter and deployed the site ensuring my wrangler.jsonc was configured correctly.

{
    "name": "jakonl",
    "compatibility_date": "2026-01-16",
    "assets": {
        "directory": "./dist",
  }
}

Within the Cloudflare admin portal I removed the custom domains from the previous Hugo worker jak.onl & klosterman.onl and added them to the new Astro worker. I also configured the Cloudflare Worker GitHub Integration. This makes it so when changes are made to the site and pushed to GitHub, the Cloudflare Worker will automatically deploy the changes.

Overall, it was a quick and painless migration. I’m looking forward to continuing to learn the ins and outs of Astro and publish more content.

Onward and upward! 🚀