DEV Community

Alex Jose
Alex Jose

Posted on

Publish your portfolio on GitHub

How portfolios help you?

A portfolio helps working professionals to highlight their best work and display accomplishments, skills and potentials. Portfolios visually showcase examples of work. Portfolios are a great way to demonstrate the competencies you would list on a resume or talk about in an interview - they allow you to show and not just tell. It presents evidence of your relevant skills and abilities.

Why GitHub?

GitHub is a web-based platform for version control using git. It is also where users can collaborate on or adopt open-source projects, fork code, share ideas and more. You can consider GitHub as a website while Git is a tool that keeps track of your files and modifications to those files in a repository. It is easier and free to set-up a GitHub account and host your portfolio using GitHub pages.

Prerequisites:

  • Create a GitHub account
  • Knowledge on how to use Git and GitHub
  • Understand how GitHub-Pages work
  • A Theme for your portfolio. You can use either Bootstrap theme or HTML/CSS template

For quick portfolio template:

How to publish portfolio on GitHub?

  • Login to you GitHub account or create one if you don't have one.
  • Create a new repository named username.github.io. If your GitHub username is alexjose, then your repository name should be alexjose.github.io. Make sure to set your repository as public.
  • Create a folder in your local machine. Eg: Documents/Portfolio. After that, clone your repository by running the following command in git bash:
git clone https://github.com/username/username.github.io.git
Enter fullscreen mode Exit fullscreen mode

Remember to replace the URL with your username.

  • Copy the contents of your downloaded template into the cloned local repository.Make sure that index.html file is at the root of this directory.
  • From git bash change directory into cloned repository:
cd username.github.io
Enter fullscreen mode Exit fullscreen mode
  • Run the following commands to make the push to your remote repository:
git add -A
git commit -m "initial commit"
git push origin master
Enter fullscreen mode Exit fullscreen mode

Whenever you would like to make changes to your created portfolio repository, make them locally and push the modifications to your remote repository.

Top comments (2)

Collapse
 
mihaimyh profile image
Mihai Dumitru

My opinion on this is you should create your own portfolio app and not rely on pre-build templates, like the ones you mentioned.
If you want to impress a future employer, the portfolio app should be something made by you.

Collapse
 
jozalex profile image
Alex Jose

Good point. I was just sharing the steps. It will be always good if you have your own template.