Get Started!

Customize your Readme.md on your GitHub profile to make it look attractive by following the steps in this simple walkthrough below. I have also provided some cool elements to spice things up!

If your GitHub profile looks something like THIS 👇...

Turn it to something like THIS 👇 or even cooler!

Follow these steps-

1. Create a new Repository

Go to 👉 repo.new
Type the repository name, which should be same as your username. This creates a secret repository.
Make the repository Public.
Check the box - Add a README file.
Then click Create Repository.

2. Update README file

The initial file looks something like this with a simple message.
You can edit the file by clicking on the Edit README button on the right.

As you can see, the file is provided with a template made using markdown. You can edit it according to your preference.
Click on Commit changes.You can also add a commit message.

3. ✨Beautify your profile!✨

There's a lot of open source elements available to achieve a beautiful Profile page. Here's a list of resources to choose from!

GitHub README Stats

anuraghazra / github-readme-stats

⚡ Dynamically generated stats for your github readmes

GitHub Readme Stats

Get dynamically generated GitHub stats on your READMEs!

View Demo · Report Bug · Request Feature · FAQ · Ask Question

Français · 简体中文 · Español · Deutsch · 日本語 · Português Brasileiro · Italiano · 한국어 · Nederlands · नेपाली · Türkçe

Please note that documentation translations may be outdated; try to use English documentation if possible.

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

Are you considering supporting the project by donating to me? Please DO NOT!!!

India has recently suffered one of the most devastating train accidents, and your help will be immensely valuable for the people who were affected by this tragedy.

Please visit this link and make a small donation to help the people in need. A small donation goes a long way. ❤️

Features

View on GitHub

GitHub profile Trophy

ryo-ma / github-profile-trophy

🏆 Add dynamically generated GitHub Stat Trophies on your readme

GitHub Profile Trophy

🏆 Add dynamically generated GitHub Stat Trophies on your README

You can use this service for free. I'm looking for sponsors to help us keep up with this service❤️

Quick Start

Add the following code to your readme. When pasting the code into your profile's readme, change the ?username= value to your GitHub's username.

[![trophy](https://github-profile-trophy.vercel.app/?username=ryo-ma)](https://github.com/ryo-ma/github-profile-trophy)

Use theme

Add optional parameter of the theme.

[![trophy](https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=onedark)](https://github.com/ryo-ma/github-profile-trophy)

More detail

About Rank

Ranks are SSS SS S AAA AA A B C UNKNOWN SECRET.

Rank	Description
SSS, SS, S	You are at a hard to reach rank. You can brag.
AAA, AA, A	You will reach this rank if you do your best. Let's aim here first.
B, C	You are currently making good progress. Let's aim a bit higher.
UNKNOWN	You have not taken action yet. Let's act first.
SECRET	This rank is very rare. The trophy will not

…

View on GitHub

Add a header or cover picture



[![MasterHead](your image link)](your GitHub link)

Add a floating image or GIF.



  <img align="right" alt="Coding" width="400" src="add your link 
  here">

Social icons section.



<h3 align="left">Connect with me:</h3>
<p align="left">
<a href="your link" target="blank"><img align="center" src="https://cdn.jsdelivr.net/npm/simple-icons@3.0.1/icons/twitter.svg" alt="" height="30" width="40" /></a>
<a href="your link" target="blank"><img align="center" src="https://cdn.jsdelivr.net/npm/simple-icons@3.0.1/icons/linkedin.svg" alt="" height="30" width="40" /></a>
<a href="your link" target="blank"><img align="center" src="https://cdn.jsdelivr.net/npm/simple-icons@3.0.1/icons/instagram.svg" alt="" height="30" width="40" /></a>
<a href="your link" target="blank"><img align="center" src="https://cdn.jsdelivr.net/npm/simple-icons@3.0.1/icons/youtube.svg" alt="" height="30" width="40" /></a>
</p>

Languages and tools section.



<h3 align="left">Languages and Tools:</h3>
<p align="left"> <a href="https://www.cprogramming.com/" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/c/c-original.svg" alt="c" width="40" height="40"/> </a> <a href="https://www.w3schools.com/cpp/" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/cplusplus/cplusplus-original.svg" alt="cplusplus" width="40" height="40"/> </a> <a href="https://www.w3schools.com/css/" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/css3/css3-original-wordmark.svg" alt="css3" width="40" height="40"/> </a> <a href="https://www.figma.com/" target="_blank"> <img src="https://www.vectorlogo.zone/logos/figma/figma-icon.svg" alt="figma" width="40" height="40"/> </a> <a href="https://flutter.dev" target="_blank"> <img src="https://www.vectorlogo.zone/logos/flutterio/flutterio-icon.svg" alt="flutter" width="40" height="40"/> </a> <a href="https://git-scm.com/" target="_blank"> <img src="https://www.vectorlogo.zone/logos/git-scm/git-scm-icon.svg" alt="git" width="40" height="40"/> </a> <a href="https://www.w3.org/html/" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/html5/html5-original-wordmark.svg" alt="html5" width="40" height="40"/> </a> <a href="https://www.linux.org/" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/linux/linux-original.svg" alt="linux" width="40" height="40"/> </a> <a href="https://www.photoshop.com/en" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/photoshop/photoshop-plain.svg" alt="photoshop" width="40" height="40"/> </a> <a href="https://www.python.org" target="_blank"> <img src="https://devicons.github.io/devicon/devicon.git/icons/python/python-original.svg" alt="python" width="40" height="40"/> </a> </p>

More Dev icons

GitHub streak

Copy-paste the markdown below into your GitHub profile README
Replace the value after ?user= with your GitHub username ```

Customize it here 👉 [Click me!](http://github-readme-streak-stats.herokuapp.com/demo/)

_________________________________________________________________

#### Spotify playing
 ![spotify](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/ylgltgcjhv2gz4maqo5k.png)
 
  
    
      
      
        JeffreyCA
       / 
        spotify-recently-played-readme
      
    
    
      Display your recently played Spotify tracks on your GitHub profile README.
    
  
  
    

Spotify Recently Played README


Display your recently played Spotify tracks on your GitHub profile README. Powered by Vercel.


Check out lastfm-recently-played-readme for a similar integration for Last.fm scrobbles.



Getting Started


Click the button below to connect your Spotify account with the Vercel app. This is needed to access your recently played tracks.


By authorizing the app, you agree to have your Spotify username, access token, and refresh token stored on a secure Firebase database. This is required so you only need to authorize once and the app can automatically refresh access tokens in order to retrieve recent tracks.
You can revoke the app at https://www.spotify.com/account/apps.




After granting permission, just add the following into your README and set the user query parameter to your Spotify username.


![Spotify recently played](https://spotify-recently-played-readme.vercel.app/api?user=jeffreyca16)


    

    








Link to Spotify profile


Use the following snippet to make the widget link to your…





  View on GitHub






  
  
  Badges - Shields


![badges1](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/6n8fc8zw8pawxveffitx.png)



    

    




Languages,tools and social icons badges

More badges





  
  
  Readme Typing SVG ⌨️


GitHub repo

   Demo





  
  
  Views counter




 



  


    


      

      

        antonkomarev

       / 

        github-profile-views-counter

      

    


    


      It counts how many times your GitHub profile has been viewed. Free cloud micro-service.

    


  


  


    


GitHub Profile Views Counter










Introduction


Try Ÿ HŸPE service as the more robust and feature rich solution.

GHPVС project is proof of concept. This counter designed to be an analytical instrument for you, but not for people who are visiting your profile
It could be used to see profile views dynamics as result of development activity, blogging or taking part in a conference.
It counts how many times your GitHub profile has been viewed and displays them in your profile, for free.


Usage


Cloud solution launched as 100% free experience. Help me cut server costs if you like this service.
If you want to see big numbers in your profile, deploy a standalone solution to draw any views count you want
without spamming our server. Everybody knows that any counters could be faked.

A billion fake profile views doesn't make you a very popular person, it makes you a person…

  
  View on GitHub



_________________________________________________________________


#### Blog Post workflow
![workflow](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/10f4nsodpwku59b5my7x.png)
    
  
    
      
      
        gautamkrishnar
       / 
        blog-post-workflow
      
    
    
      Show your latest blog posts from any sources or StackOverflow activity or Youtube Videos on your GitHub profile/project readme automatically using the RSS feed
    
  
  
    

Blog post workflow  





How to use




Star this repo 😉


Go to your repository


Add the following section to your README.md file, you can give whatever title you want. Just make sure that you use <!-- BLOG-POST-LIST:START --><!-- BLOG-POST-LIST:END --> in your readme. The workflow will replace this comment with the actual blog post list:

# Blog posts
<!-- BLOG-POST-LIST:START -->
<!-- BLOG-POST-LIST:END -->


    

    






Create a folder named .github and create a workflows folder inside it, if it doesn't exist.


Create a new file named blog-post-workflow.yml with the following contents inside the workflows folder:

name: Latest blog post workflow
on
  schedule: # Run workflow automatically
    - cron: '0 * * * *' # Runs every hour, on the hour
  workflow_dispatch: # Run workflow manually (without waiting for the cron to be called), through the GitHub Actions Workflow page directly
permissions:
  contents: 
…

    

    






  
  View on GitHub



_________________________________________________________________


#### Add emojis - [Markdown Icons](https://gist.github.com/rxaviers/7360908)
![emojis](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/sgp5xm0xjd4595nel2qz.png)


_________________________________________________________________




#### README Jokes 👀 
 
  
    
      
      
        ABSphreak
       / 
        readme-jokes
      
    
    
      😄 Jokes for your GitHub READMEs
    
  
  
    

 
README Jokes

 
 Random programming jokes on your README.
 
 
 


  View Demo
  ●
  Report Bugs


Usage

Endpoint URL: https://readme-jokes.vercel.app/api
Embed one of these in your README:

<!-- Markdown -->

![Jokes Card](https://readme-jokes.vercel.app/api)


    

    




or

<!-- HTML -->
<img src="https://readme-jokes.vercel.app/api" alt="Jokes Card" />


    

    





Customization Guide


Customize using ? after /api in the https link, example here with no borders using the hideBorder parameter.


Markdown method:
![Jokes Card](https://readme-jokes.vercel.app/api?hideBorder)


Image method:
<img src="https://readme-jokes.vercel.app/api?hideBorder" alt="Jokes Card" />


Both methods will produce the following jokes card without border:



To use multiple parameters use '&' after the first parameter, e.g. ?hideBorder&theme=cobalt&qColor=%23944bcc&aColor=%23bbdb51
will produce a jokes card without border, with cobalt theme, answer color #944bcc and question color #bbdb51 like so:




Parameters Available




bgColor → Background Color


borderColor → Border Color


qColor → Question Color


aColor → Answer Color


textColor → Normal text Color


codeColor → Code…

  
  View on GitHub



_________________________________________________________________


#### README Quotes ❝
 
  
    
      
      
        PiyushSuthar
       / 
        github-readme-quotes
      
    
    
      🔥 Add Programming Quotes To Your GitHub Readme
    
  
  
    

  
  

Github Readme Quotes

  
Developer Quotes for your Github Readme.


  
    
  
  
    
  
  
    
  



  View Demo
   · 
  Report Bug



Features ✨




Dynamic quotes in your GitHub README
Customize your own quote



Usage ⚡️



Copy the markdown below and paste it in your Github Readme.


[![Readme Quotes](https://quotes-github-readme.vercel.app/api?type=horizontal&theme=dark)](https://github.com/piyushsuthar/github-readme-quotes)


    

    






Options












































Options

Default

Available









type

vertical

horizontal, vertical





theme

light

dark, chartreuse-dark, radical, merko, gruvbox, tokyonight, algolia, monokai, dracula, nord





quote

-

Customize your quote





author

-

The name of the quote's author





border

false

true, false








Installation and Development 🚀



To get started with developing this app locally, here are the steps:

Install the dependencies for the app using,


pnpm install


    

    





And then run the app using:


npx vercel dev


    

    






Usage




Vertical




You don't need to add ?type=vertical parameter.





Horizontal




You need to add ?type=horizontal parameter.





Border




You need to add ?border=true parameter.





Light




You don't need to add…

  
  View on GitHub



_________________________________________________________________


#### Dev Metrics
 
  
    
      
      
        anmol098
       / 
        waka-readme-stats
      
    
    
      This GitHub action helps to add cool dev metrics to your github profile Readme
    
  
  
    

Looking For Translation to different languages & Locale  #23



Dev Metrics in Readme with added feature flags 🎌











📌✨Awesome Readme Stats








   
   
   
   
   



   Are you an early 🐤 or a night 🦉?
   

   When are you most productive during the day?
   

   What are languages you code in?
   

   Let's check out in your profile readme!



    Report Bug
    ·
    Request Feature
  

Prep Work



You need to update the markdown file(.md) with 2 comments. You can refer here for updating it.
You'll need a WakaTime API Key. You can get that from your WakaTime Account Settings

You can refer here, if you're new to WakaTime


You'll need a GitHub API Token with repo and user scope from here if you're running the action to get commit metrics

enabling the repo scope seems DANGEROUS

but this GitHub Action only accesses your commit timestamp and lines of code added or deleted in repository you contributed.


You can…



  
  View on GitHub



_________________________________________________________________














### 4. ALTERNATIVE WAY!
If you found things overwhelming, not to worry! 
#### Here's how to do it (The Easy Way)
   * GitHub profile README generator created by rahuldkjain

👉(https://rahuldkjain.github.io/gh-profile-readme-generator/) 
![generator](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/wpolknuf56fx5b3xkgcg.png)

  * GitHub Profilinator

👉[Try it](https://profilinator.rishav.dev/)
[GitHub Repository](https://github.com/rishavanand/github-profilinator)

_________________________________________________________________


### OR



  1. You can simply *fork* someone's repository
![fork)](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/qxiny6nsi0vbc3n6p16t.png)

  2. Click the *edit icon* in the README file
![edit](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/2j12rnpgxiv3rg7kzil3.png)

  3. Copy the code and paste it onto your README file. Of course, you can modify it according to your choice.
![Copy](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/zpvwf9pp2qqyuto0l117.png)


_________________________________________________________________









### 5. Here's some inspiration and ideas!

  
    
      
      
        abhisheknaiidu
       / 
        awesome-github-profile-readme
      
    
    
      😎 A curated list of awesome GitHub Profile which updates in real time 
    
  
  
    

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
…

  
  View on GitHub



  
    
      
      
        EddieHubCommunity
       / 
        awesome-github-profiles
      
    
    
      List of GitHub profiles that have awesome customisation, that you can use for inspiration
    
  
  
    

Note: This repository is not included in the Hacktoberfest event, as it is for practice only!


Awesome GitHub profiles


List of GitHub profiles that have awesome customization, that you can use for inspiration.

Feel free to submit a pull request with your suggestions for awesome GitHub profiles.

  
    
 
  
    
 
  
    
 
 

 
    
 
  
    
 



How can I add my GitHub profile? 🤷‍♀️🤷‍♂️




Create an issue, with the title as your name, and in the description put a screenshot of the customised GitHub profile page (copy the generated image URL, this will be needed in the next step). The URL will look something like this https://github.com/EddieHubCommunity/awesome-github-profiles/assets/51878265/ee31b832-d549-4df9-8ffe-24419f9d0e46


Fork the project, using the top right corner button, that states fork


Create a file named your-username.json in the directory profiles with the following content.




Your entry should be similar to this example:



{
  "image": "https://user-images.githubusercontent.com/624760/91057573-48531300-e61f-11ea-9e13-2d7384e42000.png"
  "issueId": 66,
  "name": "Eddie Jaoude",
  
…

    

    




  
  View on GitHub




  
  
  Thank you for reading!🙌


Share your amazing GitHub profile in the comments down below for the world to see! :) 

Support me by liking it and sharing it for more such articles.

  
  
  Like what I do? Help me pull my next all-nighter.


  
  
  Consider buying me a coffee ☕.

Options	Default	Available
type	vertical	horizontal, vertical
theme	light	dark, chartreuse-dark, radical, merko, gruvbox, tokyonight, algolia, monokai, dracula, nord
quote	-	Customize your quote
author	-	The name of the quote's author
border	false	true, false

How to have an awesome GitHub profile?

Supritha

Get Started!

Follow these steps-

1. Create a new Repository

2. Update README file

3. ✨Beautify your profile!✨

GitHub README Stats

anuraghazra / github-readme-stats

⚡ Dynamically generated stats for your github readmes

GitHub Readme Stats

Features

GitHub profile Trophy

ryo-ma / github-profile-trophy

🏆 Add dynamically generated GitHub Stat Trophies on your readme

GitHub Profile Trophy

Quick Start

Use theme

About Rank

Add a header or cover picture

Add a floating image or GIF.

Social icons section.

Languages and tools section.

GitHub streak

JeffreyCA / spotify-recently-played-readme

Display your recently played Spotify tracks on your GitHub profile README.

Spotify Recently Played README

Getting Started

Link to Spotify profile

Badges - Shields

Readme Typing SVG ⌨️

Views counter

antonkomarev / github-profile-views-counter

It counts how many times your GitHub profile has been viewed. Free cloud micro-service.

GitHub Profile Views Counter

Introduction

Usage

gautamkrishnar / blog-post-workflow

Show your latest blog posts from any sources or StackOverflow activity or Youtube Videos on your GitHub profile/project readme automatically using the RSS feed

Blog post workflow

How to use

ABSphreak / readme-jokes

😄 Jokes for your GitHub READMEs

README Jokes

Usage

Customization Guide

Parameters Available

PiyushSuthar / github-readme-quotes

🔥 Add Programming Quotes To Your GitHub Readme

Github Readme Quotes

Developer Quotes for your Github Readme.

Features ✨

Usage ⚡️

Options

Installation and Development 🚀

Usage

Vertical

Horizontal

Border

Light

anmol098 / waka-readme-stats

This GitHub action helps to add cool dev metrics to your github profile Readme

Dev Metrics in Readme with added feature flags 🎌

📌✨Awesome Readme Stats

Prep Work

abhisheknaiidu / awesome-github-profile-readme

😎 A curated list of awesome GitHub Profile which updates in real time

Awesome GitHub Profile README

Contents:

Categories

GitHub Actions 🤖

Game Mode 🚀

EddieHubCommunity / awesome-github-profiles

List of GitHub profiles that have awesome customisation, that you can use for inspiration

Note: This repository is not included in the Hacktoberfest event, as it is for practice only!

Awesome GitHub profiles

How can I add my GitHub profile? 🤷‍♀️🤷‍♂️

Thank you for reading!🙌

Like what I do? Help me pull my next all-nighter.

Consider buying me a coffee ☕.

antonkomarev
/
github-profile-views-counter