GitHub App
The Reshot GitHub App connects a repository to a Reshot project. Once it is
installed, every publish tied to a pull request posts the reshot/visual-review
commit status and a per-flow × context summary comment.
Installation
1. Open project settings
Navigate to Settings → Integrations in your project dashboard. Use this page for first-time installation or to reconnect GitHub later if access changes.
2. Install the app
Click Install Reshot GitHub App and authorize it for your organization.
3. Select repositories
Choose which repositories should be connected. A repository can be linked to one Reshot project at a time.
Permissions
| Permission | Access | Purpose |
|---|---|---|
| Metadata | Read | Repository information |
| Pull requests | Read & Write | Post the flow × context summary comment |
| Commit statuses | Write | Set the reshot/visual-review status check |
What CI has to send
Publish the head commit SHA, branch, and pull-request URL with the run so the status, comment, review evidence, and audit trail all refer to the same change. See PR Checks & Merge Gate for the CI steps and the status state model.
Blocking the merge
Installing the app alone does not block anything — GitHub decides that. Add
reshot/visual-review to your branch protection rules to require approval before
merge. The full procedure, including the free-plan advisory behaviour, is in
PR Checks & Merge Gate.
Related
- PR Checks & Merge Gate — status states and branch rules.
- Review Workflow — how a decision is recorded.