A Python utility for generating customized Shields.io badges as well as a static API for additional icons not included in Simple Icons.
This utility simplifies the creation and customization of badges in the style of Shields.io that can be used in your README files, documentation, websites, and wherever else you'd like. It:
- Converts SVG icons to base64 for use in Shields.io badges
- Supports both named colors and hex color codes
- Downloads generated badges for local use
- Supports concurrent downloads for efficiency
To use this repository as a static API, all you need to do is pass the slug you want to the URL: https://raw.githubusercontent.com/gtkacz/shieldsio-plus/refs/heads/main/assets/shields/{style}/{slug}.svg. To add more icons to the static API, see below.
| Slug | Sample |
|---|---|
| azure |  |
| azure-white |  |
| confluent |  |
| confluent-white |  |
| dot-net-core |  |
| dot-net-core-white |  |
| gitcode |  |
| gitcode-black |  |
| gitcode-white |  |
| gogs |  |
| gogs-white |  |
| hacktoberfest |  |
| hacktoberfest-black |  |
| hacktoberfest-white |  |
| ibm |  |
| ibm-cloud |  |
| ibm-cloud-white |  |
| ibm-white |  |
| ieee |  |
| ieee-white |  |
| lattes |  |
| lattes-white |  |
 |
|
| linkedin-blue |  |
| linkedin-white |  |
| linkedin-white-logo |  |
| magento |  |
| magento-grey |  |
| magento-white |  |
| microsoft |  |
| microsoft-white |  |
| oracle |  |
| oracle-cloud |  |
| oracle-cloud-white |  |
| oracle-white |  |
| orcid |  |
| orcid-grey-logo |  |
| orcid-logo |  |
| orcid-white |  |
| orcid-white-logo |  |
| phacility |  |
| play-framework |  |
| plnkr |  |
| plnkr-white |  |
| sbc |  |
| sbc-blue |  |
| sourcegraph |  |
| sourcegraph-black |  |
| sourcegraph-white |  |
| sql-developer |  |
| sql-developer-white |  |
 |
|
| twitter-white |  |
| visual-studio |  |
| visual-studio-white |  |
| vs-code |  |
| vs-code-black |  |
| vs-code-dark |  |
| vs-code-white |  |
| windows-10 |  |
| windows-10-blue |  |
| windows-7 |  |
| windows-7-white |  |
| zeplin |  |
| zeplin-white |  |
| Style | Sample |
|---|---|
| flat | |
| true_flat* |  |
| flat_square |  |
| plastic |  |
| for_the_badge |  |
| social |  |
| Family Name | Type | Sample |
|---|---|---|
| Andale Mono | Monospace |  |
| Arial | Sans-Serif |  |
| Arial Black | Sans-Serif |  |
| Arial Narrow | Sans-Serif |  |
| Arial Rounded Mt Bold | Sans-Serif |  |
| Avant Garde | Sans-Serif |  |
| Baskerville | Serif |  |
| Big Caslon | Serif |  |
| Bodoni Mt | Serif |  |
| Book Antiqua | Serif |  |
| Brush Script Mt | Cursive |  |
| Calibri | Sans-Serif |  |
| Calisto Mt | Serif |  |
| Cambria | Serif |  |
| Candara | Sans-Serif |  |
| Century Gothic | Sans-Serif |  |
| Consolas | Monospace |  |
| Copperplate | Fantasy |  |
| Courier New | Monospace |  |
| Didot | Serif |  |
| Franklin Gothic Medium | Sans-Serif |  |
| Futura | Sans-Serif |  |
| Garamond | Serif |  |
| Geneva | Sans-Serif |  |
| Georgia | Serif |  |
| Gill Sans | Sans-Serif |  |
| Goudy Old Style | Serif |  |
| Helvetica Neue | Sans-Serif |  |
| Hoefler Text | Serif |  |
| Impact | Sans-Serif |  |
| Lucida Bright | Serif |  |
| Lucida Console | Monospace |  |
| Lucida Grande | Sans-Serif |  |
| Lucida Sans Typewriter | Monospace |  |
| Optima | Sans-Serif |  |
| Palatino | Serif |  |
| Papyrus | Fantasy |  |
| Perpetua | Serif |  |
| Rockwell | Serif |  |
| Rockwell Extra Bold | Monospace |  |
| Segoe Ui | Sans-Serif |  |
| Tahoma | Sans-Serif |  |
| Timesnewroman | Serif |  |
| Trebuchet Ms | Sans-Serif |  |
| Verdana | Sans-Serif |  |
| Monaco | Monospace |  |
| Family Name | Type | Sample |
|---|---|---|
| Andale Mono | Monospace | |
| Arial | Sans-Serif | |
| Arial Black | Sans-Serif | |
| Arial Narrow | Sans-Serif | |
| Arial Rounded Mt Bold | Sans-Serif | |
| Avant Garde | Sans-Serif | |
| Baskerville | Serif | |
| Big Caslon | Serif | |
| Bodoni Mt | Serif | |
| Book Antiqua | Serif | |
| Brush Script Mt | Cursive | |
| Calibri | Sans-Serif | |
| Calisto Mt | Serif | |
| Cambria | Serif | |
| Candara | Sans-Serif | |
| Century Gothic | Sans-Serif | |
| Consolas | Monospace | |
| Copperplate | Fantasy | |
| Courier New | Monospace | |
| Didot | Serif | |
| Franklin Gothic Medium | Sans-Serif | |
| Futura | Sans-Serif | |
| Garamond | Serif | |
| Geneva | Sans-Serif | |
| Georgia | Serif | |
| Gill Sans | Sans-Serif | |
| Goudy Old Style | Serif | |
| Helvetica Neue | Sans-Serif | |
| Hoefler Text | Serif | |
| Impact | Sans-Serif | |
| Lucida Bright | Serif | |
| Lucida Console | Monospace | |
| Lucida Grande | Sans-Serif | |
| Lucida Sans Typewriter | Monospace | |
| Optima | Sans-Serif | |
| Palatino | Serif | |
| Papyrus | Fantasy | |
| Perpetua | Serif | |
| Rockwell | Serif | |
| Rockwell Extra Bold | Monospace | |
| Segoe Ui | Sans-Serif | |
| Tahoma | Sans-Serif | |
| Timesnewroman | Serif | |
| Trebuchet Ms | Sans-Serif | |
| Verdana | Sans-Serif | |
| Monaco | Monospace | |
| Family Name | Type | Sample |
|---|---|---|
| Tektur | Sans-Serif |  |
To create a new badge in the static API, simply create a pull request to add your desired icon as an svg to the icons folder. And we'll do the rest for you!
SVG files should follow the naming convention: slug_DisplayText_HexColor.svg
Examples:
linkedin_LinkedIn_007EBB.svg- Creates a LinkedIn badge with background color #007EBB and save it under thelinkedinslug.orcid-white_ORCID_FFF.svg- Creates an ORCID badge with white background (#FFF) and save it under theorcid-whiteslug.