GitHub App
Cypress and Playwright GitHub App integration for Currents dashboard
Currents integration with GitHub allows posting results of your Playwright and Cypress tests as:
Commit status checks and / or
Pull Request comment
Activating GitHub Integration
To set up an integration:
Open your project settings (Manage Project)
Click “Connect” in the “Connect your GitHub repositories” section.
Your browser will be redirected to GitHub; you will need to approve installing “currents.bot” GitHub App for your organization.
During the installation, the following permissions are requested:
read and write to issues (for posting PR comments)
read and write to Pull Requests (for posting PR comments)
read and write to commit statuses (for posting commit status updates)
After approving the permissions, your browser will navigate back to the Project Settings screen. To complete the setup, you will need to associate a repository with the project and then save the changes.
To change the GitHub repository associated with a project, select the new repository from the dropdown list and click “Save”
GitHub Integration Settings
Use the following settings to change the behaviour of your GitHub Integration.
Commit Status Label
Set the commit status label to distinguish the GitHub status checks one from another. For example, when multiple Current Dashboard projects are connected to the same repository, setting the Commit Status label will conveniently display the status check for each project separately.
Please note - using the same status for the same repo across different projects can create a conflict - runs from both projects will overwrite the associated status check item.
![](https://docs.currents.dev/~gitbook/image?url=https%3A%2F%2F3745692499-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FqmFDEiUa9mr11LUlxDnt%252Fuploads%252FsM57c4Cuxnlu4XhiWd6F%252FCleanShot%25202022-07-18%2520at%252015.16.04%25402x.png%3Falt%3Dmedia%26token%3D095ccc1d-b2de-491b-bdb8-25ca4018cb96&width=768&dpr=4&quality=100&sign=fe61e682&sv=1)
PR Comment
Enabling PR comments will post a summary of your run to the associated GitHub PR. The comment will be posted:
after run’s completion - with the details of test results
after run’s timeout - with the last known test results
Re-running Playwright or cypress tests for the same PR will delete the previous comment and post a new one with the most recent result unless Keep Old Results option is enabled
Failed Runs Only
Enabling the "Failed Runs Only" toggle would prevent posting a comment for successful runs - i.e. runs that have 0 failed or skipped tests.
Events Selection
You can customize what event can trigger posting a PR comment:
Run Finish - will post a comment when a run completes its execution without cancellation or a timeout
Run Cancelled - will post a comment upon the run's cancellation, due to Fail Fast Strategyor cancellation via the Dashboard. See more at Canceling Runs
Run Timeout - will post a comment after a run's timeout is detected. Read more about Run Timeouts.
Keep Old Results
When enabled, old results posted as a PR comment will be preserved, i.e. the integration will keep the comments with the results of the previous runs.
Commit Status Checks
Enabling Commit Status checks will trigger updates for the associated commit - the status depends on the outcomes of your run:
“Pending” for on-going runs
“Failed” for failed or timed out runs
“Passed” for successful runs
Deactivating GitHub Integration
To detach a repository from a project, navigate to Project Settings and click “Disconnect Repository”.
To completely remove GitHub integration, navigate to Project Settings, click “Configure” and then uninstall “currents-bot” Github App. Uninstalling the app will automatically detach all the projects from their respective repositories.
Troubleshooting GitHub Integration
Please note: your CI environment must expose git commit information in order for cypress agent to send commit details (sha, repository URL etc.) and enable the integration.
We use https://github.com/cypress-io/commit-info package to discover git-related information.
To expose your git information, please make sure that
.git
directory is present in your CI environmentYou can explicitly provide git information via environment variables
I have enabled GitHub integration, but nothing is getting reported to GitHub
Behind the scenes, Currents is using git commit data to identify the PR (issue) to comment on.
The simplified flow is:
Get the list of pull requests associated with the commit using an API call:
'GET /repos/{owner}/{repo}/commits/{commit_sha}/pulls',
Select a PR with HEAD commit matching the reported commit sha
Sometimes the commit SHA reported for a run is different from PR's HEAD commit - our integration would not be able to detect the Pull Requests and won't post a comment and status checks.
Please contact our support via in-app chat and share:
Run that is affected
Commit sha of the affected run
HEAD commit sha of the associated Pull Request
Read more about Commit data for GitHub Actions.
Last updated