DEV Community

Cover image for 5 Tricks to Create an Impressive GitHub Repository 🤩🤯
Tapajyoti Bose
Tapajyoti Bose

Posted on • Updated on

5 Tricks to Create an Impressive GitHub Repository 🤩🤯

Want to hook users up to your GitHub repository? Want GitHub to promote your repository? Want users to come back to your repository again, and again?

If you answered YES to all the questions, you have come to the right place, my disciple. In this article, we will be going over how to create an impressive GitHub repository that hooks users!

wow

1. Add Description (with Emojis & Link)

This is the lowest hanging fruit in creating an impressive GitHub repository. You can just add a short description of the repository to heighten its appeal. Make sure to throw in some emojis too 😉.

You also get extra brownie points 🎂 for adding relevant links too!

description

You can update the description and the link from the top right settings icon

configure

2. Add Tags

Adding tags is the next and most crucial step in this article. It not only makes it easier for GitHub to promote the repository but also makes it look much more professional!

tags

Tag related settings are also available in the repository configuration shown in the previous step

3. Add License

No point denying it, this is the most boring step, but essential for fair use of the repository. Moreover, it also shows up in the info tab, so just get it done with.

info

To add a License, create a file called LICENSE at the root of the project.

4. Add Readme

The ReadMe is the first thing a visitor sees when they visit the repository, so taking some time to create a polished repository is crucial. It should describe what problem the code solves, how to set it up, and any other relevant information.

readme

There is always some way to make the ReadMe engaging. Even if you don't have much to write about the repository itself. Take the example of a repository containing coding problem solutions. You can easily list out the problems in the ReadMe and link to the solutions.

coding-problems-readme

To add a ReadMe, create a ReadMe.md file at the root of the project.

5. Use Descriptive Commit Messages

Using descriptive commit messages might look like a chore, but it too helps in taking the appeal of the repository higher. Make sure the commit message is explanatory.

There are various schools of commit message structures, any of which is acceptable. I personally like the following one:

<type>[optional scope]: <description>
Enter fullscreen mode Exit fullscreen mode

If you want to dive deeper into how it is structured, check out this article

commits

6. BONUS: Use Multiple Languages

Using multiple languages in your repository is a great way to grab the user's attention, but this is highly context-dependent. You should NOT use multiple languages only to increase the appeal, but only if it is required.

multiple-languages

Even if you falter in this department, as long as you implement the other tricks, you are completely covered!

Repositories used

GitHub logo ruppysuppy / Daily-Coding-Problem-Solutions

🎓🖥️ Solutions for 350+ Interview Questions asked at FAANG and other top tech companies

GitHub logo ruppysuppy / Crypto-Crowdfund

🤑💰 Crowdfunding Platform backed by Ethereum Blockchain to bring your creative projects to life

GitHub logo ruppysuppy / SmartsApp

💬📱 An End to End Encrypted Cross Platform messenger app.

GitHub logo mui / material-ui

MUI Core (formerly Material-UI) is the React UI library you always wanted. Follow your own design system, or start with Material Design.

Research says, writing down your goals on pen & paper makes you 21% to 39% more likely to achieve them. Check out these notebooks and journals to make the journey of achieving your dreams easier: https://www.amazon.com/Tapajyoti-Bose/e/B09VGDDHRR

Thanks for reading

Need a Top Rated Front-End Development Freelancer to chop away your development woes? Contact me on Upwork

Want to see what I am working on? Check out my Personal Website and GitHub

Want to connect? Reach out to me on LinkedIn

I am a freelancer who will start off as a Digital Nomad in mid-2022. Want to catch the journey? Follow me on Instagram

Follow my blogs for Weekly new Tidbits on Dev

FAQ

These are a few commonly asked questions I get. So, I hope this FAQ section solves your issues.

  1. I am a beginner, how should I learn Front-End Web Dev?
    Look into the following articles:

    1. Front End Development Roadmap
    2. Front End Project Ideas

Discussion (0)