Contrib Circles turns a repo’s contributors into a beautiful SVG circle-pack you can embed in a README with one line of markdown. Circle size follows commit count — bigger circles mean more contributions.

Embed in seconds

1. Open the live builder

2. Enter owner/repo and customize your badge

3. Copy the markdown and paste it into your README

Example URL: tailwindlabs/tailwindcss

What you can customize

• Layout — pack, grid, or row

• Colors — background, borders, transparent mode

• Sizing — padding, min/max radius, contribution curve

• Avatars — circle, rounded, or square

• Filters — exclude bots or specific logins

Public and private repos

Public repos work out of the box. For private repos, install the GitHub App once. Auth stays server-side, with no tokens in the badge URL.

Built for READMEs

• SVG output with inlined avatars

• CDN caching for fast loads

• Rate limiting per repo

• Live preview before you embed

Examples

• tailwindlabs/tailwindcss

• microsoft/vscode

• shadcn-ui/ui

• denoland/deno

Free to use. Built with Next.js, deployed on Vercel.