VoidTrack Docs

GitHub integration

Link pull requests to issues and auto transition state on open or merge.

Point a GitHub App or a repository webhook (pull requests plus pushes, JSON payload) at /api/webhooks/github, and set GITHUB_WEBHOOK_SECRET. This variable is required in production, and every incoming signature is verified against it.

What it does

  • Branch names like pro-643-fix-pdf, and magic words in PR descriptions such as fixes PRO-643 or closes MAN-12, link the pull request to that issue.
  • When the linked PR opens, a backlog or todo issue moves to the team's first started workflow state.
  • When the linked PR merges, closing referenced issues move to Done, and VoidTrack comments on the issue with the PR link.
  • Every issue page has a copy branch name button, so pairing a branch with an issue is one click.

Setup

  1. In your GitHub App or repo settings, add a webhook for pull request and push events, delivered as JSON, pointed at https://your-domain/api/webhooks/github.
  2. Set a secret on the webhook and set the same value as GITHUB_WEBHOOK_SECRET in your VoidTrack environment.
  3. Open a PR with a matching branch name or magic word to confirm the link appears on the issue.

On this page