This is the home of Shields.io, home to the badge design specification, API documentation, and server code for Badges as a Service.
We invite participation through GitHub Issues, which we use much like a discussion forum. This repository should only contain non-implementation specific topics: specifications, design, and the web site.
Please see INSTALL.md for information on how to start contributing code to shields.io. You can read a Tutorial on how to add a badge.
Note that the root gets redirected to http://shields.io.
For testing purposes, you can go to http://localhost/try.html.
- The left-hand side of a badge should not advertize. It should be a noun describing succinctly the meaning of the right-hand-side data.
- New query parameters (such as
?label=or?style=) should apply to any requested badge. They must be registered in the cache (seeLruCacheinserver.js). - The format of new badges should be of the form
/VENDOR/SUBVENDOR-BADGE-SPECIFIC/PARAMETERS.format. For instance,https://img.shields.io/gitter/room/nwjs/nw.js.svg. The vendor is gitter, the badge is for rooms, the parameter is nwjs/nw.js, and the format is svg.
Please minimize .svg files (eg. in logo/) through SVGO (eg. by using
svgomg).
The main implementation, available at http://shields.io, has its code located in this repository.
Other systems that produce badges following the same design, hosted elsewhere, are listed below.
| website / AP | language | issues |
|---|---|---|
| shielded | JavaScript | shielded |
| buckler.repl.ca | Go | buckler |
| old img.shields.io (discontinued) | Python | img.shields.io-old |
| DotBadge | C# | DotBadge |
Please report bugs and discuss implementation specific concerns (performance characteristics, etc.) in the repository for the respective implementation.
Please open an issue if you'd like to use Shields badges for a project that isn't yet supported.