GitHub App Setup
Blammo integrates with GitHub through a GitHub App. This gives Blammo the permissions it needs to clone your code and post results on your pull requests.
Installation
- Visit the Blammo GitHub App page
- Click Install
- Choose which repositories to grant access to (all repos or select repos)
- Authorize the app
That’s it. Blammo will start testing on your next push.
Permissions
The Blammo GitHub App requests the following permissions:
| Permission | Access | Purpose |
|---|---|---|
| Repository contents | Read | Clone your code |
| Pull requests | Read & Write | Post test results as PR comments |
| Commit statuses | Read & Write | Set commit status checks |
| Metadata | Read | List repositories |
Blammo never stores your source code permanently. Repos are cloned into ephemeral environments that are destroyed after testing.
Webhook events
Blammo listens for the following webhook events:
- push — triggers a build on the default branch
- pull_request — triggers a build when a PR is opened or updated
- installation — tracks when the app is installed or removed
Troubleshooting
Blammo isn’t running on my pushes
- Verify the app is installed on the correct repository
- Check that the repository is not archived
- Ensure you’re pushing to a branch with an open PR, or to the default branch
The PR comment doesn’t appear
- Check that the app has Pull requests: Read & Write permission
- The comment may take a few minutes on the first build while the environment is created