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 asfixes PRO-643orcloses 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
- 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. - Set a secret on the webhook and set the same value as
GITHUB_WEBHOOK_SECRETin your VoidTrack environment. - Open a PR with a matching branch name or magic word to confirm the link appears on the issue.