It's more fun to make web pages when we can show them off to our friends. There are a lot of ways to put our pages online. One of the easiest is to utilize GitHub Pages to automatically deploy our projects online for free.
First, make sure to have a GitHub account set up. The awesome thing about GitHub pages is that you get one main site per account and as many project pages as you would like. That means that when you are ready to create a portfolio of all of your coding work, you can have a main page all about you and a page for each of your coding projects that you do here at Epicodus or at home!
A quick note about structuring projects before we begin. When we start a new project, it is a good idea to create a folder to hold the HTML file and the
img folders. So far, we have been using a descriptive name for our HTML file, such as
my-first-webpage.html. Often, though, you'll want to give the descriptive name for your folder, and name the web page's main HTML file
index.html. As we start to add pages to our web site, the
index.html file will serve as the home page of our site.
For this lesson, we will be putting our
favorite-things.html file on GitHub Pages. Let’s go in the Terminal to our
my-first-webpage project folder.
$ mv favorite-things.html index.html
mv command in the Terminal moves the content of the
favorite-things.html file into a new file called
Now that we've made this change, let's commit this new change and push it to GitHub.
$ git status $ git add . $ git commit -m "Change name of favorite-things.html file to index.html." $ git push origin main
In order for GitHub Pages to work, we need to create a branch called
First we will create the new branch and switch into it by running the commands:
$ git branch gh-pages $ git checkout gh-pages
Now that we are in the
gh-pages branch, let's push this new branch to GitHub:
$ git push origin gh-pages
Now our project should be available for viewing at my-github-username.github.io/repository-name. So, for instance, if our GitHub username was sample-epicodus-student, and our repository was named
my-first-webpage we would navigate to sample-epicodus-student.github.io/my-first-webpage. Check out the URL that corresponds with your GitHub username and repository name (Note: Repository names are case-sensitive, use the same capitalization pattern as you did when naming the repo!)
You can also set up the GitHub Pages webpage for your project in the browser by going to your project's repository, clicking the branch drop down on the left, typing
gh-pages and selecting
Create branch: gh-pages. Done!
Note that if you make further changes to your project, you should do so on your
main branch rather than on your
gh-pages branch. To get back to your main branch,
git checkout main. We'll learn in the future about merging branches, but for now the easiest way to update your
gh-pages branch is to delete it on GitHub and then recreate it based on the updated main branch.
You can also check out GitHub's documentation on deploying to GitHub pages. You'll see it's very simple.
Alternatively, there is an option to deploy to GitHub Pages through a repository's settings. We recommend sticking with the approach covered in this lesson, which also gives you additional practice working with the terminal and pushing and committing code.
After you've finished your project, you can create a
gh-pages branch either locally or on GitHub to allow your project to be viewable at my-github-username.github.io/repository-name
To create a
gh-pages branch locally and then push to GitHub:
$ git branch gh-pages $ git checkout gh-pages $ git push [remote nickname] gh-pages
To create a
gh-pages branch from GitHub:
Create branch: gh-pages