git404hub

what is badges fr?

naereen/badges — explained in plain English

Analysis updated 2026-06-26

4,605MakefileAudience · developerComplexity · 1/5Setup · easy

tl;dr

A copy-paste reference of hundreds of README badges showing build status, license, language, and more, with ready-to-use Markdown and reStructuredText code for each one.

vibe map

mindmap
  root((badges))
    Badge Sources
      shields.io
      forthebadge.com
      Platform integrations
    Topics
      GitHub stats
      License types
      Language badges
    Formats
      Markdown
      reStructuredText
    Use Cases
      README decoration
      Status indicators

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Copy a license badge (MIT, GPL, Creative Commons) into your project README in seconds.

VIBE 2

Find the right shields.io badge for PyPI download counts, version numbers, or Python version compatibility.

VIBE 3

Add GitHub stats badges for stars, forks, open issues, or latest release to any open-source project README.

what's the stack?

MarkdownMakefilereStructuredText

how it stacks up fr

naereen/badgesjoho/7xx-rfcopenwrt/packages
Stars4,6054,5404,494
LanguageMakefileMakefileMakefile
Setup difficultyeasyeasyhard
Complexity1/51/54/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

in plain english

This repository is a reference list of small status badges you can paste into a GitHub or Bitbucket README file. Badges are the small colored labels that appear at the top of many open-source project pages, often showing things like build status, license type, test coverage, or which programming language a project uses. This repository collects hundreds of them with the exact Markdown code needed to display each one. The list is organized by topic. There are sections for general-purpose badges, GitHub-specific badges (stars, forks, contributors, open issues, pull requests, latest release), license badges (MIT, GPL, Creative Commons variants), and language-specific sections for Python, Go, Rust, JavaScript, and others. There is also a section for package registry badges covering PyPI download counts, version numbers, and Python version compatibility. Each entry shows what the rendered badge looks like alongside the code block you would copy into your README. Badges come from two main services: shields.io, which generates badges dynamically based on data it fetches from various sources, and forthebadge.com, which offers a set of fixed decorative badges with a larger, bolder style. Other sources include platform-specific integrations for tools like Read the Docs, Zenodo, Discord, and JetBrains. The repository also includes a reStructuredText version of the same list for projects that use that format instead of Markdown. Contributions are encouraged, and the README notes that people can add their own badges. This is a reference and copy-paste resource rather than a piece of runnable software. The full README is longer than what was shown.

prompts (copy fr)

prompt 1
Give me the Markdown for a MIT license badge using shields.io from the naereen/badges collection.
prompt 2
What shields.io badges can I use to show Python version compatibility for my PyPI package?
prompt 3
Show me how to add a GitHub stars badge and a build-passing badge to my project README using naereen/badges.
prompt 4
Give me the reStructuredText version of a build-passing badge from naereen/badges.
prompt 5
What forthebadge.com options exist for adding a fun decorative badge to my README?

Frequently asked questions

what is badges fr?

A copy-paste reference of hundreds of README badges showing build status, license, language, and more, with ready-to-use Markdown and reStructuredText code for each one.

What language is badges written in?

Mainly Makefile. The stack also includes Markdown, Makefile, reStructuredText.

How hard is badges to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is badges for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.