Github Pages allow developers to host a static website of their project for free. It is one of Github’s key facilities that has made maintaining free open source projects more economical especially for indie developers.
Bootstrap and Normalize.css are a couple of popular Github pages. To create one, you only need to create a new branch of your project repository, and call it
gh-pages. Publish the branch to Github.
Once it is up, the site is accessible via the URL which is set relative to your Github username as well as the repository name.
You can setup a custom domain for your Github page. We have shown it how to do so in our previous tutorial.
Github Pages Simplified
Creating a Github Page is easy and quick. But, there is a small caveat.
Take one of the demo repositories in our Github account, Advent Calendar, for example. We have two branches —
gh-pages which share the exact same of code branches.
We need to make sure that the codes in
gh-pages are always synchronized with the
Fortunately, Github has recently made it simpler by removing the
gh-pages branch requirement. We can now instead feed the site directly through the
To do so, go to any of your Github repository Settings screen. Scroll down to the Github Pages section and select the master branch menu from the selection.
You are all set and can safely remove the
gh-pages branch from the repository.