Beautiful README badges as a service.
A shields.io alternative styled as shadcn/ui buttons. Never paywalled.
Homepage · Docs · API Reference
shieldcn is an open-source badge service by Justin Levine. Every badge is free, every endpoint is public, and that's not changing.
Badges are rendered as actual shadcn/ui Button components via Satori — same font (Inter), same border-radius, same padding, same color tokens per variant and size. Not "inspired by" — the real thing, as SVG.
Built with jal-co/ui components.
| Badge | URL |
|---|---|
| Version | /npm/{package}.svg |
| Downloads | /npm/{package}/downloads.svg |
| Badge | URL |
|---|---|
| Stars | /github/stars/{owner}/{repo}.svg |
| Forks | /github/forks/{owner}/{repo}.svg |
| Watchers | /github/watchers/{owner}/{repo}.svg |
| Branches | /github/branches/{owner}/{repo}.svg |
| Releases | /github/releases/{owner}/{repo}.svg |
| Tags | /github/tags/{owner}/{repo}.svg |
| Latest tag | /github/tag/{owner}/{repo}.svg |
| License | /github/license/{owner}/{repo}.svg |
| Release | /github/release/{owner}/{repo}[/stable].svg |
| Contributors | /github/contributors/{owner}/{repo}.svg |
| CI status | /github/ci/{owner}/{repo}.svg |
| Checks | /github/checks/{owner}/{repo}[/ref][/check].svg |
| Issues | /github/issues/{owner}/{repo}.svg |
| Open issues | /github/open-issues/{owner}/{repo}.svg |
| Closed issues | /github/closed-issues/{owner}/{repo}.svg |
| Label issues | /github/label-issues/{owner}/{repo}/{label}[/state].svg |
| PRs | /github/prs/{owner}/{repo}.svg |
| Open PRs | /github/open-prs/{owner}/{repo}.svg |
| Closed PRs | /github/closed-prs/{owner}/{repo}.svg |
| Merged PRs | /github/merged-prs/{owner}/{repo}.svg |
| Milestones | /github/milestones/{owner}/{repo}/{number}.svg |
| Commits | /github/commits/{owner}/{repo}[/ref].svg |
| Last commit | /github/last-commit/{owner}/{repo}[/ref].svg |
| Asset downloads | /github/assets-dl/{owner}/{repo}[/tag].svg |
| Dependabot | /github/dependabot/{owner}/{repo}.svg |
| Badge | URL |
|---|---|
| Online count | /discord/{serverId}.svg |
| Badge | URL |
|---|---|
| Static | /badge/{label}-{message}-{color}.svg |
| Dynamic JSON | /badge/dynamic/json.svg?url=...&query=... |
Every badge supports shadcn Button variants and sizes:
Three icon sources, 40,000+ icons:
- Simple Icons —
?logo=react - Lucide —
?logo=lucide:star - React Icons —
?logo=ri:FaReact
.svg— SVG image (default, for READMEs and docs).png— rasterized PNG.json— raw badge data/shields.json— shields.io-compatible endpoint
- shadcn buttons, not shields.io rectangles — badges are rendered as actual shadcn Button components with real Inter font outlines via Satori
- Everything configurable — variant, size, mode, colors, icons, opacity, split, dot — but sensible defaults so you don't have to configure anything
- Shields.io compatible — same URL patterns for static/dynamic badges, same text encoding, shields.io JSON endpoint support
- Open source, never paywalled — every badge type, every variant, every icon source is free
pnpm install # install dependencies
pnpm dev # start dev server
pnpm build # next buildshieldcn uses a token pool (inspired by shields.io) to distribute GitHub API requests across many tokens. You can help by authorizing the OAuth app — read-only, zero scopes, revocable anytime.
- shields.io — the original badge service. Inspiration for URL patterns, static badge format, and the token pool system.
- badgen.net — inspiration for many badge types and endpoint structures, especially the GitHub badge coverage.
- shadcn/ui — the design system these badges are built on.
- Satori — Vercel's JSX-to-SVG engine that makes rendering React components as badge images possible.
- jal-co/ui — the component library powering the docs site.
PRs welcome. See AGENTS.md for architecture overview.