When I went to create this blog, I quickly hit decision paralysis. Should I use a CMS? Which one? Strapi? Ghost? Sanity? Should I write the frontend in Next.js, or keep it simple with a static site generator like Hugo or Jekyll? Is WordPress still a thing? Where should I host?
After hours of research, I finally decided on Next.js and Strapi. Over-engineered for the purpose of this blog, but I thought learning this stack would be interesting. That is… until I looked at hosting cost. Hosting through Digital Ocean with the Strapi-recommended CPU and memory was going to be $50/mo, so I scrapped everything and went with basic Hugo and GitHub Pages. Hugo because I found a theme that I liked, GitHub Pages because it’s free.
Hugo is framework for static site generation, meaning the entirety of my blog will be written in markdown and checked into GitHub. I found the Cactus theme which is exactly what I was looking for. Simple, minimal. No bells, no whistles. My only gripe was the literal cactus logo and the light green color, so I changed those.
I had a hiccup with linking my custom domain steve.codes to GitHub Pages seastcott.github.io. In my domain’s DNS settings, I added a CNAME record with host www.steve.codes and value seastcott.github.io. This did not work as expected. I fundamentally misunderstood the meaning of host and how it is different than domain.
What I learned: host and domain are usually used together in the form host.domain.com, i.e. steve.codes is the domain and www is the host. www.steve.codes is technically a valid host, but that would leave us with www.steve.codes.steve.codes. With www.steve.codes set as the CNAME record host, I spent hours wondering why navigating to www.steve.codes was failing with a DNS error. I threw in the towel thinking it was a caching issue that would eventually resolve on its own (nope). I ran this problem by a friend the next day and fortunately he was able to set me straight.
And we’re live! I started wondering, though, how scalable is GitHub Pages? It is free after all. Sure enough, there’s a bandwidth limit of 100 GB per month and a site size limit of 1 GB. I’ll definitely never exceed these, but it’s worth exploring what my next-best option would be. I’ll look at this more in my next post.