The Beginners Guide to Github Pages

The Beginners Guide to Github Pages

All developers know Github as service that enables code sharing and also helps you improve your code by using version control.

However, did you know that Github also offers Github Pages, a completely free hosting service?

In this tutorial, I’ll show you how to host a simple HTML website for free using Github.

Step #1. Create a Github account

You will need a Github account. For more details please go to and signup. It will take just a few seconds.

Step #2. Create a repository

Go to your profile page. Your URL will look like this:

  1. Click on the Repositories tab
  2. Click New
github pages

You’re going to create a new repository. The repository name should follow this pattern:

In my example, I’m using htmgarcia as my username

github pages
  • Click the Create repository button.

Step #3. Create the home page

Now let’s go to your new repository. Starting from your profile:

  1. Click the Repositories tab
  2. Click your repository name
github pages
  • Find the plus sign (+) and click it to create a new file.
github pages

On this new screen, you have two things to do:

github pages
  • When you are done, scroll down and click the Commit new file button
github pages

Step #4. Check the result

In your browser type to see the end result. In this example I’m using and this really example will only display a “hello world!” header.

It’s as easy as that. You can now add free pages using Github’s free hosting.

github page publushed to the web


  • Valentin Garcia

    Valentin discovered Joomla in 2010, and since then he has considered it as the best CMS. Valentin has been coding extensions and templates for Joomla for many years and truly enjoys helping people build their own websites with Open Source tools. He lives in San Julián, Jalisco, México.

0 0 votes
Article Rating
Notify of

1 Comment
Newest Most Voted
Inline Feedbacks
View all comments
9 years ago

seems great for a “static” html page, but what about something more complex like a CMS

Would love your thoughts, please comment.x