{"id":13408101,"url":"https://github.com/DenverCoder1/custom-icon-badges","last_synced_at":"2025-03-14T12:32:08.741Z","repository":{"id":36966422,"uuid":"387024088","full_name":"DenverCoder1/custom-icon-badges","owner":"DenverCoder1","description":"🛡 Allows users to more easily use Octicons and their own icons and logos on shields.io badges","archived":false,"fork":false,"pushed_at":"2024-09-09T16:46:50.000Z","size":3826,"stargazers_count":545,"open_issues_count":7,"forks_count":84,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-09-09T20:39:46.324Z","etag":null,"topics":["badge","badge-maker","custom","github","hacktoberfest","readme","shields","status","svg"],"latest_commit_sha":null,"homepage":"https://custom-icon-badges.demolab.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DenverCoder1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["DenverCoder1"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-07-17T19:39:44.000Z","updated_at":"2024-09-09T16:45:33.000Z","dependencies_parsed_at":"2023-10-23T16:36:28.454Z","dependency_job_id":"8627f4d0-9e30-4ce6-9941-21d4330ae58a","html_url":"https://github.com/DenverCoder1/custom-icon-badges","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fcustom-icon-badges","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fcustom-icon-badges/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fcustom-icon-badges/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DenverCoder1%2Fcustom-icon-badges/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DenverCoder1","download_url":"https://codeload.github.com/DenverCoder1/custom-icon-badges/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243578491,"owners_count":20313838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["badge","badge-maker","custom","github","hacktoberfest","readme","shields","status","svg"],"created_at":"2024-07-30T20:00:50.759Z","updated_at":"2025-03-14T12:32:05.917Z","avatar_url":"https://github.com/DenverCoder1.png","language":"TypeScript","readme":"# Custom Icon Badges\n\n[![stars](https://custom-icon-badges.demolab.com/github/stars/DenverCoder1/custom-icon-badges?logo=star\u0026logoColor=black)](https://github.com/DenverCoder1/custom-icon-badges/stargazers \"stars\")\n[![issues](https://custom-icon-badges.demolab.com/github/issues-raw/DenverCoder1/custom-icon-badges?logo=issue)](https://github.com/DenverCoder1/custom-icon-badges/issues \"issues\")\n[![license](https://custom-icon-badges.demolab.com/github/license/denvercoder1/custom-icon-badges?logo=law\u0026logoColor=white)](https://github.com/DenverCoder1/custom-icon-badges/blob/main/LICENSE?rgh-link-date=2021-08-09T18%3A10%3A26Z \"license MIT\")\n[![discord](https://custom-icon-badges.demolab.com/discord/819650821314052106?color=7289DA\u0026logo=comments\u0026label=discord\u0026logoColor=white)](https://discord.gg/fPrdqh3Zfu \"Dev Pro Tips Discussion \u0026 Support Server\")\n\nAllows users to more easily use Octicons and their own icons and logos on [shields.io badges](https://github.com/badges/shields).\n\n## ⚡ How to use\n\n1. Get a badge URL from [shields.io](https://shields.io/).\n\n2. Replace `img.shields.io` with `custom-icon-badges.demolab.com`\n\n3. Use any [available slug](#%EF%B8%8F-existing-logos) as the logo query parameter or [upload your own](https://custom-icon-badges.demolab.com).\n\n```md\nhttps://custom-icon-badges.demolab.com/badge/custom-badge-blue.svg?logo=paintbrush\u0026logoColor=white\n```\n\nPreview:\n\n![img](https://custom-icon-badges.demolab.com/badge/custom-badge-blue.svg?logo=paintbrush\u0026logoColor=white)\n\n4. You're done! Use the image URL in your HTML or markdown! Star this repo if you find it useful! ⭐\n\n## 🖼️ Existing logos\n\nThe following are examples of existing icons and logos that are already available.\n\n### Simple Icons\n\nOver 2,000 brand icons from [Simple Icons](https://github.com/simple-icons/simple-icons) are already supported by shields.io.\n\nYou can find a list of slugs for each brand [here](https://github.com/simple-icons/simple-icons/blob/develop/slugs.md).\n\n### Octicons\n\nAll [250+ Octicons](https://primer.style/octicons/) from GitHub are supported by Custom Icon Badges.\n\n| Slug               | Example                                                   |\n| ------------------ | --------------------------------------------------------- |\n| `issue-opened`     | [![issue-opened][issue-opened]][issue-opened]             |\n| `repo-forked`      | [![repo-forked][repo-forked]][repo-forked]                |\n| `star`             | [![star][star]][star]                                     |\n| `git-commit`       | [![git-commit][git-commit]][git-commit]                   |\n| `repo`             | [![repo][repo]][repo]                                     |\n| `git-pull-request` | [![git-pull-request][git-pull-request]][git-pull-request] |\n| `heart`            | [![heart][heart]][heart]                                  |\n| `mail`             | [![mail][mail]][mail]                                     |\n| More Octicons      | [View all ⇨](https://primer.style/octicons)               |\n\n[issue-opened]: https://custom-icon-badges.demolab.com/badge/Issue-red.svg?logo=issue-opened\u0026logoColor=fff\n[repo-forked]: https://custom-icon-badges.demolab.com/badge/Fork-orange.svg?logo=fork\n[star]: https://custom-icon-badges.demolab.com/badge/Star-yellow.svg?logo=star\n[git-commit]: https://custom-icon-badges.demolab.com/badge/Commit-green.svg?logo=git-commit\u0026logoColor=fff\n[repo]: https://custom-icon-badges.demolab.com/badge/Repo-blue.svg?logo=repo\n[git-pull-request]: https://custom-icon-badges.demolab.com/badge/Pull%20Request-purple.svg?logo=pr\n[heart]: https://custom-icon-badges.demolab.com/badge/Heart-D15E9B.svg?logo=heart\n[mail]: https://custom-icon-badges.demolab.com/badge/Mail-E61B23.svg?logo=mail\n\n### Feather Icons\n\nAll [250+ Feather Icons](https://feathericons.com/) are supported by Custom Icon Badges.\n\n**Note:** To use Feather Icons, you must use add the query parameter `logoSource=feather` to the URL in addition to the `logo` parameter.\n\n| Slug               | Example                                             |\n| ------------------ | --------------------------------------------------- |\n| `activity`         | [![activity][activity]][activity]                   |\n| `alert-triangle`   | [![alert-triangle][alert-triangle]][alert-triangle] |\n| `award`            | [![award][award]][award]                            |\n| `bar-chart`        | [![bar-chart][bar-chart]][bar-chart]                |\n| `box`              | [![box][box]][box]                                  |\n| `camera`           | [![camera][camera]][camera]                         |\n| `cast`             | [![cast][cast]][cast]                               |\n| `command`          | [![command][command]][command]                      |\n| `dollar-sign`      | [![dollar-sign][dollar-sign]][dollar-sign]          |\n| `download-cloud`   | [![download-cloud][download-cloud]][download-cloud] |\n| `upload-cloud`     | [![upload-cloud][upload-cloud]][upload-cloud]       |\n| `tv`               | [![tv][tv]][tv]                                     |\n| `youtube`          | [![youtube][youtube]][youtube]                      |\n| More Feather Icons | [View all ⇨](https://feathericons.com/)             |\n\n[activity]: https://custom-icon-badges.demolab.com/badge/activity-red.svg?logo=activity\u0026logoSource=feather\n[alert-triangle]: https://custom-icon-badges.demolab.com/badge/alert--triangle-orange.svg?logo=alert-triangle\u0026logoSource=feather\n[award]: https://custom-icon-badges.demolab.com/badge/award-yellow.svg?logo=award\u0026logoSource=feather\n[bar-chart]: https://custom-icon-badges.demolab.com/badge/bar--chart-green.svg?logo=bar-chart\u0026logoSource=feather\n[box]: https://custom-icon-badges.demolab.com/badge/box-blue.svg?logo=box\u0026logoSource=feather\n[camera]: https://custom-icon-badges.demolab.com/badge/camera-purple.svg?logo=camera\u0026logoSource=feather\n[cast]: https://custom-icon-badges.demolab.com/badge/cast-pink.svg?logo=cast\u0026logoSource=feather\u0026logoColor=black\n[command]: https://custom-icon-badges.demolab.com/badge/command-brown.svg?logo=command\u0026logoSource=feather\n[dollar-sign]: https://custom-icon-badges.demolab.com/badge/dollar--sign-grey.svg?logo=dollar-sign\u0026logoSource=feather\n[download-cloud]: https://custom-icon-badges.demolab.com/badge/download--cloud-black.svg?logo=download-cloud\u0026logoSource=feather\n[upload-cloud]: https://custom-icon-badges.demolab.com/badge/upload--cloud-purple.svg?logo=upload-cloud\u0026logoSource=feather\n[tv]: https://custom-icon-badges.demolab.com/badge/tv-blue.svg?logo=tv\u0026logoSource=feather\n[youtube]: https://custom-icon-badges.demolab.com/badge/youtube-red.svg?logo=youtube\u0026logoSource=feather\n\n### Miscellaneous\n\n|                                                  |                                               |                                         |                                            |\n| ------------------------------------------------ | --------------------------------------------- | --------------------------------------- | ------------------------------------------ |\n| [![ceylon][ceylon]][ceylon]                      | [![color-swatch][color-swatch]][color-swatch] | [![controller][controller]][controller] | [![issue][issue]][issue]                   |\n| [![fire][fire]][fire]                            | [![flag][flag]][flag]                         | [![translate][translate]][translate]    | [![trending-up][trending-up]][trending-up] |\n| [![trending-down][trending-down]][trending-down] | [![phone][phone]][phone]                      | [![pygame][pygame]][pygame]             | [![grey-pygame][grey-pygame]][grey-pygame] |\n| Add your own!                                    | [![Upload Icon][uploadicon]][demo]            |                                         |                                            |\n\n[ceylon]: https://custom-icon-badges.demolab.com/badge/ceylon-E39842.svg?logo=ceylon\u0026logoColor=fff\n[color-swatch]: https://custom-icon-badges.demolab.com/badge/color--swatch-green.svg?logo=color-swatch\u0026logoColor=fff\n[controller]: https://custom-icon-badges.demolab.com/badge/controller-purple.svg?logo=controller\n[issue]: https://custom-icon-badges.demolab.com/badge/issue-orange.svg?logo=issue\u0026logoColor=fff\n[fire]: https://custom-icon-badges.demolab.com/badge/fire-red.svg?logo=fire\u0026logoColor=fff\n[flag]: https://custom-icon-badges.demolab.com/badge/flag-green.svg?logo=flag\u0026logoColor=fff\n[translate]: https://custom-icon-badges.demolab.com/badge/translate-blue.svg?logo=translate\u0026logoColor=white\n[trending-up]: https://custom-icon-badges.demolab.com/badge/trending--up-brightgreen.svg?logoColor=fff\u0026logo=trending-up\n[trending-down]: https://custom-icon-badges.demolab.com/badge/trending--down-red.svg?logoColor=fff\u0026logo=trending-down\n[phone]: https://custom-icon-badges.demolab.com/badge/phone-green.svg?logo=phone\u0026logoColor=white\n[pygame]: https://custom-icon-badges.demolab.com/badge/pygame-013243.svg?logo=pygame\n[grey-pygame]: https://custom-icon-badges.demolab.com/badge/pygame-150458.svg?logo=grey-pygame\n[uploadicon]: https://custom-icon-badges.demolab.com/badge/Upload%20Icon-blue.svg?logo=upload\u0026logoColor=white\n[demo]: https://custom-icon-badges.demolab.com\n\n## ➕ Adding a new logo\n\nUpload new icons using the demo site!\n\nThe file type can be SVG, PNG, etc. but only SVG format supports the `logoColor` parameter for overriding the color of the logo.\n\nIf you think your icon is useful to others, feel free to open a PR to add it to the README above!\n\nDemo site: \u003chttps://custom-icon-badges.demolab.com\u003e\n\n[![image](https://user-images.githubusercontent.com/20955511/128404656-30af9c39-39a4-4ac8-a4b0-2a077806a94c.png)](https://custom-icon-badges.demolab.com)\n\n## 🚀 Example Usage\n\nClick to get the URL!\n\n[![stars][1]][1]\n[![open issues][2]][2]\n[![license][3]][3]\n[![build][4]][4]\n[![last commit][5]][5]\n[![total contributions][26]][26]\n\n[![code size][6]][6]\n[![pr closed][7]][7]\n[![tag][8]][8]\n[![rating][9]][9]\n[![github streak][25]][25]\n\n[![followers][10]][10]\n[![stars][11]][11]\n[![fork][12]][12]\n[![watch][13]][13]\n[![downloads social][14]][14]\n\n[![my repos][15]][15]\n[![downloads][16]][16]\n[![phone][17]][17]\n[![email][18]][18]\n[![location][19]][19]\n\n[![open issue][20]][20]\n[![discuss][21]][21]\n[![install package][22]][22]\n[![use template][23]][23]\n[![github action][24]][24]\n\n[1]: https://custom-icon-badges.demolab.com/github/stars/DenverCoder1/custom-icon-badges?logo=star\n[2]: https://custom-icon-badges.demolab.com/github/issues-raw/DenverCoder1/custom-icon-badges?logo=issue\n[3]: https://custom-icon-badges.demolab.com/github/license/denvercoder1/custom-icon-badges?logo=law\n[4]: https://custom-icon-badges.demolab.com/github/actions/workflow/status/DenverCoder1/custom-icon-badges/ci.yml?branch=main\u0026logo=check-circle-fill\u0026logoColor=white\n[5]: https://custom-icon-badges.demolab.com/github/last-commit/DenverCoder1/custom-icon-badges?logo=history\u0026logoColor=white\n[6]: https://custom-icon-badges.demolab.com/github/languages/code-size/DenverCoder1/custom-icon-badges?logo=file-code\u0026logoColor=white\n[7]: https://custom-icon-badges.demolab.com/github/issues-pr-closed/DenverCoder1/custom-icon-badges?color=purple\u0026logo=git-pull-request\u0026logoColor=white\n[8]: https://custom-icon-badges.demolab.com/github/v/tag/DenverCoder1/custom-icon-badges?logo=tag\u0026logoColor=white\n[9]: https://custom-icon-badges.demolab.com/chrome-web-store/rating/ogffaloegjglncjfehdfplabnoondfjo?logo=thumbsup\u0026logoColor=white\n[10]: https://custom-icon-badges.demolab.com/github/followers/DenverCoder1?logo=person-add\u0026style=social\u0026logoColor=black\n[11]: https://custom-icon-badges.demolab.com/github/stars/DenverCoder1/custom-icon-badges?logo=star\u0026style=social\u0026logoColor=black\n[12]: https://custom-icon-badges.demolab.com/github/forks/DenverCoder1/custom-icon-badges?logo=fork\u0026style=social\u0026logoColor=black\n[13]: https://custom-icon-badges.demolab.com/github/watchers/DenverCoder1/custom-icon-badges?logo=eye\u0026style=social\u0026logoColor=black\n[14]: https://custom-icon-badges.demolab.com/npm/dw/react-bootstrap?logo=download\u0026style=social\u0026label=Download\u0026logoColor=black\n[15]: https://custom-icon-badges.demolab.com/badge/-My%20Repos-blue?style=for-the-badge\u0026logoColor=white\u0026logo=repo\n[16]: https://custom-icon-badges.demolab.com/badge/-Download-F25278?style=for-the-badge\u0026logo=download\u0026logoColor=white\n[17]: https://custom-icon-badges.demolab.com/badge/-123--456--7890-orange?style=for-the-badge\u0026logo=phone\u0026logoColor=white\n[18]: https://custom-icon-badges.demolab.com/badge/-hermione@spew.co.uk-red?style=for-the-badge\u0026logo=mention\u0026logoColor=white\n[19]: https://custom-icon-badges.demolab.com/badge/Colorado-USA-purple?style=for-the-badge\u0026logo=location\u0026logoColor=white\n[20]: https://custom-icon-badges.demolab.com/badge/-Open%20Issue-palegreen?style=for-the-badge\u0026logoColor=black\u0026logo=issue-opened\n[21]: https://custom-icon-badges.demolab.com/badge/-Discuss-plum?style=for-the-badge\u0026logo=comment-discussion\u0026logoColor=black\n[22]: https://custom-icon-badges.demolab.com/badge/-Install%20Package-gold?style=for-the-badge\u0026logo=package\u0026logoColor=black\n[23]: https://custom-icon-badges.demolab.com/badge/-Use%20Template-teal?style=for-the-badge\u0026logo=repo-template\u0026logoColor=white\n[24]: https://custom-icon-badges.demolab.com/badge/-Use%20GitHub%20Action-blue?style=for-the-badge\u0026logo=workflow\u0026logoColor=white\n[25]: https://custom-icon-badges.demolab.com/badge/dynamic/json?logo=fire\u0026logoColor=fff\u0026color=orange\u0026label=github%20streak\u0026query=%24.currentStreak.length\u0026suffix=%20days\u0026url=https%3A%2F%2Fstreak-stats.demolab.com%2F%3Fuser%3DDenverCoder1%26type%3Djson\n[26]: https://custom-icon-badges.demolab.com/badge/dynamic/json?logo=graph\u0026logoColor=fff\u0026color=blue\u0026label=total%20contributions\u0026query=%24.totalContributions\u0026url=https%3A%2F%2Fstreak-stats.demolab.com%2F%3Fuser%3DDenverCoder1%26type%3Djson\n\n## 🖥️ Using a Different Badge Host\n\nBy default, fetching a badge from Custom Icon Badges will use [`img.shields.io`](https://img.shields.io) as the badge host.\n\nYou can set the `host` parameter to one of the following to override the hostname of the badge URL:\n\n- [`img.shields.io`](https://img.shields.io)\n- [`staging.shields.io`](https://staging.shields.io)\n\nIf you would like to use a different badge host, fork and modify this repository. Create a PR if it may be useful to others.\n\n## 🤗 Contributing\n\nWe welcome contributions!\n\nPlease see [CONTRIBUTING.md](CONTRIBUTING.md) for details.\n\n## 📤 Deploying it on your own\n\nDeploying on your own is optional. See the steps below.\n\n\u003cdetails\u003e\n  \u003csummary\u003eDeploy to Heroku\u003c/summary\u003e\n\n1. Sign in to **Heroku** or create a new account at \u003chttps://heroku.com\u003e\n2. Click the Deploy button below\n\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://heroku.com/deploy?template=https://github.com/DenverCoder1/custom-icon-badges/tree/main\"\u003e\n      \u003cimg src=\"https://www.herokucdn.com/deploy/button.svg\" title=\"Deploy to Heroku\" alt=\"Deploy\"/\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n3. Add the URL of a Mongo database as the `DB_URL` config var. The database should have a collection called `icons`. See [getting started](https://docs.atlas.mongodb.com/getting-started/) for more info on setting up a free Mongo Atlas database.\n\n![image](https://user-images.githubusercontent.com/20955511/126066250-108fc119-4bc3-4ba0-9b07-0c7402c5790e.png)\n\n4. Click **\"Deploy App\"** at the end of the form\n5. Once the app is deployed, you can use `\u003cyour-app-name\u003e.herokuapp.com` in place of `custom-icon-badges.demolab.com`\n\n\u003c/details\u003e\n\n## 💬 Questions?\n\nFeel free to [open an issue](http://github.com/DenverCoder1/custom-icon-badges/issues/new/choose).\n\n## 🤩 Support\n\n💙 If you like this project, give it a ⭐ and share it with friends!\n\n[![YouTube](https://custom-icon-badges.demolab.com/badge/-Subscribe-red?style=for-the-badge\u0026logo=video\u0026logoColor=white)](https://www.youtube.com/channel/UCipSxT7a3rn81vGLw9lqRkg?sub_confirmation=1 \"Subscribe to my YouTube channel\")\n[![Sponsor with Github](https://custom-icon-badges.demolab.com/badge/-Sponsor-ea4aaa?style=for-the-badge\u0026logo=heart\u0026logoColor=white)](https://github.com/sponsors/DenverCoder1 \"Sponsor me on GitHub\")\n[![Buy me a coffee](https://custom-icon-badges.demolab.com/badge/-Buy_me_a_coffee-FF5E5B?style=for-the-badge\u0026logo=kofi\u0026logoColor=white)](https://ko-fi.com/jlawrence \"Buy me a coffee\")\n\n## 👨‍💻 Technologies\n\n[![MongoDB](https://custom-icon-badges.demolab.com/badge/-MongoDB-47A248?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white)](https://www.mongodb.com/)\n[![Express](https://custom-icon-badges.demolab.com/badge/-Express-000000?style=for-the-badge\u0026logo=express\u0026logoColor=white)](https://expressjs.com/)\n[![React](https://custom-icon-badges.demolab.com/badge/-React-218AAB?style=for-the-badge\u0026logo=react\u0026logoColor=white)](https://reactjs.org/)\n[![Node.js](https://custom-icon-badges.demolab.com/badge/-Node.js-339933?style=for-the-badge\u0026logo=node.js\u0026logoColor=white)](https://nodejs.org/)\n\n![Uses Shields.io](https://custom-icon-badges.demolab.com/badge/-Uses_Shields.io-000000?style=for-the-badge\u0026logo=shieldsiobadge\u0026logoColor=white)\n[![Made with TypeScript](https://img.shields.io/badge/-Made_with_TypeScript-3178C6?style=for-the-badge\u0026logo=typescript\u0026logoColor=white)](https://www.typescriptlang.org/)\n[![Powered by Heroku](https://img.shields.io/badge/-Powered_by_Heroku-6567a5?style=for-the-badge\u0026logo=heroku\u0026logoColor=white)](https://heroku.com/)\n","funding_links":["https://github.com/sponsors/DenverCoder1","https://ko-fi.com/jlawrence"],"categories":["TypeScript","🧩 Badges 👇","Uncategorized"],"sub_categories":["Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDenverCoder1%2Fcustom-icon-badges","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDenverCoder1%2Fcustom-icon-badges","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDenverCoder1%2Fcustom-icon-badges/lists"}