{"id":30717075,"url":"https://github.com/rondevhub/mini-badges","last_synced_at":"2026-04-17T08:31:11.427Z","repository":{"id":312690417,"uuid":"1040864839","full_name":"RonDevHub/Mini-Badges","owner":"RonDevHub","description":"A small, standalone badge system in PHP that works without Redis/Docker/Node. It supports static and dynamic (GitHub, Codeberg, Forgejo) badges, styles (similar to Shields), colors, languages ​​(German/English), and simple file caching.","archived":false,"fork":false,"pushed_at":"2026-02-27T11:02:48.000Z","size":136,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"beta","last_synced_at":"2026-02-27T15:40:49.388Z","etag":null,"topics":["badge-generator","badge-maker","badges","banner","codeberg","codeberg-badges","forgejo","forgejo-badges","forgejo-integration","github","icons","open-source","self-hosted","self-hosting","self-service","shields","shields-io","shieldsio"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/RonDevHub.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["RonDevHub"],"patreon":null,"open_collective":null,"ko_fi":"rondev","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":"rondev","thanks_dev":"gh/rondevhub","custom":null}},"created_at":"2025-08-19T16:07:47.000Z","updated_at":"2026-02-27T11:02:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"1420b753-dee6-4061-b255-dc44082eb119","html_url":"https://github.com/RonDevHub/Mini-Badges","commit_stats":null,"previous_names":["rondevhub/mini-badges"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/RonDevHub/Mini-Badges","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RonDevHub%2FMini-Badges","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RonDevHub%2FMini-Badges/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RonDevHub%2FMini-Badges/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RonDevHub%2FMini-Badges/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RonDevHub","download_url":"https://codeload.github.com/RonDevHub/Mini-Badges/tar.gz/refs/heads/beta","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RonDevHub%2FMini-Badges/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31921744,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T18:22:33.417Z","status":"online","status_checked_at":"2026-04-17T02:00:06.879Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-generator","badge-maker","badges","banner","codeberg","codeberg-badges","forgejo","forgejo-badges","forgejo-integration","github","icons","open-source","self-hosted","self-hosting","self-service","shields","shields-io","shieldsio"],"created_at":"2025-09-03T08:46:41.265Z","updated_at":"2026-04-17T08:31:11.421Z","avatar_url":"https://github.com/RonDevHub.png","language":"PHP","funding_links":["https://github.com/sponsors/RonDevHub","https://ko-fi.com/rondev","https://buymeacoffee.com/rondev","https://thanks.dev/gh/rondevhub","https://www.buymeacoffee.com/RonDev","https://ko-fi.com/U6U31EV2VS","https://www.paypal.com/paypalme/Depressionist1/4,99"],"categories":[],"sub_categories":[],"readme":"# Mini-Badges \u003csup\u003e![I❤️PHP](https://mini-badges.rondevhub.de/icon/php/I❤️U-000000-fff/pill/-787CB5)\u003c/sup\u003e \n\u003e 🫵 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.\n\u003e 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.\n\u003e The [**Wiki**](https://commitcloud.net/RonDevHub/Mini-Badges/wiki) is still **under construction**.\n\u003e Support: [**Matrix Chat**](https://matrix.to/#/#mini-badges:matrix.s3cr.net)\n---\n![GitHub Repo stars](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/created_at)\n![GitHub Repo stars](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/stars)\n![Issues](https://mini-badges.rondevhub.de/forgejo/RonDevHub/Mini-Badges/issues)\n![GitHub Repo language](https://mini-badges.rondevhub.de/forgejo/RonDevHub/Mini-Badges/language)\n![GitHub Repo license](https://mini-badges.rondevhub.de/forgejo/RonDevHub/Mini-Badges/license/*/*/*/c1d82f-222)\n![Release](https://mini-badges.rondevhub.de/forgejo/RonDevHub/Mini-Badges/release)\n![Forks](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/forks)\n![Watchers](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/watchers)\n![Last update](https://mini-badges.rondevhub.de/forgejo/RonDevHub/Mini-Badges/updated-since \"Last update\")\n![GitHub Repo downlods](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/branches)\n![Milestones Info](https://mini-badges.rondevhub.de/forgejo/RonDevHub/Mini-Badges/milestonesinfo \"Milestones Info\")\n[![status-badge](https://ci.commitcloud.net/api/badges/1/status.svg?events=push%2Cmanual)](https://ci.commitcloud.net/repos/1)\n\n[![Buy me a coffee](https://mini-badges.rondevhub.de/icon/cuptogo/Buy_me_a_Coffee-c1d82f-222/social \"Buy me a coffee\")](https://www.buymeacoffee.com/RonDev)\n[![Buy me a coffee](https://mini-badges.rondevhub.de/icon/cuptogo/ko--fi.com-c1d82f-222/social \"Buy me a coffee\")](https://ko-fi.com/U6U31EV2VS)\n[![Sponsor me](https://mini-badges.rondevhub.de/icon/hearts-red/Sponsor_me/social \"Sponsor me\")](https://github.com/sponsors/RonDevHub)\n[![Pizza Power](https://mini-badges.rondevhub.de/icon/pizzaslice/Buy_me_a_pizza/social \"Pizza Power\")](https://www.paypal.com/paypalme/Depressionist1/4,99)\n\n---\n\nA small, standalone **PHP Badge System** – no Redis, Docker, or Node required.  \nIt supports **static** and **dynamic (GitHub)** badges, multiple **styles** (similar to Shields),  \n**colors**, **languages** (de/en), and simple **file caching**.\n\n---\n\n## 🚀 Installation\n1. Upload the contents of this folder to your webspace (e.g. `/www/htdocs/.../badges/`).\n2. Make sure the `cache/` directory is writable (e.g. `0775` or `0777`).\n3. *(Optional)* Add a GitHub token in `helpers/config.php` (for higher rate limits).\n4. Open `examples.html` in your browser.\n\n---\n\n## 🎯 Usage (Examples)\n\n| URL input                | Badge output    | \n| :----------------------- | :-------------  |\n| Underscore `_`           | Space ` `       |\n| Double underscore `__`   | Underscore `_`  | \n| Double dash `--`         | Dash `-`        |\n| Star (asterisk) `*`      | Placeholder Default Value |\n\n---\n\n### 🔹 Static\n\n**URL pattern:**  \n`static/{textLabel}-{bgColor}-{textColor}/{textMessage}-{bgColor}-{textColor}/{style}`\n\nExample:  \n![Static](https://mini-badges.rondevhub.de/static/RonDevHub❤️PHP-000000/Awesome-3a6e8f/flat)  \n`static/RonDevHub❤️PHP-000000/Awesome-3a6e8f/flat`\n\n---\n\n### 🔹 With Icon\n\n**URL pattern:**  \n`icon/{icon}-{iconColor}/{textMessage}-{bgColor}-{textColor}/{style}/{textLabel}-{bgColor}-{textColor}`\n\nExamples:  \n![With Icon](https://mini-badges.rondevhub.de/icon/github-gray/Github-*-000000/flat)  \n`/icon/github-gray/Github-*-000000/flat`\n\n![With Icon](https://mini-badges.rondevhub.de/icon/github/👍-teal/*/Github-6d6e70)  \n`/icon/github/👍-teal/*/Github-6d6e70`\n\n---\n\n### :computer: GitHub\n\n**URL pattern:**  \n`/github/{owner}/{repo}/{metric}/{style}/{icon}-{iconColor}/{lang}/{backgroundColorMessage}-{textColorMessage}/{backgroundLabelColor}-{textColorLabel}`\n\nExamples:  \n- Stars: ![GitHub Stars](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/stars/*/*/de)  \n  `github/{owner}/{repo}/stars/*/*/de`\n\n- Top language: ![GitHub Top Language](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/top_language/*/*/*/green)  \n  `github/{owner}/{repo}/top_language/*/*/*/green`\n\n- With icon: ![GitHub Forks](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/forks/round/codefork)  \n  `github/{owner}/{repo}/forks/round/codefork/*/green`\n\n---\n\n## ⚙️ Parameters\n\n- `{textMessage}` – Badge message text (right side)\n- `{textLabel}` – Badge label text (left side)\n- `{bgColor}` – Background color (default: Label `#555`, Message `#0B7DBE`)\n- `{textColor}` – Text color (default: Label \u0026 Message `#fff`)\n- `{style}=flat|flat-square|plastic|round|for-the-badge` (default: `flat`)  \n\nExamples:  \n![flat](https://mini-badges.rondevhub.de/static/Style/flat/flat) \n![flat-square](https://mini-badges.rondevhub.de/static/Style/flat--square/flat-square) \n![plastic](https://mini-badges.rondevhub.de/static/Style/plastic/plastic) \n![round](https://mini-badges.rondevhub.de/static/Style/round/round) \n![for-the-badge](https://mini-badges.rondevhub.de/static/Style/for--the--badge/for-the-badge) \n![for-the-badge](https://mini-badges.rondevhub.de/static/Style/classic/classic)\n![for-the-badge](https://mini-badges.rondevhub.de/static/Style/social/social)\n![for-the-badge](https://mini-badges.rondevhub.de/static/Style/minimalist/minimalist)\n![for-the-badge](https://mini-badges.rondevhub.de/static/Style/pill/pill)\n\n\n- `{lang}=en|de` (default: `en`) → Used for GitHub badges. Can be extended.\n- `{icon}` – Name of an SVG in `icons/` (without `.svg`). Colored with `currentColor`.\n- `{iconColor}` – Icon color (default: `#fff`)\n\n---\n\n### :computer: GitHub-specific\n- `{metric}` - For example `stars`, `license`, `issues` ... more metrics are listed in the **wiki**\n- `{owner}` – GitHub user/org\n- `{repo}` – GitHub repository\n\n---\n\n### :codeberg:  Codeberg-specific\n- `{metric}` - For example `stars`, `license`, `issues` ... more metrics are listed in the **CHANGELOG.md**\n- `{owner}` – Codeberg user/org\n- `{repo}` – Codeberg repository\n\n---\n\n## 🖼️ Icons\n\u003e **⚠️ Note:**  \n\u003e This download contains **no icons**.  \n\u003e Place your SVGs (with `fill=\"currentColor\"`) in the `icons/` folder, e.g. `icons/star.svg`.  \n\u003e Then use `/star/` in the URL.\n\n---\n\n## 📜 License\n![GitHub Repo license](https://mini-badges.rondevhub.de/github/RonDevHub/Mini-Badges/license) ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frondevhub%2Fmini-badges","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frondevhub%2Fmini-badges","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frondevhub%2Fmini-badges/lists"}