Deployment

We started deploying a Hugo site to GitHub Pages yesterday. CSS wouldn’t load. Images were broken. Path issues everywhere. Switched to Netlify. Everything worked immediately. Here’s why. The GitHub Pages Problem GitHub Pages is free and works great for simple static sites. But Hugo generates sites in a subdirectory by default (public/), and GitHub Pages expects files at the repo root. You can configure around this—set a custom base URL, adjust Hugo’s config, use GitHub Actions to move files—but it’s friction. ...