stargazers-action

Recent GitHub stargazers as JSON, RSS, and Discord notifications.


Framework-agnostic

Generate JSON and RSS once, then render however you want. The existing production integrations use Astro and Zola, but the generator itself is site-agnostic.

Discord without backfill spam

Diff the current snapshot against file, feed, or branch-backed state. First runs can stay silent, and reruns do not have to resend the same events.

Three surfaces

Use it as a GitHub Action, a CLI for cron jobs and scripts, or a repo-local Node/TypeScript library surface.

Built for real deploys

The docs include concrete integration patterns pulled from the live oddship.net (Astro) and rohanverma.net (Zola) setups.

What it does

GitHub does not expose an account-wide feed for “people recently starred one of my repos”. stargazers-action fills that gap by:

  • discovering public repositories for a user or organization
  • fetching recent stargazer events via GitHub GraphQL
  • writing a normalized JSON snapshot for templates
  • writing an RSS feed for feed readers
  • diffing against prior state for Discord notifications

Pick a path

  • Start with [[Quickstart]] if you want JSON + RSS in a deploy workflow.
  • See [[Discord notifications]] if you want new-star alerts.
  • See [[Astro integration]] and [[Zola integration]] for full site examples.
  • See [[Configuration reference]] and [[CLI and library usage]] for the lower-level surface.