https://github.com/vladkens/badges
🎖️🎨 Instantly create custom badges for GitHub, docs, and more. Lightweight, self-hostable, with live integrations that keep badges always up to date. Elevate your projects in seconds!
https://github.com/vladkens/badges
badge badge-maker badges-github badges-markdown self-hosted service status svg
Last synced: 9 months ago
JSON representation
🎖️🎨 Instantly create custom badges for GitHub, docs, and more. Lightweight, self-hostable, with live integrations that keep badges always up to date. Elevate your projects in seconds!
- Host: GitHub
- URL: https://github.com/vladkens/badges
- Owner: vladkens
- License: mit
- Created: 2025-02-13T11:41:48.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-04-10T02:40:04.000Z (9 months ago)
- Last Synced: 2025-04-30T02:05:46.127Z (9 months ago)
- Topics: badge, badge-maker, badges-github, badges-markdown, self-hosted, service, status, svg
- Language: Rust
- Homepage: https://badges.ws
- Size: 6.24 MB
- Stars: 34
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
# badges.ws · Elegant badges for your standout projects
[
](https://github.com/vladkens/badges)
[
](https://github.com/vladkens/badges)
[
](https://github.com/vladkens/badges/blob/main/LICENSE)
[
](https://www.rust-lang.org)
[
](https://fly.io)
[
](https://buymeacoffee.com/vladkens)
Badges.ws is the perfect way to add a touch of elegance to your GitHub repositories, documentation, or any project that needs a badge with personality. Designed to be **fast**, **lightweight**, and **effortlessly stylish**, Badges.ws lets you generate custom SVG badges in seconds.
## Why Badges.ws?
- ✅ **Instant Integration** – Generate badges for **npm, PyPI, GitHub**, and 15+ other platforms in seconds.
- 🎨 **Pixel-Perfect & Customizable** – Choose **colors, icons, and styles** to match your brand.
- 🔄 **Always Fresh** – Live integrations ensure your badges **never show stale data**.
- ⚡ **Blazing-Fast** – Built with **Rust** for **lightweight performance** and **minimal server footprint**.
- 🔧 **Self-Hosting Freedom** – Deploy with a single Docker command for **full control** over your infrastructure.
## Showcase
### Package Information
### GitHub Insights
### Marketplaces
### Social
### More Options
Visit [badges.ws](https://badges.ws) to explore!
## Get Started in 10 Seconds
Creating your custom badge is as easy as plugging values into a URL:
```sh
https://badges.ws/badge/{label}-{message}-{color}
```
Replace `{label}`, `{message}`, and `{color}` with your desired text and color code, and your badge is ready to shine! Embed then in your `readme.md`:
```sh
[
](https://your-project.link)
```
**Or self-host your badge service:**
```sh
docker run -d -p 8080:80 ghcr.io/vladkens/badges:latest
```
## Live Integrations
- **Languages & Packages**: `JS/TS (npm)`, `Python (PyPI)`, `Rust (Cargo)`, `Ruby (Gems)`, `PHP (Packagist)`, `Dart (Pub)`, `Haskell (Cabal)`, `C#/F# (NuGet)`, `Swift / ObjC (CocoaPods)`, `Clojure (Clojars)`, `Elixir (Hex)`, `Puppet Forge`, `Perl (CPAN)`
- **Marketplaces**: `Homebrew`, `VSCode Marketplace`, `Chrome Web Store`, `Firefox Add-ons`, `JetBrains Plugins`
- **Services & CI/CD**: `GitHub`, `GitLab` ⏳, `Docker Hub`, `CodeCov`, `ReadTheDocs`
- **Community**: `Discord`, `YouTube`
*(⏳ = Coming Soon)*
## Use as a Rust Crate
The core library powering Badges.ws, **badgelib**, can also be used as a standalone Rust crate for generating customizable SVG badges programmatically.
For more details and examples, check out the [badgelib README](badgelib/readme.md).
## Contribute
**Missing an integration?** Request or contribute — let’s build the ultimate badge toolkit together!
## Credits & Inspiration
- This project was inspired by [Shields.io](https://github.com/badges/shields) and [Badgen.net](https://github.com/badgen/badgen.net).
- Icons are provided by the amazing [Simple Icons](https://simpleicons.org) project.
- The font used for badge rendering is [DejaVu Sans](https://dejavu-fonts.github.io), an open-source font family designed for high-quality text rendering.
## License
This project is licensed under the MIT License. See the [LICENSE](/LICENSE) file for details.