GitHub - jal-co/shieldcn: Beautiful README badges, inspired by shields.io and styled like shadcn/ui.

1 min read Original article ↗

shieldcn

Before anyone reaches your docs, they land on your README, the front door of every open-source project. shieldcn makes that first impression count: badges, charts, headers, and sponsor walls, rendered as real shadcn/ui components. A shields.io alternative.

shieldcn stats

Vercel OSS Program Member analytics by openpanel Powered by Neon

Usage

Drop a badge into any README and it renders as a real shadcn Button.

![npm](https://shieldcn.dev/npm/react.svg)
![stars](https://shieldcn.dev/github/vercel/next.js/stars.svg)
![views](https://shieldcn.dev/views/repo/shieldcn/shieldcn.svg)

Agent skill

Install the shieldcn-badges skill from skills.sh so your coding agent can add shieldcn badges, charts, and headers to READMEs:

npx skills add jal-co/shieldcn -a claude-code # installs to Claude Code
npx skills add jal-co/shieldcn -a cursor # installs to Cursor

See skills/shieldcn-badges/SKILL.md for prompt examples and options.

Star history

Rendered by the shieldcn starchart GitHub Action — star charts that survived GitHub's stargazers API restriction, updated daily by shieldcn[bot]. Add it to your repo:

- uses: jal-co/shieldcn@v1
  with:
    theme: violet

GitHub Action docs → · action reference

Star history of jal-co/shieldcn

Sponsors

sponsors

Contributors

contributors