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)

Use /github/json/{user}/{repo}/{branch}/{path}?query={field} to render a value from a JSON file in a public GitHub repository. Dot-separated queries and the $.field form are supported. Set kind=count to format an integer count or kind=size to format a byte size.

/github/json/vladkens/hn-timeseries/data/stats.json?query=stories&kind=count&label=stories

Or self-host your badge service:

docker run -d -p 8080:8080 ghcr.io/vladkens/badges:main

GitHub 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_2

For 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.