ReadmeBadge

Render a shieldcn badge image with optional link wrapping.

Installation

pnpm dlx shadcn@latest add @shieldcn/readme-badge

Usage

import { ReadmeBadge } from "@/components/readme-badge"

Basic badge

badge preview
/npm/react.svg
badge preview
/npm/react.svg?variant=branded

Wraps the badge in an anchor tag that opens in a new tab.

badge preview
<ReadmeBadge src="https://shieldcn.dev/github/stars/vercel/next.js.svg" alt="Next.js GitHub stars" href="https://github.com/vercel/next.js" />

Custom height

badge preview
<ReadmeBadge src="https://shieldcn.dev/npm/react.svg?size=lg" alt="React" height={28} />

Variants

badge preview
/npm/react.svg
badge preview
/npm/react.svg?variant=secondary
badge preview
/npm/react.svg?variant=outline
badge preview
/npm/react.svg?variant=ghost
badge preview
/npm/react.svg?variant=destructive
badge preview
/npm/react.svg?variant=branded

API Reference

ReadmeBadge

PropType