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 20+ other platforms in seconds.
- 🎨 Pixel-Perfect & Customizable – Choose colors, icons, styles, and animations 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.
Choose flat, flat-square, or for-the-badge, then tune the radius or add an animation:
shine sweeps a soft highlight across the badge, while aurora adds a slowly drifting field of color. The rendering library also provides flow for animated gradients, with all animations respecting reduced-motion preferences.
Presets combine custom artwork and effects into stable URLs. /handmade uses a custom SVG icon with Shine; /vibecoded combines a multicolor icon, gradient, and Aurora animation.
Use logo and logoColor to add and customize a name from Simple Icons. Lookups are case-insensitive, common separators may be omitted, and removed or renamed slugs from supported historical releases remain available. Names such as GitHub Actions, C++, and .NET work directly when URL-encoded:
Logos follow the text color by default; set logoColor only when you need an explicit override. The legacy icon and iconColor names remain accepted as aliases.
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 it in your readme.md:
[<img src="https://badges.ws/badge/Version-1.0.0-red" />](https://your-project.link)| Parameter | Description |
|---|---|
label |
Text shown on the left side |
labelColor |
Background color for the left side |
value |
Text shown on the right side |
color |
Background color for the right side |
logo |
Simple Icons name or slug |
logoColor |
Explicit logo color; defaults to the text color |
style |
flat, flat-square, or for-the-badge |
radius |
Border radius from 0 to 12 pixels |
animation |
flow, shine, or aurora |
format |
svg or json |
cache |
Cache lifetime in seconds |
Or self-host your badge service:
docker run -d -p 8080:8080 ghcr.io/vladkens/badges:mainGitHub badges work without authentication, but a token increases the API rate limit. Create a fine-grained personal access token and leave additional permissions disabled—the service only reads public data. Pass one or more comma-separated tokens through GH_TOKENS:
GH_TOKENS=github_pat_TOKEN_1,github_pat_TOKEN_2For Docker:
docker run -d -p 8080:8080 \
-e GH_TOKENS='github_pat_TOKEN_1,github_pat_TOKEN_2' \
ghcr.io/vladkens/badges:main- Languages & Packages:
JavaScript / TypeScript (npm),Python (PyPI),Rust (Crates.io),Ruby (RubyGems),PHP (Packagist),Dart (Pub),Haskell (Hackage),C# / F# (NuGet),Swift / Objective-C (CocoaPods),Clojure (Clojars),Elixir (Hex),Puppet Forge,Perl (CPAN),Package Phobia - Marketplaces:
Homebrew and Casks,VS Code Marketplace,Chrome Web Store,Firefox Add-ons,JetBrains Plugins - Services & CI/CD:
GitHub and GitHub Actions,Docker Hub,Codecov,Read the Docs - Community:
Discord,YouTube
Missing an integration? Request or contribute — let’s build the ultimate badge toolkit together!
- Badge rendering is powered by badgelib.
- 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.
Distributed under the MIT License.