There are many different ways to use Percy. You can integrate Percy into your existing test suites with our test-framework SDKs, capture your static-site or Storybook with one command, or write a custom puppeteer script to navigate your app and capture snapshots at will.
For the best workflow, we strongly recommend running Percy via your CI system (often as part of your regular CI test run), and use our GitHub or GitLab integrations to see Percy notifications in your pull requests. While you’re first getting started and quickly iterating, you may find it useful to run Percy locally.
Step 1: Set the
PERCY_TOKEN environment variable in your CI environment.
Step 2: Integrate Percy via one of our SDKs to take snapshots.
Step 3: Run your tests in CI and integrate with GitHub or GitLab!
Percy is designed to integrate with your tests and CI environment. Read the documentation for your CI service to get started.
Integrate a Percy client library to take snapshots in tests.
- Storybook for React
- Storybook for Angular
- Storybook for Vue.js
- Storybook for Ember
See our source code integration docs for more info about Percy's review workflow.