Skip to content

Latest commit

 

History

History
342 lines (250 loc) · 9.84 KB

File metadata and controls

342 lines (250 loc) · 9.84 KB

🎖️ GitHub Badges Guide

Learn how to add beautiful badges to your GitHub profile and repositories!


🌟 What are Badges?

Badges are small, colorful icons that display information about your project or profile. They show:

  • Language/Framework versions
  • Build status
  • Test coverage
  • Downloads
  • Stars
  • License
  • And much more!

📚 Best Badge Websites

1. Shields.io (Most Popular) ⭐

Website: https://shields.io/

The best source for dynamic badges. You can create badges for almost anything!

How to use:

https://img.shields.io/badge/LABEL-MESSAGE-COLOR

Example:

![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)

2. Badgen.net 🎨

Website: https://badgen.net/

Simple and fast badge generator.

How to use:

https://badgen.net/badge/label/message/color

3. Badge Poser 📊

Website: https://poser.pugx.org/

Great for PHP, Composer, and other packages.


🎯 Popular Badge Collections

Language Badges

![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)
![JavaScript](https://img.shields.io/badge/JavaScript-ES6%2B-yellow?style=flat-square&logo=javascript)
![Java](https://img.shields.io/badge/Java-11%2B-orange?style=flat-square&logo=java)
![C++](https://img.shields.io/badge/C%2B%2B-11-blue?style=flat-square&logo=cplusplus)
![Go](https://img.shields.io/badge/Go-1.16%2B-00ADD8?style=flat-square&logo=go)
![Rust](https://img.shields.io/badge/Rust-Latest-orange?style=flat-square&logo=rust)

Framework Badges

![Flask](https://img.shields.io/badge/Flask-2.0-black?style=flat-square&logo=flask)
![Django](https://img.shields.io/badge/Django-3.2-092E20?style=flat-square&logo=django)
![FastAPI](https://img.shields.io/badge/FastAPI-0.70-009688?style=flat-square&logo=fastapi)
![NumPy](https://img.shields.io/badge/NumPy-Latest-013243?style=flat-square&logo=numpy)
![Pandas](https://img.shields.io/badge/Pandas-Latest-150458?style=flat-square&logo=pandas)

Status Badges

![Build Status](https://img.shields.io/badge/Build-Passing-brightgreen?style=flat-square)
![Tests](https://img.shields.io/badge/Tests-Passing-brightgreen?style=flat-square)
![Coverage](https://img.shields.io/badge/Coverage-95%25-brightgreen?style=flat-square)
![Maintained](https://img.shields.io/badge/Maintained%3F-yes-green?style=flat-square)
![Active Development](https://img.shields.io/badge/Active-Yes-brightgreen?style=flat-square)

License Badges

![MIT License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
![Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue?style=flat-square)
![GPL 3.0](https://img.shields.io/badge/License-GPL%203.0-blue?style=flat-square)
![BSD](https://img.shields.io/badge/License-BSD-blue?style=flat-square)

Stats Badges

![Stars](https://img.shields.io/badge/Stars-100-yellow?style=flat-square)
![Forks](https://img.shields.io/badge/Forks-50-blue?style=flat-square)
![Downloads](https://img.shields.io/badge/Downloads-1k%2F month-brightgreen?style=flat-square)
![Contributors](https://img.shields.io/badge/Contributors-25-orange?style=flat-square)

Social Badges

![GitHub](https://img.shields.io/badge/GitHub-Profile-black?style=flat-square&logo=github)
![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-blue?style=flat-square&logo=linkedin)
![Twitter](https://img.shields.io/badge/Twitter-Follow-1DA1F2?style=flat-square&logo=twitter)
![Discord](https://img.shields.io/badge/Discord-Join-7289da?style=flat-square&logo=discord)

🎨 Badge Styles Available

Shields.io offers different styles:

  1. flat (default)
https://img.shields.io/badge/Python-3.8-blue?style=flat
  1. flat-square
https://img.shields.io/badge/Python-3.8-blue?style=flat-square
  1. plastic
https://img.shields.io/badge/Python-3.8-blue?style=plastic
  1. for-the-badge
https://img.shields.io/badge/Python-3.8-blue?style=for-the-badge
  1. social
https://img.shields.io/badge/Python-3.8-blue?style=social

📝 How to Create Custom Badges

Method 1: Using Shields.io (Recommended)

Step 1: Go to https://shields.io/

Step 2: Fill in the form:

  • Left Text (Label): "Python"
  • Right Text (Message): "3.8+"
  • Color: "blue"
  • Style: "flat-square"
  • Logo: "python"

Step 3: Copy the generated URL/Markdown

Step 4: Add to your README.md:

![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)

Method 2: Dynamic Badges

These badges update automatically!

GitHub Release Badge:

![GitHub Release](https://img.shields.io/github/v/release/Gourav-512/Python-Zero-To-Hero?style=flat-square)

GitHub Downloads:

![GitHub Downloads](https://img.shields.io/github/downloads/Gourav-512/Python-Zero-To-Hero/total?style=flat-square)

GitHub Stars:

![GitHub Stars](https://img.shields.io/github/stars/Gourav-512/Python-Zero-To-Hero?style=flat-square)

GitHub Forks:

![GitHub Forks](https://img.shields.io/github/forks/Gourav-512/Python-Zero-To-Hero?style=flat-square)

GitHub Issues:

![GitHub Issues](https://img.shields.io/github/issues/Gourav-512/Python-Zero-To-Hero?style=flat-square)

GitHub Last Commit:

![GitHub Last Commit](https://img.shields.io/github/last-commit/Gourav-512/Python-Zero-To-Hero?style=flat-square)

🎯 Ready-Made Badge Collections

Complete Badge Set for Python Project

![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)
![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
![GitHub Stars](https://img.shields.io/github/stars/Gourav-512/Python-Zero-To-Hero?style=flat-square)
![GitHub Forks](https://img.shields.io/github/forks/Gourav-512/Python-Zero-To-Hero?style=flat-square)
![GitHub Issues](https://img.shields.io/github/issues/Gourav-512/Python-Zero-To-Hero?style=flat-square)
![Status](https://img.shields.io/badge/Status-Active-brightgreen?style=flat-square)

📊 Color Codes for Badges

Green: brightgreen, green, success
Red: red, critical
Yellow: yellow, warning
Blue: blue, informational
Gray: lightgrey, inactive
Orange: orange, important

🚀 Add Badges to Your Repository

Step 1: Edit README.md

Add this at the top of your README:

# 🐍 Python Zero To Hero

![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)
![License](https://img.shields.io/badge/License-MIT-green?style=flat-square)
![GitHub Stars](https://img.shields.io/github/stars/Gourav-512/Python-Zero-To-Hero?style=flat-square)
![Status](https://img.shields.io/badge/Status-Active-brightgreen?style=flat-square)

Step 2: Commit and Push

git add README.md
git commit -m "Add GitHub badges"
git push origin main

Step 3: View Your Badges!

Visit your GitHub repo to see the beautiful badges! 🎉


🎁 Profile Badges (For Your GitHub Profile)

To add badges to your GitHub profile, create a profile README:

  1. Create a repository with your username as the name

    • Example: Gourav-512/Gourav-512
  2. Create README.md in that repo

  3. Add your badges:

# Gourav Salunkhe (@Gourav-512)

## 🛠️ Tech Stack

![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)
![JavaScript](https://img.shields.io/badge/JavaScript-ES6%2B-yellow?style=flat-square&logo=javascript)
![Git](https://img.shields.io/badge/Git-Latest-orange?style=flat-square&logo=git)
![GitHub](https://img.shields.io/badge/GitHub-Expert-black?style=flat-square&logo=github)

## 📊 Stats

![GitHub Stars](https://img.shields.io/github/stars/Gourav-512?style=flat-square)
![GitHub Followers](https://img.shields.io/github/followers/Gourav-512?style=flat-square)

🌈 Awesome Badge Resources

Online Badge Generators:

Badge Collections:


✨ Examples of Badges You Can Use

# Programming Languages
![Python](https://img.shields.io/badge/Python-3.8%2B-blue?style=flat-square&logo=python)
![JavaScript](https://img.shields.io/badge/JavaScript-Latest-yellow?style=flat-square&logo=javascript)
![Java](https://img.shields.io/badge/Java-11%2B-orange?style=flat-square&logo=java)

# Frameworks & Tools
![Flask](https://img.shields.io/badge/Flask-2.0-black?style=flat-square&logo=flask)
![Django](https://img.shields.io/badge/Django-3.2-092E20?style=flat-square&logo=django)
![VS Code](https://img.shields.io/badge/VS%20Code-Latest-007ACC?style=flat-square&logo=visualstudiocode)

# Status & Info
![Build Passing](https://img.shields.io/badge/Build-Passing-brightgreen?style=flat-square)
![Maintained Yes](https://img.shields.io/badge/Maintained%3F-yes-green?style=flat-square)
![License MIT](https://img.shields.io/badge/License-MIT-blue?style=flat-square)

# Social
![LinkedIn](https://img.shields.io/badge/LinkedIn-Connect-0077B5?style=flat-square&logo=linkedin)
![Twitter](https://img.shields.io/badge/Twitter-Follow-1DA1F2?style=flat-square&logo=twitter)
![GitHub](https://img.shields.io/badge/GitHub-Follow-181717?style=flat-square&logo=github)

🎯 Next Steps

  1. Visit https://shields.io/
  2. Create your first badge
  3. Copy the Markdown
  4. Add to your README.md
  5. Commit and push
  6. See your badges on GitHub! 🎉

Happy badge collecting! 🎖️✨

For more badge ideas, visit: https://github.com/Ileriayo/markdown-badges