Skip to content

README star history chart renders an error card (GitHub stargazers API restriction) #1287

Description

@phernandez

What's broken

The star history chart at the bottom of the README no longer renders a chart. The api.star-history.com SVG endpoint still returns HTTP 200, but the SVG's content is an error card: "GitHub restricted access to star data — GitHub team is looking into it."

Why

On June 30, 2026, GitHub restricted the stargazers API (who starred + when) to a repository's own admins and collaborators. Star History's servers aren't collaborators on any repo, so README-embedded live charts are broken for essentially every repository. Details: https://star-history.com/blog/github-stargazer-api-restriction

Fix options (in rough order of preference)

  1. Wait for GitHub — the blog notes the GitHub team is aware and actively working on a solution; the chart may start working again with no change on our side.
  2. Owner-token embed — star-history documents a workaround where a repo owner supplies an access token that can read the repo; it's encrypted into the embed URL (their docs state this is safe for a public README). Requires generating a scoped token and following their embed guide.
  3. Remove or replace the section — drop the chart, or swap in a static badge (e.g. shields.io star count) until upstream recovers.

Notes

  • Not high priority.
  • Related: docs(core): fix broken star history chart in README #1261 was a spam PR that redirected the chart to an unknown third-party domain (star-history.dera.page) — its diagnosis (chart broken) was right, its fix was not. Any real fix should stay on official star-history endpoints or remove the embed.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions