🫵 Please note that this is not a complete alternative to Shields.io, nor is it intended to replace or extend it. This is a small project I created for personal use. It is aimed at anyone who wants to run their own badges privately. It is not designed to be used as a service for multiple users. Please also keep in mind that, due to API calls, this project may eventually reach its limits. Nevertheless, I hope that some people will enjoy it and perhaps make use of it. The Wiki is still under construction. Support: Matrix Chat
A small, standalone PHP Badge System – no Redis, Docker, or Node required.
It supports static and dynamic (GitHub) badges, multiple styles (similar to Shields),
colors, languages (de/en), and simple file caching.
- Upload the contents of this folder to your webspace (e.g. 
/www/htdocs/.../badges/). - Make sure the 
cache/directory is writable (e.g.0775or0777). - (Optional) Add a GitHub token in 
helpers/config.php(for higher rate limits). - Open 
examples.htmlin your browser. 
| URL input | Badge output | 
|---|---|
Underscore _ | 
Space   | 
Double underscore __ | 
Underscore _ | 
Double dash -- | 
Dash - | 
Star (asterisk) * | 
Placeholder Default Value | 
URL pattern:
static/{textLabel}-{bgColor}-{textColor}/{textMessage}-{bgColor}-{textColor}/{style}
Example:
static/RonDevHub❤️PHP-000000/Awesome-3a6e8f/flat
URL pattern:
icon/{icon}-{iconColor}/{textMessage}-{bgColor}-{textColor}/{style}/{textLabel}-{bgColor}-{textColor}
Examples:
/icon/github-gray/Github-*-000000/flat
/icon/github/👍-teal/*/Github-6d6e70
URL pattern:
/github/{owner}/{repo}/{metric}/{style}/{icon}-{iconColor}/{lang}/{backgroundColorMessage}-{textColorMessage}/{backgroundLabelColor}-{textColorLabel}
Examples:
- 
Top language:
github/{owner}/{repo}/top_language/*/*/*/green - 
With icon:
github/{owner}/{repo}/forks/round/codefork/*/green 
{textMessage}– Badge message text (right side){textLabel}– Badge label text (left side){bgColor}– Background color (default: Label#555, Message#0B7DBE){textColor}– Text color (default: Label & Message#fff){style}=flat|flat-square|plastic|round|for-the-badge(default:flat)
{lang}=en|de(default:en) → Used for GitHub badges. Can be extended.{icon}– Name of an SVG inicons/(without.svg). Colored withcurrentColor.{iconColor}– Icon color (default:#fff)
{metric}- For examplestars,license,issues... more metrics are listed in the wiki{owner}– GitHub user/org{repo}– GitHub repository
{metric}- For examplestars,license,issues... more metrics are listed in the CHANGELOG.md{owner}– Codeberg user/org{repo}– Codeberg repository
⚠️ Note:
This download contains no icons.
Place your SVGs (withfill="currentColor") in theicons/folder, e.g.icons/star.svg.
Then use/star/in the URL.