Beautiful README badges. Drop-in shields.io replacement styled as shadcn/ui buttons.
shieldcn serves SVG badge images that look like shadcn/ui Button components — same font, border-radius, padding, and color tokens. Use them in GitHub READMEs, npm pages, docs sites, and anywhere that accepts <img> tags.
Add a badge to your README:
That's it. No configuration, no API keys, no build step. Both .svg and .png extensions are supported — just swap the extension.
.svg by default for the crispest badge rendering. Use .png only where SVG images are not accepted.| Badge | URL pattern |
|---|---|
| npm version | /npm/{package} |
| npm downloads | /npm/dw/{package} |
| npm license | /npm/license/{package} |
| npm types | /npm/types/{package} |
| GitHub stars | /github/stars/{owner}/{repo} |
| GitHub forks | /github/forks/{owner}/{repo} |
| GitHub release | /github/release/{owner}/{repo} |
| GitHub CI | /github/ci/{owner}/{repo} |
| GitHub license | /github/license/{owner}/{repo} |
| GitHub issues | /github/issues/{owner}/{repo} |
| GitHub PRs | /github/prs/{owner}/{repo} |
| GitHub commits | /github/commits/{owner}/{repo} |
| Discord online | /discord/{serverId} |
| Discord members | /discord/members/{inviteCode} |
| NBA team fan | /nba or /nba/{team} |
| Reddit karma | /reddit/{type}/u/{user} |
| Static | /badge/{label}-{message}-{color} |
| Dynamic JSON | /badge/dynamic/json?url=...&query=... |
| HTTPS endpoint | /https/{hostname}/{path} |
| Memo | /memo/{key} |
Append .svg or .png to any endpoint (e.g. /npm/react.svg or /npm/react.png).
Every badge supports shadcn Button variants:
Badges auto-detect icons per provider. Override with any Simple Icons slug or React Icons component name:
logo=false to remove the icon entirely, or pass a data:image/svg+xml;base64,... string for a fully custom icon..svg — SVG image (crisp, scalable, recommended default).png — PNG image (raster fallback for clients that reject SVG).json — raw badge data/shields.json — shields.io-compatible endpointUse .svg for the sharpest result. Use .png only for platforms that reject SVG images.
Badge components for React → jal-co/ui
