Percy is an all-in-one visual testing and review platform that allows you to run visual tests using either the BrowserStack SDK or the Percy SDK. To test your UI across browsers using Percy, you need to integrate your test suites with Percy.
You can integrate visual testing with Percy using:
BrowserStack SDK: This simplifies testing by combining functional and visual tests in a single pipeline using BrowserStack’s Automate platform. You can run your functional tests on multiple combinations of browsers and devices on BrowserStack, while the visual tests are run on Percy in parallel.
Percy SDK: With this, you can manually integrate Percy with your functional automated testing and use the Percy dashboard for visual testing.
Based on your SDK selection, refer to the appropriate section for detailed instructions on creating a project and executing your visual tests.
You can create a Percy project using the BrowserStack SDK and manage browsers through either Automate or Percy. Percy supports the latest versions of modern browsers, including Chrome, Firefox, Edge, and Safari. With Automate, you can configure various browser names and versions using the Automate capability builder. Choose the appropriate option and refer to the following section accordingly:
When using the BrowserStack SDK, Percy automatically creates a project with the project name specified in the BrowserStack configuration file. This allows you to seamlessly integrate your tests and perform both functional and visual tests.
Click Create new project. The “Create a new project” window appears.
Select Web as the platform and name your project.
Link a repository (optional): Add your repository’s source code integration if needed.
Choose baseline management:
Git is recommended for developers involved in feature development.
Visual Git is recommended for QA and SDET involved in testing & test automation.
Choose handling of browser selection:
Select Percy. Note that this setting cannot be changed once the project is created.
Click Create Project.
Update your BrowserStack config file.
In the browserstack.yml file, set percy: true.
Use the same projectName specified when creating the Percy Web Project in step 2.
Set browserstackAutomation: true if it is currently set to false.
Set percyCaptureMode: auto for Auto mode, or set percyCaptureMode: manual for Manual mode.
Update your test script to capture snapshots using the BrowserStack SDK in Auto and Manual modes.
Your script is ready to execute visual tests, and Percy is prepared to receive the build. After the tests runs, the snapshots are added to the same project.
A build with the same project name and platform configuration mentioned in the BrowserStack config file appears on the Automate dashboard.
You can create a project using the PercySDK with Percy Web or Percy with Automate. Choose Percy to perform visual tests solely on the newest browsers, or choose Automate to run visual tests across a range of desktop, mobile, and browser combinations.
Click Create new project. The “Create a new project” window appears.
Select Web as the platform and name your project.
Link a repository (optional): Add your repository’s source code integration if needed.
Choose baseline management:
Git is recommended for developers involved in feature development.
Visual Git is recommended for QA / SDET involved in testing & test automation.
Choose handling of browser selection:
Select Percy. Note that this setting cannot be changed once the project is created.
Click Create Project.
Percy is ready to receive your first build.
Percy generates a unique PERCY_TOKEN for every created project. This token identifies the organization and project for uploading snapshots. The token starts with web_xxxxxxxx for Percy web projects .
Click Create new project. The “Create a new project” window appears.
Select Web as the platform and name your project.
Link a repository (optional): Add your repository’s source code integration if needed.
Choose baseline management:
Git is recommended for developers involved in feature development.
Visual Git is recommended for QA / SDET involved in testing & test automation.
Choose handling of browser selection:
Select Automate. Note that this setting cannot be changed once the project is created.
Click Create Project.
Percy is ready to receive your first build.
Percy generates a unique PERCY_TOKEN for every created project. This token identifies the organization and project for uploading snapshots. The token starts with auto_xxxxxxxx for Percy Automate projects.
