Everything you can embed in a README

Badges, the star-history chart, repository and maintainer cards, a social preview, and repository-health charts. Every asset is a plain image URL served from gitdebt's own database — no account, no token.

Assets: 21
Health charts: 8
Formats: 4
Parameters: 10

Every URL, preview and snippet below is pointed at facebook/react. A repository nobody has read yet renders a placeholder frame and queues the work, then fills in at the same URL.

open the facebook/react report

Metrics badge

Stars, forks and package downloads in one chip

Metrics

Stars

Forks

Downloads

Downloads from

Theme

Motion in the preview

facebook/react stats badge — Specimenfacebook/react

HTML · facebook/react · auto

<a href="https://gitdebt.com/facebook/react?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/repos/facebook/react/badge.svg?metrics=stars%2Cdownloads&animate=0&source=auto&theme=dark" />
    <img alt="facebook/react stats badge" src="https://api.gitdebt.com/api/repos/facebook/react/badge.svg?metrics=stars%2Cdownloads&animate=0&source=auto&theme=light" />
  </picture>
</a>

Charts, cards and previews

7 assets · facebook/react

Each figure lists the encodings its path answers: swap chart.svg for chart.gif and nothing else changes.

facebook/react star history — Star history
svg · png · webp · gif · light + dark
The full cumulative star curve, served from Postgres. Goes in a `## Star history` section near the bottom of the README, above License.

Star history with its source stated

README block

The chart above, plus one line naming the source gitdebt read the series from, the date it covers, and whether it still updates. Two charts on the same page can come from different sources; this says which.

README.md · facebook/react · source stated

<a href="https://gitdebt.com/facebook/react?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/repos/facebook/react/chart.svg?theme=dark" />
    <img alt="facebook/react star history" src="https://api.gitdebt.com/api/repos/facebook/react/chart.svg?theme=light" />
  </picture>
</a>

<sub>Star history source: Historical star data · Covers through September 15, 2026 · Still updating — <a href="https://gitdebt.com/facebook/react?ref=readme">gitdebt</a></sub>

facebook/react repository statistics — Repository card
svg · png · webp · gif · light + dark
Stars, forks, contributors, languages, and a 90-day sparkline in one panel. Goes in an About or Project status section, or a docs-site sidebar.

facebook/react stars versus package downloads — Stars versus downloads
svg · png · webp · light + dark
Star growth against package-registry downloads, for projects that publish one. Goes in next to the star-history chart, when the project ships a package.

Linked contributor grid

svg · png · webp

The top twelve contributors as individually linked avatars. Each slot is its own <a><img> because an SVG embedded through <img> cannot carry a working link inside it, and each URL addresses a rank rather than a person, so the markup never needs regenerating: ranks past the end of the list render nothing, and a repository that grows past twelve keeps showing its top twelve until someone pastes more lines. Goes in a Contributors or Thanks section, where a reader is looking for the people rather than the numbers.

README.md

<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/0"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/0/avatar.svg" width="64" height="64" alt="facebook/react contributor 1" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/1"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/1/avatar.svg" width="64" height="64" alt="facebook/react contributor 2" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/2"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/2/avatar.svg" width="64" height="64" alt="facebook/react contributor 3" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/3"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/3/avatar.svg" width="64" height="64" alt="facebook/react contributor 4" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/4"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/4/avatar.svg" width="64" height="64" alt="facebook/react contributor 5" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/5"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/5/avatar.svg" width="64" height="64" alt="facebook/react contributor 6" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/6"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/6/avatar.svg" width="64" height="64" alt="facebook/react contributor 7" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/7"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/7/avatar.svg" width="64" height="64" alt="facebook/react contributor 8" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/8"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/8/avatar.svg" width="64" height="64" alt="facebook/react contributor 9" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/9"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/9/avatar.svg" width="64" height="64" alt="facebook/react contributor 10" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/10"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/10/avatar.svg" width="64" height="64" alt="facebook/react contributor 11" /></a>
<a href="https://api.gitdebt.com/api/repos/facebook/react/contributors/11"><img src="https://api.gitdebt.com/api/repos/facebook/react/contributors/11/avatar.svg" width="64" height="64" alt="facebook/react contributor 12" /></a>
<a href="https://gitdebt.com/facebook/react?ref=readme">Contributor ranking on gitdebt</a>

facebook/react on gitdebt — Social preview
png · webp
A 1200x630 PNG for link unfurls on social platforms and chat apps. Goes in a docs-site `og:image` meta tag — not the README, where it would be redundant.

Repository-health charts

8 assets · facebook/react

Calculated from the public commit history, not from stars — which is why they can disagree with the star curve, and why it matters when they do.

facebook/react commit activity calendar — Commit calendar
svg · png · webp · gif · light + dark
Daily commit density across the last 52 weeks. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react commit trend — Maintenance pulse
svg · png · webp · gif · light + dark
Commit volume over time, so a slowdown is visible rather than implied. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react contributors — Contributors
svg · png · webp · gif · light + dark
Who is actually landing commits, ranked, with avatars inlined. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react bus factor — Ownership concentration
svg · png · webp · gif · light + dark
How few people write half the commits. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react language activity — Language activity
svg · png · webp · gif · light + dark
Lines of code by language across the analyzed history. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react file change frequency — File change frequency
svg · png · webp · gif · light + dark
The files the most commits touch, dependency manifests excluded. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react fix-labelled changes — Fix-labelled changes
svg · png · webp · gif · light + dark
Files most often touched by commits whose message reads like a fix. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

facebook/react recent TODO and FIXME movement — TODO/FIXME movement
svg · png · webp · gif · light + dark
Whether known debt markers are being added or paid down. Goes in a Project health or Contributing section, where a prospective contributor is already reading.

Profile README embeds

6 assets · facebook

The same routes for an account, summed across its public repositories. An organization's profile README lives in profile/README.md inside the repository named .github.

Maintainer card

svg · png · webp · gif · light + dark

Aggregate public-repository totals for the account in one compact panel. Goes in the top of a profile README, under the introduction.

HTML

<a href="https://gitdebt.com/facebook?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/users/facebook/card.svg?theme=dark" />
    <img alt="facebook maintainer statistics" src="https://api.gitdebt.com/api/users/facebook/card.svg?theme=light" />
  </picture>
</a>

Aggregate star history

svg · png · webp · gif · light + dark

One curve summing star growth across every public repository owned. Goes in a profile README, below the card.

HTML

<a href="https://gitdebt.com/facebook?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/users/facebook/chart.svg?theme=dark" />
    <img alt="Aggregate star history across facebook's public repositories" src="https://api.gitdebt.com/api/users/facebook/chart.svg?theme=light" />
  </picture>
</a>

Contribution footprint

svg · png · webp · gif · light + dark

Authored work in owned projects versus other people's projects. Goes in a profile README, in place of a generic contribution-count widget.

HTML

<a href="https://gitdebt.com/facebook?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/users/facebook/stats/contributions.svg?theme=dark" />
    <img alt="facebook contribution footprint" src="https://api.gitdebt.com/api/users/facebook/stats/contributions.svg?theme=light" />
  </picture>
</a>

Language footprint

svg · png · webp · gif · light + dark

Lines of code by language across every analyzed owned repository. Goes in a profile README, next to the contribution footprint.

HTML

<a href="https://gitdebt.com/facebook?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/users/facebook/stats/languages.svg?theme=dark" />
    <img alt="facebook language footprint" src="https://api.gitdebt.com/api/users/facebook/stats/languages.svg?theme=light" />
  </picture>
</a>

Commit activity

svg · png · webp · gif · light + dark

Every commit landed in the last 52 weeks, summed across owned repos. Goes in a profile README, as the activity strip.

HTML

<a href="https://gitdebt.com/facebook?ref=readme">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.gitdebt.com/api/users/facebook/stats/commit-activity.svg?theme=dark" />
    <img alt="facebook commit activity" src="https://api.gitdebt.com/api/users/facebook/stats/commit-activity.svg?theme=light" />
  </picture>
</a>

Social preview

png · webp

A 1200x630 PNG for link unfurls. Goes in a personal site's og:image meta tag.

README.md

[![facebook on gitdebt](https://api.gitdebt.com/api/users/facebook/og.png)](https://gitdebt.com/facebook?ref=readme)

Without JavaScript the catalog stays pointed at facebook/react and the copy buttons are inert. Every snippet is still printed in full, and a published embed never needs JavaScript.

URL reference

Swap the owner and name in any URL; nothing else changes.

Query parameters that change what an asset renders
Parameter	Applies to	Effect
theme=light\|dark	every SVG and raster asset	Bakes that palette into the output. Default is light.
animate=1	SVG charts, cards, and badges	Opts into motion, which plays in a GitHub README. Off by default; use the `.gif` variant for surfaces that show an SVG as a static frame.
from=YYYY-MM-DD&to=YYYY-MM-DD	star-history charts	Inclusive date window. An invalid or inverted range is a 400.
rebase=1	star-history charts	Starts every series at zero, so projects of different ages compare fairly.
type=date\|timeline	star-history charts	Calendar dates, or days-since-first-star.
log=1	star-history charts	Logarithmic y axis.
repos=owner/repo,owner/repo	/api/chart.svg	Overlays several repositories on one chart.
metrics=stars,forks,downloads	/badge.svg	Chooses the chips and their order. `downloads` needs a published package.
signal=active\|community\|momentum\|contributor-ready	/badge.svg	Renders one evidence-backed claim instead of raw metrics.
hide_border=1, hide_title=1, card_width=N	/card.svg	Trims the card for tight layouts.

Do not add cache-busting query parameters. Media is edge-cached for a few hours by design and refreshes on its own.
Alt text is not optional. Say what the image shows, not "chart".

Let an agent do it

markdown for agents

This prompt resolves your repository from its git remote, then adds the badge, the star-history chart, and the health charts that fit — replacing an existing star-history widget in place rather than stacking a second one under it.

Paste it into Claude Code, Cursor, Codex, or any coding agent with your checkout open. It carries the measured numbers, the exact snippets, and the rules — including replacing an existing star-history widget in place rather than stacking a second chart under it.

Everything you can embed in a README

Metrics badge

Charts, cards and previews

Metrics badge

Earned signal badge

Star history

Star history with its source stated

Repository card

Stars versus downloads

Linked contributor grid

Social preview

Repository-health charts

Commit calendar

Maintenance pulse

Contributors

Ownership concentration

Language activity

File change frequency

Fix-labelled changes

TODO/FIXME movement

Profile README embeds

Maintainer card

Aggregate star history

Contribution footprint

Language footprint

Commit activity

Social preview

URL reference

Let an agent do it