Percy Developer Hub

Welcome to the Percy Developer Hub. You'll find comprehensive guides and documentation to help you start working with Percy as quickly as possible, as well as support if you get stuck. Let's jump right in!

Getting Started with Percy

This page will help you get started with Percy. You'll be up and running in a jiffy!

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!

Setup


Percy is designed to integrate with your tests and CI environment. Read the documentation for your CI service to get started.

Platforms


Integrate a Percy client library to take snapshots in tests.

JavaScript

Ruby

Python

Static sites

Everything else

Source code integrations


See our source code integration docs for more info about Percy's review workflow.

Tutorials