This is your brain. This is your brain on computers.

Using GitHub to Build a Portfolio (2022 Ultimate Guide)

If you’re in school, fresh out of school with a brand-new diploma, self teaching yourself programming, or looking for ways to change your career path, one of the single best ways to get yourself noticed is through a portfolio of your work. Over time, through school assignments, coursework, and your own personal projects, you can amass a collection of projects to show off in your portfolio. Fortunately, using a platform like GitHub to build a portfolio is free, easy, and teaches you critical skills that you can apply for yourself and an eventual employer.

GitHub is a distributed service that allows for remote Git repositories. This enables you to host your repositories in an environment that allows you to share your code with the public and allows others to contribute to your project in parallel.

There’s no sense in hiding what you know and what you’ve built just because you don’t think you or your projects aren’t “good enough.” Imposter syndrome can be a tough thing to break through.

We’ve personally interviewed hundreds of candidates and are continuously impressed by people who come prepared to discuss (and show off) projects they maintain in a public platform like GitHub. Even better, some candidates spice up the presentation of the projects by using specific web pages to describe what the project is, how to use it, and why it exists.

Not only does a public portfolio give you some much-needed ammunition during an interviewing process, but it also gives you experience with tools that are used in the real world and just might get you noticed by others in the community. There’s literally no downside. You gain real world skills, help yourself during the job hunt, and have the potential to join teams in the open source world.

And all of that is completely free. Just do it.

Install & Learn Git

As is implied in its name, GitHub requires the use of Git.

Git works natively on Windows, Mac, and Linux. When using Windows, you’ll most likely be using the tools included in the Git for Windows initiative (Git BASH, Git GUI, and Git Shell Integration). Mac and Linux have native command line support.

To get started, go download Git by finding the link for your operating system.

For example, with Ubuntu, you’d use: apt install git. You might need to augment this with sudo if your setup requires root to install software.

Note that Git is, by default, purely a command line tool. If you’re interested in using a user interface to manage your Git repositories, check out our tooling guide for some suggestions or our massive Visual Studio + Git guide. You can also check out the official Git GUI page.

The rest of this guide assumes that you’re on Windows, but the process is identical regardless of your operating system.

Don’t know how to use Git? Take a look at our Getting Started with Git guide so that you’re set up for success and ready to contribute to projects with confidence.

Save Your Assignments & Coursework

Remember all those weird programming assignments that you had to finish during your classes? Maybe you had to write a binary search algorithm or a basic version of a text-based poker game. You probably didn’t think you would ever need them again. Don’t throw away your previous work just because it was annoying and barely finished the night before it was due (apologies to any non-procrastinators out there).

What about the code you wrote and projects you finished while going through Khan Academy, Coursera, and Pluralsight?

Maybe you’ve completed our multiple guides to becoming a software engineer without a degree and want to save everything you created during that process.

Having previous projects that you or a team completed can work as filler for your portfolio. It might not be the highest quality work, but it does at least prove that you have some academic experience, understand the basics of source control (using GitHub requires that), and care enough to publish your previous work publicly.

In short, find all your old coursework, create locally Git repositories, and commit them.

Start Experimenting

Don’t have any coursework or don’t have enough to fill out a portfolio? No problem. After all, having a degree is not a requirement to become a software developer.

Go complete our guide to becoming a software developer first. Then come back here and start building more personal projects on top of the ones suggested in that article. In fact, you should probably build more even if you have a lot of school assignments in your collection.

A big part of the satisfaction behind software development is the knowledge that you created something. Not only do you get something that you can call your own, but you also gain critical skills related to problem solving and thought experiments.

Hands on experience is almost always the best way to improve your skills. Academic knowledge can get you started, but having something physical (or in this case, digital) to touch, feel, and manipulate gives you real world experience and an eventual sense of accomplishment when you release your product to the world.

Did you know?

Software engineering is more than just programming. You need to understand the best practices around your project’s source control, build/release process and cadence, project management, team collaboration, and testing strategies. These are skills that are rarely discussed during the completion of Computer Science and Information Technology degrees. Often the only way to obtain them is through self learning.

Start by checking out our big list of the best programming tools that every developer should get to know. We don’t suggest you install every tool on that list, but it’s good to keep the list in your back pocket throughout your journey. Remember to customize your workspace and download productivity-boosting extensions for your development environment.

Like any old coursework that you have, track and commit each of these projects to Git.

Begin With Small Projects

Keep your first experiments small. You don’t have to be stuck with “Hello World,” but you also shouldn’t immediately try to create the next billion dollar application. Don’t abandon projects mid-stream unless absolutely necessary. You should see every project through to the finish or, at the very least, to a point where it appears finished.

Of course, you have to define what “finished” means to you and to that specific project. You’ll quickly learn that many applications are never truly finished. You make something “good enough”, ship it, and move on.

Try making a list of simple games to create. Keep it text-based. Don’t jump directly to graphical games. It’s amazing how many fundamentals can be reinforced in something like Poker, Blackjack, or Dungeon Crawlers.

Build a Simple Website

Basic, static websites are extremely easy to build. You’re not looking to make the next Facebook. All you need to do is prove that you understand the fundamentals of HTML, CSS, and maybe some basic JavaScript. You don’t need anything other than a basic text editor and modern browser to get started.

Create an index.html file to play around. Think back to the classes you took in college or on Khan Academy, Coursera, and Pluralsight. Don’t feel bad if you have to reference those materials again. Software development is a constant struggle between remembering esoteric syntax and reading through documentation.

Start with something like this:

<!DOCTYPE html>
    <h1>A Heading</h1>
    <p>A paragraph with some text</p>

Yes, that’s not a very flashy layout, but that isn’t the point. Just getting your hands on the keyboard, typing something out, and seeing the result of it is positive.

Try to think and build incrementally. It’s fine to have a long term vision for your project, but it isn’t possible to build the end state immediately. You’re going one header, paragraph, and image at a time. Eventually you’ll have something really cool.

Work through tutorials online. Reference back to the courses you completed (you did complete them, didn’t you?). You’re on a roll.

Play with .NET Core

Websites are fun to build, but sometimes building them doesn’t feel like you’re programming.

Fortunately, the barrier to entry to use compiled languages has been drastically lowered in the last couple of decades. Software development kits (SDK) have progressed to the point where everything is packaged up conveniently for you to get started.

Microsoft has an awesome cross-platform (Windows, Linux, Mac) framework that you can use to learn C#, Visual Studio, and Visual Studio Code. We recommend you work through the C# sections of Pluralsight shown in the previous sections. You can also use this time to see if you like the built-in Visual Studio + Git interface. Some people prefer it over the command line.

Start by downloading the .NET Core SDK. As of this writing, the current version is 3.1.101. Microsoft regularly updates this, so make sure to check back and get the latest updates. If you’re using Visual Studio, its own automatic updates may also bring in dependencies like .NET Core automatically.

Microsoft website to download .NET Core SDK.

Spin up your first console application to play in. Treat this as a sandbox and don’t be afraid of trashing it. Again, you’re just experimenting.

$ cd <my_project_directory>
$ dotnet new console -o HelloWorld
$ dotnet run
Hello World!

That’s your first C#/.NET application. OK, so you didn’t do much, but that’s just the beginning. Now it’s your turn to start playing around. As mentioned before, you don’t need any fancy development environments yet. When you feel that you’ve outgrown Notepad (and that will happen quickly), check out Notepad++, Visual Studio and Visual Studio Code.

Remember, you’re building incrementally. The whole point is to get your fingers going and your mind flowing. Eventually you’ll have a collection of projects to present on your portfolio.

Push Repositories to GitHub

This is the fun part. That’s not to say that everything leading up to this moment wasn’t also fun but now you get to show your skills to the rest of the world.

Create an Account

Good news. GitHub can be free to use. We say “can” instead of “is” because there are many types of plans offered, and some of those plans require monthly payments. Fortunately, for you as a hobbyist, you don’t need to pay.

Create an account on GitHub and start with a free plan to get enough features on your path towards a successful public profile.

Set Up Your Profile

It’s not enough to just create your account. You have to advertise, sell, and brag about yourself. You don’t have to give away the keys to your house, but it does help to make a profile with some basic descriptions of yourself and your related work.

With that said, go to your profile page to get started.

Profile Details

Find an interesting profile avatar that will be used across GitHub when you contribute to repositories. It doesn’t have to be a picture of yourself. The author of the profile below is a big fan of Metal Gear, so that explains the example profile picture.

Fill out your bio to talk about who you are, what you primarily work on, and where you currently work (if any). Just have fun with it Brag about yourself. You can also link other users and organizations on GitHub with which you might be affiliated.

If you have a website that you want to direct viewers to such as a StackOverflow profile, a résumé, or just a personal site that you’ve built for yourself, place that in the profile URL box.

GitHub profile page describing bio/URL to enter.

Private Contributions and Job Notifications

Don’t move on yet. There’s more near the bottom of the main profile screen.

Click to enable “Include private contributions on my profile.” As it describes, this will allow your activity feed to show private activity as well as public. You definitely don’t want to be penalized because you mainly contribute to private repositories. We strongly suggest that you make all of your repositories public unless that absolutely isn’t an option.

If you’re in the job market or just want to keep yourself open to opportunities, check the box to make yourself “Available for hire.” When you check various sections of GitHub, you’ll see job placement advertisements relevant to you.

GitHub profile page highlighting options to select

Profile Notifications

With your main profile out of the way, move on to the “Notifications” tab. This is where you control all the ways in which you can be notified of activity happening on GitHub.

When you start getting more active in GitHub, it’s important to stay on top of anything that may directly affect you.

Maybe someone is asking for your help with using your project. Or maybe you’ve left a comment on another repository and someone is responding to you. Regardless, staying engaged increases the chances of people liking your contributions and following your future progress.

While the notifications settings is largely up to you and your discretion, we suggest the following at a minimum:

  • Email, web, and mobile notifications for anything in which you’re “Participating”
  • Email, web, and mobile notifications for anything you’re “Watching”
  • Email notifications for comments on issue and pull requests
  • Email notifications for pull request reviews and pushes

Experiment with which type and level of notifications works for you and your projects. Again, this is up to you. The trick is to stay engaged regardless of how you’re notified.

GitHub notifications UI showing opt-ins.
GitHub notifications UI showing opt-ins.

There are a lot of other settings in your profile that you can play with. Many of them are related to security, billing, and other non-engagement related configurations. Take your time to look through everything in case you see something that piques your interest.

Create a Repository

OK, your profile is good to go. Now it’s time to get your code out there.

Click the + symbol in the upper right after logging in to GitHub. Click New repository.

GitHub create repository selection

Repository Name

First, you obviously need to name your repository. You can change the name later if you end up changing your mind in the future. After renaming, GitHub does redirect requests from the old to the new name. But to reduce confusion, you should update all your remotes in your local repositories.

GitHub create new repository name

Repository Description

Next, you need to add a good description of your repository. While GitHub does mark it as optional, we consider it to be required. This is mainly because a good description goes a long way to building interest, traction, and eventual collaboration in your projects.

GitHub create new repository description

Public or Private?

Always mark your repositories as public unless you absolutely can’t because of proprietary information. If it’s private, no one can see or contribute to it.

GitHub create new public repository

Create README, gitignore, and License

Initialize a README file unless you already have one in your local repository project. You can design the README using markdown. Don’t skip this step even if you’re feeling lazy. Like a good description, a README is critical to gaining traction in your project.

While you may know everything there is to know about your code, keep in mind that strangers have never seen your project and will have no idea where to get started. The README file can explain to people why the repository was created, where to get dependencies, how to build the project, how to use the code, and how they can contribute properly.

Optionally select from a list of prebuilt .gitignore files based on your project specifics.

We suggest you select a permissive license so that others can take what you’ve built and build upon it without having to worry about legal issues. Obviously this is entirely dependent on your project and its stakeholders. But if you have any say over it, more permissions usually equals more use.

GitHub create repository to select readme and license file

Social Share Image

Social media is unavoidable if you want to share something on the Internet. And since the point of this guide is to share your projects, at some point you’ll have to use social media. Fortunately, GitHub has a feature to choose an image for your repository to display when sharing links to it on something like Facebook or Twitter.

GitHub social preview example

Enable Wikis and Issues

In your repository, click the Settings tab in the upper right. You’ll need to make sure certain features are turned on for your repository.

First, enable “Wikis” to promote crowdsourcing of your documentation. You can obviously start the documentation by creating a good README with supporting articles built up over time. You should also let others edit and contribute to the wiki.

Next, enable “Issues”. There’s really no reason to disable this. You can use it to track problems that you want to tackle in your project. Others can use it to report problems they’ve found while trying to use your code. Unfortunately, many people abuse this system by using it like a forum to ask a question or have a discussion. But as the owner of the repository, you can clean that right up.