Skip to main content
Setting up GitHub integration lets Decipher run tests automatically when pull requests are opened or updated.

​
Step 1: Open Integrations

1

Go to Settings

In Decipher, go to Settings (or Integrations, depending on your nav).
2

Find GitHub

Find the GitHub section.

​
Step 2: Connect GitHub

1

Start the connection

Click Connect next to GitHub. You’ll be sent to GitHub to install the Decipher app.
2

Choose where to install

On GitHub, choose where to install the app:
  • Your user account — you’ll see repos from your personal account
  • An organization — you’ll see repos from that org
3

Complete the install

Complete the install (and any permission prompts). You’ll be redirected back to Decipher. GitHub is now connected for your org.

​
Step 3: Connect a repository

1

Select a repo

In the GitHub section, use the repository dropdown (it lists repos from the account/org you chose). Select the repo you want to run PR tests for (e.g. your-org/your-repo).
2

Connect

Click Connect repository. Decipher will create a webhook on that repo and save the connection. You should see Connected to owner/repo.
If you don’t see the right repos: The list is for the account/org you installed the app on. To use a different one, click Use a different GitHub account or org, then install again and choose the correct account/org.

​
Step 4: Configure PR Gate

With a repo connected, click Configure PR Gate.

​
Optional – Branch scope

Add base branches (e.g. main, develop). Tests run only for PRs whose base branch is in this list. Leave empty to allow all branches.

​
When a PR is opened or reopened

Choose one or more Suites and/or Tests to run.

​
When a new commit is pushed to the PR

Choose one or more Suites and/or Tests to run. Click Save.

​
What happens on PRs

  • When someone opens or reopens a PR (and, if you set branch scope, the base branch matches), Decipher runs the suites/tests you set under When a PR is opened or reopened.
  • When someone pushes a new commit to an existing PR, Decipher runs the suites/tests you set under When a new commit is pushed.
  • Decipher waits for a preview deployment (e.g. from Vercel or Netlify) for that PR, then runs the tests against that preview URL.
  • When runs finish, Decipher posts a comment on the PR with the test results.

​
Disconnecting or changing repo

  • Disconnect the repo only — Use the small X next to Connected to owner/repo. You can then pick another repo and connect it.
  • Disconnect GitHub entirely — Click Disconnect in the GitHub section. This removes the connection and the webhook; you can connect again later and choose a different account/org or repo.
Need help? Contact our support team.