DEV Community


Posted on • Updated on

Setting up your Github Profile as your portfolio

The job market in its current state is highly saturated, competitive, and becomes a numbers game, especially for entry level/new-grad positions. While this is mostly the case all year round, it is further amplified for now due to the pandemic.

There are clearly a lot of variables at play here, and well... time is of the essence!

As developers, we try to optimize things for efficiency/time/space. Similarly, the job-search process becomes increasingly difficult where you need to manage your time accordingly on the things you want to focus on for your betterment, while maximizing your chances of landing a new role.

I remember when I was applying for my first job in the field, I spent so much time and emphasis into creating an online portfolio website in order to highlight my skills and projects; to have my own "corner" in the interwebs dedicated to myself.

However, in hindsight, I probably would not have spent as much time on it, instead focusing on optimizing my resume, or picking up other technical/marketable skills.

Here's a bit from The Coding Career Handbook, by swyx (which I highly recommend, btw) that puts it perfectly:

You don’t need an all singing, all dancing portfolio page. You don’t need a verdant green commit history. People barely look at that. They don’t have time. You just have to demonstrate that you’ve Done Cool Shit and, optionally, Covered Your Bases. It’s more about instantly verifiable Proof of Work.

NOTE: the exception here is if your work is visual in nature such as UI/UX, front-end etc. You should definitely have an online portfolio if that's the case. If not a custom one, then at the very least, put some work up on sites like Dribbble, Behance etc.

Now, with the "proof of work" concept, what I do know is that most developers SHOULD have a Github/Gitlab/Bitbucket etc. account where some of their code/work is posted publicly for potential recruiters and employers to see.

I know some employers might skip looking at that as well, but I find that to be a perfectly reasonable tradeoff given most us should already be using some sort of version control by default.

There's 0 additional cost - in terms of your time and resources spent to set things up, as opposed to having a full-blown website in a fancy framework documenting your accomplishments.

Enter: Github's Special

Github launched a new feature not too long ago involving special repositories, where the will not just show up in the repository itself, but also on top as part of your main profile!

Alt Text

We've had ample time to discover what could be done with such a feature, and, needless to say, there are numerous integrations thus far with varying range of customizability available at our disposal.

Check out these resources to set up something cool for yourself:

With the above in mind, I wanted to share my own take on having such a Github profile, which is set-up as my de-facto portfolio page which you can visit at to see for yourself!

Alt Text

NOTE: I use a plug-in for Chrome called Dark Reader which pretty much simulates dark-mode for every website out there

I accomplished this by leveraging Octokit to communicate with the Github APIs and updating content like gists, in combination with using CircleCI to set up cron jobs that will constantly update content with new data. This is put together with the public profile to create a profile page which contains:

  • relevant links and descriptions about myself,
  • dynamically updating info about my physical activity from Strava - repo,
  • dynamically updating info about my recent listening trends from Spotify - repo,
  • dynamically updating info about what languages I've been working with in the last few days - repo.

These repos are my fine-tuned/modified forks of the originals which have updated settings that just work out of the box vs the initial tampering I had to do with some of them to get them working.

They contain explanations to get you setup with your own versions, but feel free to look through the code, provide feedback/suggestions, and fork them further and customize as per your needs!

You can also reach out to me if you need help setting them up for your own profile. I'm active on discord where you can find me as kan#0979.

Lastly, I'd love to know your opinions/stories/outcomes of having a personal portfolio and how much importance you personally give to that aspect of the job-application process. What helped you most in landing a job? Also, feel free to share your own Github Profile if you have one, so I can check them out and feel inspired further!

Thanks for reading!

Top comments (6)

mathewthe2 profile image
Mathew Chan

Love your creativity with Github! I think the most important thing is to have good projects and regular commits!

chakrakan profile image

Thank you!

I agree! Having projects which take off + meaningful open source contributions are a sure shot way to get noticed, which can convert into employment opportunities, or even your own startup!

mathewthe2 profile image
Mathew Chan

Talking about contribution, there are very meaningful conversations in issues and I feel strongly there should be a way to showcase your contribution of solving repo issues without having to be manually added as a contributor to the repo.

reg__ profile image
Adam Sawicki

I didn't know about this feature of GitHub to make README for my entire profile. Very useful. Thank you for this post!

chakrakan profile image

Thanks Adam! :)

I myself only came to know of it not too long ago as a notification from github! Since then, many have come up with some amazing ideas! Personally, I like to keep things minimal but feel free to check out those awesome-readme repos for inspiration and some amazing templates!

heisdev profile image

Do check this project out GitHub Dynamic Quote for Profile Readme