Skip to main content
DocsΒ·ConceptsΒ·Releases

Connect releases to GitHub

Link a repo, paste a webhook secret. Then every push gets recorded.

πŸ“– 3 min read

The premise: every change is a hypothesis. "This won't make anything worse." Sheepit tests the hypothesis automatically β€” by comparing your crash-free rate before and after, and telling you if it got worse.

The setup

  1. Settings β†’ Integrations β†’ GitHub β†’ add your repo.
  2. Sheepit gives you a webhook secret and a payload URL, shown once.
  3. Paste both into that repo's GitHub webhook settings.

What gets recorded

  • A push to any branch β†’ a source revision with the commit SHA (tags are ignored).
  • A merged pull request β†’ a source revision with the PR number and title.
  • Neither one creates a Release by itself β€” pair it with a release created via the API, the CLI, or your CI's deploy hook.

What you get back

  • A deploy timeline (every release, every environment, side by side).
  • Per-release crash signatures, so you can see what started after a given version.
  • A crash-free-rate comparison for the window around each change, flagging regressions automatically.
Connect releases to GitHub Β· Docs | Sheepit