# shieldcn

> Beautiful README badges. A shields.io alternative styled as shadcn/ui buttons.

shieldcn is a free, open-source badge image service. It renders SVG and PNG badge images that look like shadcn/ui Button components — same Inter font, border-radius, padding, and color tokens. Use them in GitHub READMEs, npm pages, docs sites, and anywhere that accepts `<img>` tags.

## Quick start

Add a badge to any markdown file:

```markdown
![npm version](https://shieldcn.dev/npm/react.svg)
![stars](https://shieldcn.dev/github/stars/vercel/next.js.svg)
![discord](https://shieldcn.dev/discord/1316199667142496307.svg)
```

No configuration, no API keys, no build step.

## Supported providers

npm, GitHub, Discord, Reddit, PyPI, Crates.io, Docker Hub, Bluesky, JSR, Bundlephobia, YouTube, VS Code Marketplace, Open Collective, Hacker News, Mastodon, Lemmy, Packagist, RubyGems, NuGet, Pub.dev, Homebrew, Maven, CocoaPods, Codecov, WakaTime, Tokscale, IndieDevs, GitLab, Conda, Chrome Web Store, Firefox Add-ons (AMO), Coveralls, SonarQube, jsDelivr, Chocolatey, Flathub, Snapcraft, F-Droid, Discourse, Stack Exchange, Modrinth, Open VSX, Liberapay, Matrix, Weblate, static badges, dynamic JSON, HTTPS endpoint, and memo badges.

## Agent skill

Install the shieldcn agent skill to let AI coding agents add badges to projects:

```bash
npx skills add jal-co/shieldcn
```

Works with Claude Code, Cursor, Codex, Windsurf, and 40+ more agents via skills.sh.

## Links

- Homepage: https://shieldcn.dev
- Documentation: https://shieldcn.dev/docs
- Agent Skill: https://shieldcn.dev/docs/skill
- API Reference: https://shieldcn.dev/docs/api-reference
- Showcase: https://shieldcn.dev/showcase
- Badge Generator: https://shieldcn.dev/gen
- GitHub: https://github.com/jal-co/shieldcn
- Full LLM context: https://shieldcn.dev/llms-full.txt