Launch a free site with GitHub Pages

GitHub Pages lets you turn any repository into a free website, and this beginner guide walks through the basic setup so you can publish something quickly without extra hosting overhead.

Sarah

One extra gotcha for beginners: set the repo’s default branch (often main) and pick the correct folder (/ vs /docs) in Settings → Pages, otherwise you’ll get a 404 even though the build “succeeds. ” Also remember Pages is static, so any server-side stuff needs to move to client-side or an API.

Quelly

Also worth noting that Pages only serves what’s actually committed, so if you’re using a build tool make sure the output folder is what Pages is publishing and that you pushed those files.

Yoshiii