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.
- ✅ 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.
Visit badges.ws to explore!
Creating your custom badge is as easy as plugging values into a URL:
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:
[<img src="https://badges.ws/badge/Version-1.0.0-red" />](https://your-project.link)Or self-host your badge service:
docker run -d -p 8080:80 ghcr.io/vladkens/badges:latest- 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)
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.
Missing an integration? Request or contribute — let’s build the ultimate badge toolkit together!
- This project was inspired by Shields.io and Badgen.net.
- Icons are provided by the amazing Simple Icons project.
- The font used for badge rendering is DejaVu Sans, an open-source font family designed for high-quality text rendering.
This project is licensed under the MIT License. See the LICENSE file for details.
