DEV Community

Cover image for How to Create an Impressive GitHub Profile
Ekaterine Mitagvaria
Ekaterine Mitagvaria

Posted on • Edited on • Originally published at Medium

9 1 1 1

How to Create an Impressive GitHub Profile

If you have joined GitHub recently I am sure you have noticed some really awesome profiles that grab your attention you had the desire to have such an awesome profile yourself!

Having an impressive GitHub profile is vital not only because you think it’s awesome or to get some attention from fellow developers but it can potentially help you to stand out when you start your job hunt as a junior developer!

Reasons to have an impressive GitHub profile

  1. First of all, it is a good way to introduce yourself to potential visitors. If you are shy, don’t worry, you don’t have to share your private life! Potential visitors can be other developers who might want to collaborate with you or recruiters who want to check your projects.
  2. Secondly, it’s a way to create a small summary of your projects, what you are working on, what you have done, and so on. When someone visits your profile, they are not going to go through all your repositories to understand what you are up to.
  3. Besides the summary, you can also highlight the most important project you have done and are proud of. If you have done many small projects recently but you have some awesome big projects which you have not edited recently, they might end up at the end of the list and the visitor will never see them.
  4. Finally, it’s a great way to not only show your skills but describe them. You can include things like what languages you use, what you enjoy or are learning, share your social media, and on.

To summarize, your GitHub profile is almost like a resume but where you can control the style and the design. Resumes have some standards and are more professional when with a GitHub profile you can open up more and be more creative.

How to create an impressive GitHub profile?

To start styling your GitHub profile, you need to create a repository with the exact username as on GitHub and create a special file which is called README.

  1. Go to your profile ⏭️ Repositories tab ⏭️ Click the New button ⏭️ Name your repository exactly the same name as your GitHub username.
  2. Create a file name README.md by selecting either a checkbox called “Add a README file” while creating a repository (when you write a name for it) or you can add one later by clicking “ include a README” text which will appear at the top once you are done creating the repository.
  3. You can now edit this new README file which will be displayed on your main GitHub profile!
  4. Also, make sure that the repository is set to Public.

Create Github profile README

How to style GitHub profile README?

Once we understand why we need a nice profile and how to create the files, we can now start designing and being creative! In order to start styling however it's important to understand GitHub syntax. Please, read more about GitHub syntax before you start styling, it's very easy.

There are a lot of things you can add to your profile but you can follow some structure.
I have not edited my own profile for a while actually so let’s try to re-create my GitHub profile and compare it to the previous version.
I will create a simple list that you can follow later on.

1️⃣ Introduction

On the first line, we usually start by saying hello to the visitor and introducing our name. Also, when you write your name you can add a link to your name which will redirect to your portfolio.

Github profile README

However, the options are endless. You can also add a banner with the same text and some awesome styles. I think I will use a banner this time! To create a banner you can use different tools online, I am using Canva.

2️⃣ About me

Next, you can add a short about me text to briefly describe yourself or explain what motivates you, what you are working on, and so on. The options are endless and it’s all up to you. Just be yourself but don’t share too personal details, stay professional but not too much! Just try not to copy the exact same from others. I have seen the exact same copy of README on beginner’s README and it’s not a good sign, trust me. Try to add something to yours.
I am going to add my LinkedIn profile description as I like to keep the it same across platforms.

GitHub profile README

3️⃣ Your knowledge

Once you introduced yourself a little bit, you can now share which programming languages you know or you are currently learning. You can create a written text or you can create a list of the programming language icons. I like using icons personally. Instead of trying to search for each image, you can use online tools to find the icons you need, I have been usingDevicon and love it!
I am going to keep the same icons I already had and add some new skills! You can add icons in the image tag to add the width and height and place the same in one tag so they are aligned horizontally.

GitHub profile README

4️⃣ Social media

Next, you can also add your social media links along with the icons if you want people to connect with you on another platform. If you have a blog or anything else you want to share, you can also add everything. However, do not add anything that you never use and it’s all empty. I have seen people adding their blog links but they don’t have a single post. Just like for the programming languages, you can also use icons instead of just text, I think visually it looks really awesome!

GitHub profile README

5️⃣ Styling

Next, you can add some more styling to fill up some empty spaces. When you create a list and you choose to align them vertically, for example, you might have some extra space left. If you align it horizontally though, you can align it to the center. You add some custom images or you can add some gifs for fun! I decided to add some cool gif and align it to the right side, so it fills up some empty space.

GitHub profile README

6️⃣ Statistics

To grab some attention, you can also add some additional statistics widgets to your README. There are different statistics that you can add.

  • Amount of visitors on the profile, which you can generate here.
  • Another awesome stats generator for different things like languages used, total commits, and so on. You can check it out here.
  • Also, you can add streak stats to show how active you are. Check it out here.

Let me add some to my README as well. I am going to add a stats card and then I will also add another GitHub stats for the current streak and other info by using the resources I mentioned earlier.

GitHub profile README

7️⃣ Other details

I decided to create a shorter README however you can add a lot of additional stuff.

  • For example, if you have a blog, you can add your top posts and add links.
  • You can also add your top repositories or your favorite projects with a title, description, preview, and link. However, there is another way you can do this without README which I will explain very soon. You can add custom styling for repositories, check it out here.
  • You can also add some statistics like dev metrics on which days you code the most or what times, check it out here.

You can literally be as creative as you can and do tons of interesting stuff!

I have followed all the steps I have written previously and let’s see what I have as a result!

📛 BEFORE

GitHub profile README Ekaterine Mitagvaria

✅ AFTER

GitHub profile README Ekaterine Mitagvaria

Looks awesome, right? I have just improved my own README using my own guide!

There is much more!!

The GitHub profile is not only the README there are some other details you should add!

1️⃣ Profile details

Make sure to fill out as much as you can in your profile details. It will help your visitors to quickly understand who you are as well as help them to understand when and how to contact you easier!

GitHub profile Ekaterine Mitagvaria

2️⃣ Pinned repositories

Instead of adding highlighted repositories to your README, you can also just pin them however you can pin only 6 of them. It’s a great way to show your top repositories and make them more noticeable than other projects. You can pin and unpin them anytime you want!

Pinned repositories

3️⃣ Repository description

When you create projects and someone visits your repository not everyone is going to start going through each file of each project and check every single file.
At first, they will have a brief look at the project and it is definitely going to be more interesting for them to check it if you have some description of what it is. If you have some tags and you have a website link they will be able to check it out much faster. If you have an app or it’s something only backend and you don’t show any website, for example, at least try to explain in detail what it is so they get interested and want to go further into the details. You have to do a kind of advertisement because your project is showcasing you and your skills.

Repository Description

4️⃣ Repository README

And lastly, a good README is not only important for your profile but also for every single project! First, it’s important for other developers as well who might want to learn from you, to check what you have been using and how. Why? Because they might want to use your project and they might want to know what things you used in the project and what they might need to install to use your project. README is kind of a documentation for your project.
Maybe you are a beginner and you wonder, who even needs my project? If no one is going to use your project, then trust me, your potential employee might check your repository. This person needs to understand what you have done and README can create some basic understanding. Just like profile README introduces you, so does it introduce your project to other non-technical people.
Personally, I usually add a quick description of what it is, what libraries I have added, and maybe what languages I used or what I have learned.

Repository README

Phew, this was a long one! If you spend a little time and effort you can make from an empty and boring GitHub really really impressive profile!

Too lazy?

If you are too lazy to do any of these and don’t enjoy creativity then you can just use standard README generators which will save you a lot of time. These generators are free and awesome people contributed a lot to make it look cool, so it’s not a bad option!

I have not used one ever but there are several ones I have found.

  1. Rahul Jain
  2. GPRM
  3. Profilinator
  4. Arturs Smirnovs

If you have just started using GitHub this is all you need to know to create an impressive GitHub profile!

📌Did you try this out? Show off your changes in the comments!

The Fastest, Most Accurate API for Voice AI

Ad Image

Building an AI Agent that needs to deliver human-like conversations? | Speechmatics’ real-time ASR is available in 50 languages and can understand speech in a fraction of a second.

Try Free

Top comments (0)

Heroku

This site is built on Heroku

Join the ranks of developers at Salesforce, Airbase, DEV, and more who deploy their mission critical applications on Heroku. Sign up today and launch your first app!

Get Started

👋 Kindness is contagious

Engage with a sea of insights in this enlightening article, highly esteemed within the encouraging DEV Community. Programmers of every skill level are invited to participate and enrich our shared knowledge.

A simple "thank you" can uplift someone's spirits. Express your appreciation in the comments section!

On DEV, sharing knowledge smooths our journey and strengthens our community bonds. Found this useful? A brief thank you to the author can mean a lot.

Okay