8 steps to publishing your portfolio on GitHub

Requirements to host your portfolio using GitHub

  1. Have a GitHub account.
  2. Have knowledge on how to use Git and GitHub.
  3. Understand how GitHub-pages work- Free hosting as well though this is not mandatory.
  4. A website theme- Bootstrap theme or an HTML/CSS template but NOT a WordPress theme. Some of the recommended sources for the themes are listed below.

The 8 steps

5. Login to your GitHub account or create one if you don’t have any.

  1. Create a new repository named username.github.io. For instance, if your GitHub username is brianmwevi, then your repository name would be atdilshan.github.io and GitHub pages will automatically take this to be your homepage. Add a description if any and click on ‘Create repository’.
  2. Navigate to Start Bootstrap, Bootstrap Zero, Luis Zuno’s blog, Themezy, Bootstrapmade or any other place where you can download a quick portfolio template.
  1. Create a directory/folder where you want to manage your site.
  2. After doing so, launch your terminal/command prompt and clone your remote/online repository to your local machine (in the directory that you created) by running the following command;
git clone https://github.com/atdilshan/atdilshan.github.io
git add -Agit commit -m “Initial Commit”git push origin master

Things to note

  • If you are deploying to GitHub pages for the first time, you may need to wait for 10–15 minutes before you see the actual site.
  • You can also set up a custom domain if you want to. Say: that will be redirected to your GitHub hosted page.
  • Whenever you would like to make changes to your created portfolio repository, make them locally and push the modifications to your remote repository using the commands in step 7. DO NOT make the changes directly to the pages.
  • You can also make your own Blog on GitHub using Jekyll themes.



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
AT Dilshan

AT Dilshan

Hi! My Name is Antony Thevathas Dilshan. I am 20 years old. I ‘m a IT Enthusiast. I believe in helping people with my abilities and knowledge. PLEASE FOLLOW ME!