Tips to use GitHub as your Portfolio

Hello everyone!

Today I came to talk to you about a topic I love to talk about because it applies to people of all skill levels and any area within technology: How to use GitHub as a Portfolio!

Although it's not mandatory, it's common for recruiters to want to see your GitHub and sometimes also ask for a Portfolio, so why not combine the two?

GitHub is the ideal place because there you can showcase examples of your code, your progress, your studies, and initiatives you've been involved in. In today's article, I'll share some tips on how to do that.

1. Your README

Let's start with the most important part, your homepage on GitHub: The README.

You can use text, graphics, and GIFs to convey your message here. Check out mine:

How to do it?

Firstly, you have to create this file.

• Go to New Repository.
• The name of this new repository has to be your GitHub @.
• If you type it correctly, you'll see this message:

• Check the box for Add a README file if it's not already checked.
• Create the Repository.

Now you have access to this ??special?? repository.

What do I put here?

You can put several things. In mine, I have my Bio, my Skills, Social media, and a list of my 5 most recent articles.

My recommendation is to have at least the bio. Mine is in English, but write in the language most relevant to you!

If you're feeling uninspired, I recommend using this site https://www.profileme.dev/. Here's a template to fill out, and in the end, you'll have access to the .md file, so just copy and paste it into your README.

If you're familiar with markdown and are a creative person, you can make this look nice, like GitHub Star Leticia L. 's Profile , which is simple but lovely:

2. Fill in the Left Column

When you visit a profile on GitHub, even if the person hasn't created the README we talked about above, they have a column on the left with basic information, and it's important that you have this section filled.

I'll use another GitHub Star, Julio Arruda , as an example:

His profile is complete, and you can follow this example by filling in:

• Your name
• The @ is automatic, but now you can add your pronouns here!
• A short bio: Quick stuff, your title, or aspiration. Mine is the same as the Twitter Bio.
• Where you work (or study)
• Country of residence and you can also display your time zone
• Below, you can include all the links you find relevant.
• If you're seeking employment or open to partnerships, I recommend leaving your email here too.
• If the email option doesn't appear here, you'll have to go to Settings > Emails and uncheck the option Keep my email addresses private.
• Now you can go back to your profile, and the option to add your email will appear.

Cool, now you have a fully completed profile column and a neat README! That's the basics, but we can do a little more.

3. "Pinned" Projects

Right below your README, you can "pin" projects, which means highlighting them.

You can choose from 1 to 6 of your projects. Pick the projects you're most proud of! Here, you can see the choices of GitHub Star Erika Heidi :

A tip I give for all repositories, but especially important for those you want to highlight, is to write a short description of the project. Just what the project does and the technology used.

In the example image above, for the MiniCli project, the description is A minimalist framework for command-line applications in PHP.

This is important because this information is visible without the person having to click on the repository to know more. So, when they open the repo, it interests them. This makes it easier for recruiters to look at your profile.

How's your profile?

Well, folks, those are my main tips to make your profile not only attractive but also functional. These tips might seem simple, but in the current competitive market, small things can make a difference in the selection process. Let me know what you have done on your profile!