How to create a simple portfolio with GitHub pages
Tags: github, git, beginners
Published: 2019-11-27 10:41:14

One of the ways of scaling up as a developer is building a portfolio. Basically, a portfolio is a way of showcasing work samples and skills stated in your resume.

One of the ways of creating a simple portfolio is using GitHub pages. This is a site hosting service that takes HTML, CSS and JavaScript files directly from a repo on GitHub. The good thing about GitHub pages is the fact that it is free as it supports custom domains, with deploys straight from Git.

 <header> <h1> Getting Started </h1> </header>

  * Make sure you have a [GitHub](https://github.com/) account.
  * Have basic knowledge of how [Git and GitHub](https://product.hubspot.com/blog/git-and-github-tutorial-for-beginners) Works.

<header><h1>Lets do this 💪🏻 </h1></header>

  Login to your [GitHub](https://github.com/) account
 

   
   <header><h2>Creating a project site.</h2></header>
With project sites, you get to use templates downloaded online or pick a theme from the settings on the repository. 
  * create a new repository named _username.github.io_. Say if you name is carolyne, your repository name will be _carolyne.github.io_. This will be your homepage. PS: You can add a description if you like.


* Check out the following websites to download free portfolio website templates from [colorlib](https://colorlib.com/wp/cat/portfolio/), [Start Bootstrap](https://startbootstrap.com/themes/), [Themezy](https://www.themezy.com/), [BootStrap zero](https://www.bootstrapzero.com/) or [Bootstrap made](https://bootstrapmade.com/). You can as well use this link (https://github.com/evanca/quick-portfolio) to create one by forking the repo. 
![](https://github-images.s3.amazonaws.com/help/bootcamp/Bootcamp-Fork.png)

Go to repository Settings and scroll down to the “GitHub Pages” section. Select “master branch” under the “Source”.

Add a theme to the portfolio to changeits look and feel
![](https://help.github.com/assets/images/help/pages/choose-a-theme.png)

Choose the theme you want and then , Select Theme
![](https://help.github.com/assets/images/help/pages/select-theme.png)

You may be asked to edit your site`s README.md file
Your chosen theme will automatically apply to files in your repo.
 
<header><h2>Steps to create personal or organization site</h2></header>

You can work with the repo already created  or create a new one.

<header><h3>Clone the repository.</h3></header>

create a folder where you want to store the project on your desktop and clone the new repository 


```~ $ git clone https://github.com/carolmusyoka18/carolmusyoka18.github.io
```
<header><h3>add index.html file </h3></header> 
You can now create an index.html file in the project folder

```
~ $ cd carolmusyoka18.github.io
~ $ echo "Hello World" > index.html 
```
<header><h3>Push the Repo </h3></header>
 Add commit and push all your changes

```~ $ git add --all

~ $ git commit -m "Initial commit"

~ $ git push -u origin master
```

And you are good to go 😎🎉🎉

Check out your website  https://username.github.io.

 If you are deploying Github pages for the first time, you might need to wait for a while before you see the actual site. If you need to make any change to your portfolio, you can make them locally and push the changes as shown above. It is not advisable to make changes directly on the portfolio.

 You can edit files directly on GitHub in any of your repositories using the file editor, which uses CodeMirror. You can check out this short [tutorial](https://help.github.com/en/github/managing-files-in-a-repository/editing-files-in-your-repository) to get it right

The secret is trying and practicing. With time you will, get pretty good at creating portfolios. Share your thoughts or ideas down below.