Run visual tests on PRs

Integrate App Percy with a variety of available source code management tools

This guide provides an overview of the source code integrations Percy supports to help you automate your testing workflows more efficiently.

Don’t see your integration listed? Check out our webhooks documentation, or send a note to support.

How it works

App Percy integrates with your source control tool to run visual reviews alongside code reviews. It also facilitates a two-way sync between your App Percy builds and your pull/merge requests and updating commit statuses to reflect the current state of your App Percy builds.

Through this integration, App Percy also automatically pulls rich metadata into each build including information regarding the compared branches, committers, commit messages, and more.

Notifications and status updates

By integrating with your SCM and linking a repository to a App Percy project, your commits and pull/merge requests will automatically be correlated with App Percy builds.

App Percy updates your commit status when:

• A build is processing
• A build fails due to missing resources, rendering timeout, or if no snapshots were uploaded
• Visual changes are detected and ready for review
• A build finishes processing and has been auto-approved
• All build is approved
• Changes have been requested within a build
• Previously requested changes have been carried forward to a build
• Clicking “Details” will take you to review the build in App Percy.

By default, App Percy approvals aren’t required before merging, but you can enable this feature once you’re ready for it.

Next step

Learn more about how App Percy works with more complex workflows, maintaining base build selections and more.