Why Your GitHub Profile Sucks?
Tags: github, tips, profile, design
Published: 2021-02-03 17:20:05

After going through many GitHub profiles, I noticed that **most of them are not really appealing**. In this article, I will give you some pro tips to enhance yours.

---

As of January 2020, [GitHub](https://github.com) reports having more than **40 million users**. In order to stand out from the crowd, your profile should be unique and reflect your own identity.

Here are the reasons why your GitHub profile might be boring.


# Reason #1: You Don't Have A Profile Picture

Yes, we're starting with the simplest and the most obvious one, but you **must** have a profile picture. It can be either a picture or you, an avatar that looks like you, or even just a logo or a background, but it needs to reflect your identity in some way. People should be able to recognize your profile only by your profile picture.

Here's one of the GitHub default profile pictures:
![](https://cdn-images-1.medium.com/max/1000/1*P0hlfc1JnHRRSdayQcAIhg.png)

> 🤮 Not appealing at all...

Let's consider my case. My profile picture is a [memoji](https://www.pocket-lint.com/phones/news/apple/144743-what-are-memoji-how-to-create-an-animoji-that-looks-like-you) that looks like me. This means that it is (almost) unique, and it reflects my own identity.

![](https://i.imgur.com/q4Rdj5I.png)

I really encourage you finding a profile picture that will make your profile unique too.


# Reason #2: Your Profile Is Incomplete

GitHub, such as many other famous social networks, allows you to fill in some information about you. This **doesn’t mean** that you have to share your phone number or your address, but again, you need to have an identity.

What can you put on your profile?

- A short biography
- Your work place
- Where you are from
- A link to any website
- Your Twitter username

> 💡 The more information you fill in, the better.

Now, if you think that some of these points are personal, I totally agree with you. And you don’t necessarily have to fill them all.

Nevertheless, when people are browsing your profile, they must be able to know the main stuff about you. Your profile has to **draw out** what you are interested in, some of your recent projects, possibly a link to your personal website —  or if you don’t have one, to your LinkedIn profile.

> 💡 Also, don’t hesitate to include emojis in your biography. This way, your presentation will grab the users’ attention by creating some anchor points. But beware not to overuse them though. 

We can consider my case once more, but also some of other presentations that caught my attention.

![](https://miro.medium.com/max/875/1*KS4cxsqIQnuzG3e78l2rOQ.png)

Your profile is getting on fire, congratulations! 🎉

# Reason #3: You Don’t Have A Profile Presentation

> 🤨 Uh? Ludal, we just added a profile presentation in the previous part, what are you saying?

Yes, you're right! However, you might have noticed that the maximal length for your biography is actually quite short: 160 characters.

This is why in July 2020, GitHub secretly released a new feature: **profile READMEs**.

It allows you to add a fully detailed presentation to your profile page, using the [Markdown](https://en.wikipedia.org/wiki/Markdown) syntax. This is the perfect place to detail whatever technologies you use, what you are currently working on, additional contact information, etc.

Here's an example of what it can look like:

![](https://miro.medium.com/max/875/1*iCDuKOlaKuvLxgf2Z37mxA.png)

This tip really gives your profile an incredible boost, making it even more different and personal.

> 🤔 Now, how do you add this to your profile?

In fact, the steps are ridiculously easy: just head over to [GitHub](https://github.com), and create a new repository with the same name as your username.

![](https://miro.medium.com/max/875/1*0qBY5IJRvOorJq1QOmcjgA.png)

As you can see, this small paragraph comes in, saying that you just discovered a special repository. *Yee-haw!*

Now, you just need to add a file named `README.md` at the root of this repository and add whatever you want people to know about you — obviously, using the Markdown syntax.

Here are a few (subjective) tips for an awesome profile prensentation:

1. **Add emojis**, but don't overuse them.
2. **Structure it**, with some titles, and why not subtitles.
3. **Add GIFs or images** — don't abuse them either.
4. **Add special elements**, such as you [profile stats](https://github.com/anuraghazra/github-readme-stats) or [icons](https://devicon.dev/).
5. **Stay consistent** — for instance, if you decide to include an emoji before a title, do it for *every* title, or do not.

But what if you're not inspired? Well, there are some great repositories such as [this one](https://github.com/elangosundar/awesome-README-templates) or [this one](https://github.com/kautukkundan/Awesome-Profile-README-templates), which contains some templates made by other people, that you can freely download and reuse. Then you just have to change their content to make them yours.

> 💡 **Pro tip**: Don't hesitate to browse several templates and take the parts you like in either of them. Then, simply merge those parts together in order to get your own and unique presentation!

Also, if you're not familiar at all with the Markdown syntax, you can either use [this cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) for a full reference, or even use websites such as [this one](https://profilinator.rishav.dev/) that allow you to generate some dope presentations without having to write a single line of Markdown.

![](https://miro.medium.com/max/875/1*VoTOuZc4iyf3n4valfEV8w.png)


# Reason #4: You're Not Interacting With Others

GitHub on its own is kind of a social network, as it allows you to follow people, star other ones' projects, etc.

This is why you **must** show everyone that you actually **exist**!

![](https://media.giphy.com/media/ieebdd3BJxd3aqPc5p/giphy.gif)

To do so, you only need to follow users and star projects. As simple as that.

Indeed, star projects you’re interested in. **Don’t star thousands of projects just to star them.** The same applies for people you will follow.

And as you now have an awesome profile, with — I’m pretty sure — wonderful projects on it, they might follow you back and/or star one (or more) of your projects!

# Reason #5: You Don’t Have Any Pinned Projects

Last but not least, here’s another small trick.

You can actually pin **up to 6 projects**, which will be displayed directly on your profile’s public page.

How to do so? Again, it's trivial. Just head over to your profile’s public page (which is `github.com/your-username`) and scroll down until you reach the *“Pinned”* section. From here, just click the *“Customize your pins”* button on the right side, and select your most relevant projects.

I would personally recommend using an **even** number of projects to pin, so that they are displayed symmetrically — which is nicer than having a trailing blank.

Here’s the result:

![](https://miro.medium.com/max/875/1*Z_JKOmoAMRP9cKCckudKdQ.png)

# Conclusion

Now that you have applied all the steps above, here’s how the final result might look like:

![](https://miro.medium.com/max/875/1*6GA0b_kCw3Jvb0Xdwzh6BA.png)

Thanks (and congratulations) for reading me all the way through. You now have a fully customized GitHub profile that really stands out from the crowd, and most importantly, that reflects your own identity. 🎉

If you enjoyed these tricks or if you have other ones to share, **don’t hesitate to let me know in the comments!**