How to create an awesome coding portfolio and why its useful

Do you want to learn how to build a kickass coding portfolio? In this post you will get an overview on how to setup a github account and host your first projects their.

Why every developer should have an coding portfolio?

  • A portfolio is a way for developers to showcase their work to others, you dont want to miss out on that opportunity.
  • If you are looking for a job a portfolio is better than any resume you can write. As they say a picture speaks more than 1000 words. Check out this post to see what kind of projects recruiters are looking for in a portfolio:
  • A good portfolio will help you build connections and freelancing opportunities (if you choose so)

Why create an portfolio on github?

Github is the most popular hosting site for git repositories. Some of the biggest companies in the world use github. Having a portfolio on github will give you the chance to show your portfolio to millions of other developers. Naturally that makes it the best place to host your projects their. It also shows recruiters that you are familiar with version control systems.

Lets get started

If you dont already have an gitub account go to and create one.

After that go to to start editing your profile information.

Your Github Profile should give a good first impression of you. For that you need to have a professional profile picture and a short bio about yourself.

Your bio should give a short overview of your interessts and skills. If you have a personal website fill out the URL field.

Your code should live on github

If you dont have your projects on github already you should host your code their. Create a new repository or import a repository. If you are not familiar with git you can learn the basics of git here:

Every repository should have a Readme

A good readme should include:

  • A short paragraph about the project itself
  • Necessary prerequisites
  • A guide on how to setup the dev environment
  • How to run tests
  • How to deploy/start the application

You can find a good template here:

Want to read more? Join the newsletter for weekly updates