Loading...
Loading...
Add beautiful shadcn/ui-styled README badges to projects using shieldcn. Use when adding badges, shields, or status indicators to README files, docs, or markdown. Triggers include "add badges", "add shields", "readme badges", "npm badge", "GitHub stars badge", "CI badge", "shieldcn", or any request to add project status badges to documentation.
npx skill4agent add jal-co/shieldcn shieldcn-badgeshttps://shieldcn.devhttps://shieldcn.dev/{provider}/{...params}.svg → SVG (default, for READMEs)
https://shieldcn.dev/{provider}/{...params}.png → PNG
https://shieldcn.dev/{provider}/{...params}.json → raw data[](https://link)
<!-- or without link -->
| Provider | Endpoint | Example |
|---|---|---|
| npm version | | |
| npm version (tag) | | |
| npm downloads/wk | | |
| npm downloads/mo | | |
| npm downloads/yr | | |
| npm total downloads | | |
| npm license | | |
| npm types | | |
| npm dependents | | |
| npm scoped | | |
| PyPI version | | |
| PyPI downloads/mo | | |
| Crates.io version | | |
| Docker Hub pulls | | |
| JSR version | | |
| Bundlephobia minzip | | |
| Homebrew version | | |
| Maven version | | |
| Packagist version | | |
| RubyGems version | | |
| NuGet version | | |
| Pub.dev version | | |
| CocoaPods version | | |
/github/{topic}/{owner}/{repo}/github/{owner}/{repo}/{topic}| Badge | Endpoint | Example |
|---|---|---|
| Stars | | |
| Forks | | |
| License | | |
| Release | | |
| CI status | | |
| Issues | | |
| Open PRs | | |
| Contributors | | |
| Last commit | | |
| Watchers | | |
| Downloads | | |
| Dependabot | | |
?workflow=name&branch=main| Provider | Endpoint | Example |
|---|---|---|
| Discord online | | |
| Discord by invite | | |
| Reddit subscribers | | |
| Bluesky followers | | |
| YouTube subs | | |
| Mastodon followers | | |
| Hacker News karma | | |
| Provider | Endpoint | Example |
|---|---|---|
| Codecov | | |
| VS Code installs | | |
| WakaTime | | |
| Type | Endpoint | Example |
|---|---|---|
| Static | | |
| Dynamic JSON | | Fetch any JSON API |
| HTTPS endpoint | | Proxy any JSON endpoint |
?key=value&key2=value2| Param | Values | Default | Notes |
|---|---|---|---|
| | | shadcn Button variant |
| | | Badge size |
| | | Color mode |
| | | Two-tone label/value split |
| SimpleIcons slug, | auto | Icon source |
| hex (no | auto | Icon color |
| string | auto | Override label text |
| hex (no | — | Background color |
| hex (no | — | Label side bg (split mode) |
| | — | Color theme |
| | | Font family |
| | auto for CI | Show status indicator dot |
<p align="center">
<a href="https://www.npmjs.com/package/{pkg}"><img src="https://shieldcn.dev/npm/{pkg}.svg" alt="npm" /></a>
<a href="https://github.com/{owner}/{repo}/stargazers"><img src="https://shieldcn.dev/github/stars/{owner}/{repo}.svg" alt="stars" /></a>
<a href="https://github.com/{owner}/{repo}"><img src="https://shieldcn.dev/github/license/{owner}/{repo}.svg" alt="license" /></a>
<a href="https://github.com/{owner}/{repo}/actions"><img src="https://shieldcn.dev/github/ci/{owner}/{repo}.svg" alt="CI" /></a>
</p>
.svg<a><p align="center">{owner}{repo}{package}default?logo=/npm/v/@scope/packagevariant=secondary