Notes by Josh G. with musings and projects.https://jquest.dev/en-GBhttps://jquest.dev/blog/github-pages-cicd/https://jquest.dev/blog/github-pages-cicd/Notes on how I wired up Astro, GitHub Actions, and GitHub Pages for a clean deploy workflow.Mon, 09 Feb 2026 00:00:00 GMT<h2 id="why-github-pages">Why GitHub Pages</h2> <p>I wanted a zero-cost, low-maintenance deploy that still felt professional. GitHub Pages is perfect for static sites, and Astro makes it easy to generate a clean build.</p> <h2 id="the-flow">The Flow</h2> <p>This is the basic setup I landed on:</p> <ol> <li>Build the site on every push to <code>main</code>.</li> <li>Publish the <code>dist/</code> output to GitHub Pages.</li> <li>Keep the workflow simple and easy to debug.</li> </ol> <h2 id="what-i-configured">What I Configured</h2> <ul> <li>Astro build output set to <code>dist/</code>.</li> <li>GitHub Actions workflow that runs <code>npm ci</code> and <code>npm run build</code>.</li> <li>GitHub Pages configured to deploy from the Actions workflow.</li> </ul> <h2 id="what-i-like-about-it">What I Like About It</h2> <p>The deployment pipeline is reliable, fast, and doesn’t need any manual intervention. Once it is set, I can focus on writing and shipping.</p> <h2 id="next-iterations">Next Iterations</h2> <p>I plan to add a staging branch and run Lighthouse checks as part of the pipeline, but the current setup already feels solid.</p>AstroGitHub PagesCI/CDDeployment