abhisheknaiidu / awesome-github-profile-readme

😎 A curated list of awesome GitHub Profile READMEs 📝

Awesome GitHub Profile README

A curated list of awesome Github Profile READMEs

Loved the project? Please consider donating to help it improve!

Contents:

• Categories
  • GitHub Actions 🤖
  • Game Mode 🚀
  • Code Mode 👨🏽‍💻
  • Dynamic Realtime 💫
  • A Little Bit of Everything 😃
  • Descriptive 🗒
  • Simple but Innovative Ones 🤗
  • Typing.. Mode 🎰
  • Anime 👾
  • Minimalistic ✨
  • GIFS 👻
  • Just Images 🎭
  • Badges 🎫
  • Fancy Fonts 🖋
  • Icons 🎯
  • Retro 😎
• Tools
• Articles
• Video Tutorials
• Contribute
• License

Categories

GitHub Actions 🤖

• Abhishek Naidu
• Thomas Guibert
• Brian Douglas
• Shawn Wang
• Simon Willison
• Mike Coutermarsh
• Michael Hoffmann (Mokkapps)
• Athul Cyriac Ajay
• Gautam Krishna R
• Roald Nefs
• Leo
• Dhruv Jain
• Erwin Lejeune
• Jessica Lim
• 侑夕-Tw93
• liununu
• Filippo Rossi (qu4k)
• Moe Poi ~
• Elon Tang (blackcater)
• Stanley Lim (Spiderpig86)
• Akshit Garg (gargakshit)
• Yufan You
• Danny Koppenhagen
• Vidya Bhandary
• Rao Hai
• Jatin Rao
• teoxoy
• Aral Roca
• codeSTACKr
• itgoyo
• lifeparticle

Game Mode 🚀

• Tim Burgan
• Ben Sampica
• Kavish Hukmani
• Jonathan Gin
• Ross Williams
• kylepls
• Aaron Liu
• marcizhu

Code Mode 👨🏽‍💻

• Thaiane Braga
• Ash Baker
• Anmol Singh
• Kiho
• Marton
• Redowan Delowar
• Zhenye Na

Dynamic Realtime 💫

• Kirill Feschenko
• Anurag Hazra
• DenverCoder1
• Hemant Joshi
• Kittinan
• Andrew Novac
• Johnny Villegas
• Andrew Young
• Rashmi Jadhav
• andyruwruw
• Jacob Colvin
• Osman Durdağ
• iampavangandhi
• Dani Akash
• Rahul Jha
• Taehyun Hwang

A Little Bit of Everything 😃

• Raymond Li
• Martin Heinz
• Adam Alston
• Rafnix Guzmán
• Aditya Pal
• Hedy Li
• Xunzhuo
• Khaleel Gibran
• Apoorv Tyagi
• CxyFreedom
• Miller Camilo Vega
• Abhishek Maira
• Clayton Hamilton
• Sy Rashid
• Quin Knight
• Jackyu-1999
• Rak Laptudirm
• Trini B
• holic-x

Descriptive 🗒

• Filip Troníček
• Garima Singh
• lizheming
• Nguyễn Hoàng Dương
• Saksham Taneja
• TheAbbie
• Keshav Singh
• Vidur Satija
• Dani El-Ayyass
• Nanra Sukedy

Simple but Innovative Ones 🤗

• Nate Moore
• Jhey Tompkins
• Waylon Walker
• Vansh Kapoor
• Harsh Kumar Khatri
• Stephen Ajulu
• Haany Ali
• Anurag Singh
• Rishit Dagli
• Vinit Shahdeo
• Fatih Kadir Akın
• Lucas Vazquez
• 小弟调调™
• alx365
• Johnny Villegas
• 一缕殇流化隐半边冰霜
• Srihari Kapu
• vaaski
• Arturs Smirnovs
• Yash Sahijwani
• Hemanth Kollipara
• Tushar Mittal
• Onimur
• Bruno Tacca
• Matthew Taylor

Typing.. Mode 🎰

• Mathieu Ledru
• CyrisXD
• Mpho Mphego
• Abhinav Sharma
• Mason Slover
• SuperSupeng

Anime 👾

• Ing
• edisonlee55
• Ashutosh
• Yukii

Minimalistic ✨

• Caneco
• Gift Egwuenu
• Kelechi Precious Nwachukwu
• Ghazi Khan
• Pratik Kumar
• Dennis Hartrampf
• MrStanDu33
• Jayraj Roshan
• amxchang
• ridermansb
• Maximous Black
• Alex Martin
• ChungZH
• Orhun
• Aveek Saha
• Federico Dondi
• Zheeeng
• TallGuyJenks
• Stefanie Grunwald
• Abdul Khaliq

GIFS 👻

• Pouya Saadeghi
• Ari
• Siv Ram Shastri
• Shanu Mishra
• Shubham Kumar
• Duncan
• Demartini
• Sindre Sorhus
• Pranjal Bhardwaj
• Okan Koçyiğit
• Raghav Khullar
• xrkffgg
• Kevin Cui
• Muskan Rani
• Rishav Anand
• KelviNosse
• nilfalse
• Shahriar Shafin
• Somnath Paul
• Ksenia Morozova

Just Images 🎭

• Zack Krida
• 偏右
• thewhiteh4t
• Akash Rai
• Oussama Bouchikhi
• Daily Random Photo

Badges 🎫

• Harish Kumar S S
• Anirudh Emmadi
• Brendon Smith
• Alwin Wang
• Moshfiq Rony
• Ileriayo Adebiyi
• Samujjwaal Dey
• Char-Al
• Oka
• Nikita Rusetskii
• Raphael Ebner

Fancy Fonts 🖋

• xiaoluoboding

Icons 🎯

• Yuan Tang
• Hussainweb
• Peter Han
• Thomas George Thomas
• Derek Nguyen
• Valentin Briand

Retro 😎

• Livio Brunner
• Christian Petersen

Tools

• Todoist Stats in Readme - Daily Todoist Stats on your Profile Readme
• Visitor Badge - Count visitors for your README.md, Issues, PRs in GitHub
• 1990s style Visitor Counter - Add a 1990s style visitor counter with one line of markdown.
• Vistor Count - Count visitors for README.md that can be used with shields.io
• Shields Project - Use Shields to create profile badges, compatible with Simple Icons
• Github Readme Stats - Get dynamically generated GitHub stats on your readmes
• Github Contributor Stats - 🔥 Get dynamically generated Github Contributor stats (repositories you really committed) on your readmes
• GitHub Streak Stats - 🔥 Stay motivated and show off your contribution streak! 🌟 Display your total contributions, current streak, and longest streak on your GitHub profile README
• Simple Icons - SVG icons for popular brands for your README.md files
• Laravel GitHub Profile Visit Counter - Add on your Laravel project a quick-badge to count your profile visits.
• Dev Metrics in Readme - WakaTime Weekly Metrics on your Profile Readme
• Profile Activity Generator - Generate custom profile activity for your profile README
• Current UTC time - Example code of server that can serve dynamic content on GitHub profile
• Github Activity in README - Updates README.md with the recent GitHub activity of a user
• Github Profile README Generator - This tool provides an easy way to create github profile readme with latest addons like visitors count, github stats etc.
• Dynamic Profile Page On Github - Get dynamically generated list of your commits (of the repositories that the action is configured) on GitHub profile readme.
• npm package downloads - Show all of your npm packages and their total downloads
• All Dev Stats in Readme - Are you an early 🐤 or a night 🦉? When are you most productive during the day? What languages you code in? And other stuff... Let's check out in your readme!
• Feedparser - Convenient processing of RSS files
• Profile README Widgets - Add simple widgets to your profile readme.
• Spotify now playing card generator - Generate your Spotify now playing card for your GitHub profile
• Markdown Badges - Add badges to your profile.
• Latest Blog Posts and StackOverflow activity in readme - Show your latest blog posts from any sources or StackOverflow activity on your GitHub profile/project readme automatically using the RSS feed using this Github Action
• GitHub Readme LinkedIn - Get dynamically generated images from your LinkedIn profile on your GitHub readmes
• GitHub Readme Medium - Show your latest Medium article on your readmes!
• GitHub Readme StackOverflow - Dynamically generated your StackOverflow profile status on your GitHub readmes!
• StackOverflow Stats Badge - Display your stats with this Unique StackOverflow Badge!
• Github Profile README Generator - This project allows you to create nice and simple github profile readme files.
• Profile Readme Stats - [Github Action] Showcase your github stats on your profile README.md
• README Jokes - Random dev jokes in your GitHub README.
• GitHub Profile Trophy - 🏆 Add dynamically generated GitHub Trophy on your readme
• Github Readme Twitter - Show your latest tweet on your readmes.
• Random Dev Memes - Random dev memes to display on your GitHub README.
• GitHub Readme Quotes - Dev quotes on your GitHub Profile Readme.
• GitHub Profilinator - This tool contains small GUI components that you can hook together to generate markdown for your perfect readme.
• PageSpeed score - Generate website's PageSpeed score in animated svg form which can be used in GitHub README
• Gitwar Profile Score - Add your Github Profile Score in README.
• Header Images for Github Profile READMEs - Generate header images for your GitHub profile READMEs with custom content
• YouTube Channel Stats - 📺 Display number of subscribers on YouTube and/or your channel's view count as a badge
• Current Book Status from GoodReads - Add a card of the current book you are reading that automatically syncs with GoodReads to display your progress.
• Readme Typing SVG - ⚡ Dynamically generated, customizable SVG that gives the appearance of typing and deleting text

Articles

• "How To Create A GitHub Profile README" - Monica Powell
• "How to Stand Out on Github with Profile READMEs" - Jessica Lim
• "What's on your GitHub Profile" - Waylon Walker
• "3 Ways to Spice up your Github Profile README 🔥" - Jaye Hernandez
• "Dynamically Generated Github Stats For Your Profile ReadMe" - Anurag Hazra
• "How to create an awesome GIF for your GitHub Profile README" - Satvik Chachra
• "Create a special repository in your GitHub Profile 🔨, supported and unsupported features" - Alex Malaszkiewicz
• "How to create a Github Profile README with Dynamic Github Stats" - Ghazi Khan
• "How I Built A Self-Updating README On My Github Profile" - Michael Hoffmann (Mokkapps)
• "Building a self-updating profile README for GitHub" - Simon Willison
• "How to create an interactive README for your GitHub profile" - Kavish Hukmani
• "什么？Github 居然可以这么玩？" - Tw93
• "Getting started with Markdown Badges" - Ileriayo Adebiyi
• "Show your latest dev.to posts automatically on your GitHub profile readme" - Gautam krishna R
• "How I Built A Self-Updating README by Webhooks and Netlify Functions" - Rao Hai
• "Build a Stunning README For Your GitHub Profile" - Martin Heinz
• "How I added my Spotify statistics to my GitHub readme 📜" - Akshit Garg
• "Static Readme Regeneration" - Aral Roca
• "How to Create a Self-Updating README.md for Your GitHub Profile" - Thomas Guibert
• "一文玩转github主页" - holic-x

Tutorials

• "Create Impressive GitHub Portfolio" - MTECHVIRAL
• "How To Create a Github Profile ReadMe" - James Q Quick
• "How to create a GitHub profile README" - Code With Confidence
• "How To Create A GitHub Profile README" - Program With Erik
• "Next Level GitHub Profile README" - codeSTACKr

Contribute

Contributions are always welcome! Please read the contribution guidelines first.

Special Thanks 🙇

• Zetao Zhuang for making the amazing site for this repo!

License

To the extent possible under law, Abhishek Naidu has waived all copyright and related or neighboring rights to this work.

awesome-github-profile-readme's Issues

Feature: Add this profile readme

Is your feature request related to a problem? Please describe.

Yes (& no). I've worked hard on making my profile readme with many features.

Describe the solution you'd like

Add my profile readme to this list.

Additional context

It's still in development! If you have a suggestion, please reply to this issue and share it with me. 😄

Should I ping the owner, @abhisheknaiidu?

Feature: Add GitHub Actions to Show DISCORD Server Channel, after PR merges

Is your feature request related to a problem? Please describe.

Add GitHub Actions to Show DISCORD Server Channel, after PR merges

Feature: Add to list README

Hey, I'd like you to judge my README and allow me to add to your list if you like it ;)

link

Bug: Error

Describe the Error or Bug

Expected behavior

Additional context

Feature: Awesome Github Profile Online Preview

Hi, I have created an online preview page based on the Repo, hope you like it!

The data is captured every 15 minutes to keep it up to date.

Link： zzetao.github.io/awesome-github-profile

GitHub Sponsors

Hi.. your profile has GitHub Sponsors link eventhough it is not available in India. Can you please tell how you enrolled into the program? I really want it for one of my projects (currently under development off-GitHub)

Error: behavior-bot is not working on config.yml file

Describe the Error

behavior-bot is not working on config.yml file

Error: check out my portfolio website is created with just markdown without any css

http://aditya-deshmukh.me/Mark-up-Portfolio/

Feature: Request to add my profile

https://github.com/takomlii

Error:

Describe the Error

Expected behavior

Additional context

Feature: It would be great if there will be any description of what each category of Readme style actually means!

Hey @abhisheknaiidu !

Came across with your amazing initiative to collect all amazing GitHub Profile Readme's at one place. Really loved the Idea.
I also enjoyed the fact that you are maintaining each and every profile on the basis of Predefined Categories. Directly to the point, I was about to add a pull request to add my profile readme : https://github.com/shreyaschavhan/shreyaschavhan but Unfortunately I don't know in which category of profile styling my profile lies in.

So I think it would be great if there will be any description to each and every category of Readme Styling, we can call it style guide, in short!, so that it will be easier for people to sort out in which category of styling his Profile lies into and to minimize effort to figure out which style they should seek inspiration from (for those who are seeking inspiration to style their own profile readme's).

---

P.S. I think you should suggest me where do I put my profile by having a look here --> My Profile Readme and I would appreciate if you directly add my profile there. It would save your time from reviewing one more Pull Request among 200 already present PR's!

Anyways, Have a Great Day/Week/Month/Year/Future !
Be Great, Regards,
Shreyas

Join Discord Server

Join Our Discord Server, we are building developer's community.
Discord Server Link- https://discord.gg/hEYKDRT

Feature: Add 'all contributors' block to README

Is your feature request related to a problem? Please describe.

This is a really nice way to showcase all of our contributors: https://github.com/all-contributors/all-contributors

Error: Site heading and categories section are small in mobile screen

Describe the Error

When I visited the Website on my android phone the heading and categories are very small in size. It's hard to read. The main

Expected behavior

My suggestion is to redesign the header section

• Scale up the size of the Heading.
• Group all the categories into a select option like a dropdown.
• Also scale up the size of the search box too.

Additional context

Screenshot

add more awesome profile ❤

More sweet profile and awesome code ❤✌

Feature: Order usernames alphabetically within each category

Is your feature request related to a problem? Please describe.

Currently usernames are ordered randomly within each section of the README. This appears disorderly.

Describe the solution you'd like

Step 1: Alphabetize the users in each section of the README.
Step 2: Add the requirement to the contributing guideline that users must place their name alphabetically (by first name) within the category they wish to add their profile to.

Describe alternatives you've considered

The alternative is to carry on as things currently are with users adding their names within each category at random. Can also consider ordering by last name.

Additional context

Example:

As things currently are:

Code Mode 👨🏽‍💻 (currently ordered at random)

Thaiane Braga
Ash Baker
Anmol Singh
Kiho
Marton
Redowan Delowar
Zhenye Na

Code Mode 👨🏽‍💻 (ordered by first name)

Anmol Singh
Ash Baker
Kiho
Marton
Redowan Delowar
Thaiane Braga
Zhenye Na

Github Actions section

Describe the Error

Many of the repos listed use a github action, and are not a usable github action.
e.g. https://github.com/abhisheknaiidu/abhisheknaiidu uses https://github.com/athul/waka-readme .
Linking to https://github.com/abhisheknaiidu/abhisheknaiidu doesnt help very much - linking to https://github.com/athul/waka-readme allows people to see how to use it.

Expected behavior

A Github Actions section should list repos which are a about a Github Action.

Additional context

Added new README.md file

Hello, I have updated the README.md file and have made a PR : Update README.md #783
Hope you will like it and merge it with the repo. Thank you

Add more maintainers to the repository

It seems that the repository is inactive and a lot of PR has is stalled due to the inactivity of the maintainer. In that case, should we get new maintainers for this repo?

This is just a suggestion, this doesn't mean that I wanted to be one.

Feature: May you add my profile to the list, please? 🥺

Is your feature request related to a problem? Please describe.

Nope!

Describe the solution you'd like

I would like to add my profile to the list.

Describe alternatives you've considered

My profile was written in Portuguese language. If that's a problem, I can translate it.

Additional context

Watch this divine, resplendent and dazzling shower of fluffy kittens.

Feature: Add More Badges 👀

Describe the solution you'd like

Add More Badges like Prettier, Continous Integration

Feature: List of Oragnization awesome `.github/README.md`

Since github now supports .github/README.md for organization as their custom profile, it'd be nice to initiate the list in this repo.

I haven't found any other good examples, but here are some few list we can start with

• github.com/microsoft - microsoft/.github
• github.com/gridaco - microsoft/.github

Add More Sections 🌈

Featuring a new profile

Hey @abhisheknaiidu!
Many Thanks for this 'awesome' repo, this has really helped me build a good readme profile.
This is my profile
https://github.com/VinayakBector2002
Will it be possible for you to add my profile on your website as well.
Thanks in advance
Please feel free to give suggestions on the same.

Best Regards

Feature: Should the profile names be sorted alphabetically?

Is your feature request related to a problem? Please describe.

The profile names are being added very randomly right now. Should we make them alphabetical so as to maintain order?

Describe the solution you'd like

• Keep all the names alphabetically sorted
• Ask people to add their names in a sorted order before creating a pull request

Describe alternatives you've considered

Additional context

Just a suggestion; it might be least significant

Feature: Add Discord Join Community Badge

Describe the solution you'd like

Add Discord Join Community Badge

Feature: Add me

Add me 😅

Feature: Add my profile page too

I've been following your profile page collection for a couple of weeks. I would love it if you add my profile too to your list. Thanks in advance.

Error: Domain awesomegithubprofile.tech expired on 12/09/2021

Describe the Error

Visiting https://awesomegithubprofile.tech/ resolves to a page that says This domain name expired on 2021-12-09 23:59:59. No content is shown.

Expected behavior

Visiting https://awesomegithubprofile.tech/ should bring users to the intended site with the relevant content.

Additional context

Cool project!

Feature: Recommend myself~

Recommend myself 汪荣顶

RECOMMAND - My GitHub Profile

Hello, everyone!

May I recommand my github profile by myself?

👇

@Charmve

Add More Innovative Categories ✨

Request for adding my profile too.

I've been following your profile page collection for a couple of weeks. I would love it if you add my profile too to your list.
You can check my GitHub profile and I am sure you gonna like it.

Feature: add my profile to your page

Is your feature request related to a problem? Please describe.

Describe the solution you'd like

Describe alternatives you've considered

Additional context

Request to add my profile

Very nice list of Profiles. Took some examples from there.
Hope you will add mine to the list too.

Error: The Bit.ly URL is not working properly

Describe the Error

The provided link in the repository's About section is not working.

Expected behavior

Clicking on the shorten bitly URL should take the user to the deployed page

Additional context

join discord

Error: Kaito Sugimoto's Readme doesn't exist

Error

When you reach the "Just Images" section and click on the Kaito Sugimoto's link, it is broken.

Expected behavior

Clicking on the link should open its readme file on a new window, but the page is not found.

Error:

Describe the Error

Expected behavior

Additional context

www.botsvsbrowsers.com

Feature: GitHub Actions for Prettier 🤖

Describe the solution you'd like

Set up GitHub Actions for Prettier

Feature: Add new self updating README with follower display

Add a new Repository under Github Actions. This repository displays the followers in README.md. The profile updates every 15 minutes. So, when a new user follows the profile, he/she gets added automatically to the README.md.
Link to my profile: https://github.com/adityabisoi/adityabisoi

Well; I think I can fir here..So pls... tell me where i fit perfectly! I'd add a request!

Thnks Bhaiya!

Feature: Build Pages for this Repo？

Is your feature request related to a problem? Please describe.

If more and more Profiles added in this Repo, Readme will be so long and hard to find and search.

Describe the solution you'd like

Maybe Build a Pages for this? More friendly and more continuous

Describe alternatives you've considered

Additional context

Adding Github trophy as a new tool

We can add GitHub trophies similar to readme stats. This link will take you to the GitHub page. If you agree I would like to take over this issue.

Feature: Update Anime README

feat: I could like to see my Readme under Anime

Request to add my profile

I have already made a pull request here #764 but no response.

Error: Responsiveness

The website is not responsive

We can use Bootstrap or anything to make it responsive

Error:

Describe the Error

Your link to this meme generator takes folks to a repo that isn't working: techytushar/random-memer#2

Expected behavior

When I click the link, the repo has code that's working.

Additional context

Just an awareness shout out. Your list is comprehensive: I know you can't manually keep up on all of them. Hope this helps ✌️

New creative profile readme.

I deserves to be in this list.
You should consider adding me.
Here is my profile @dev-akshat