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!

Responsive visual testing

šŸ‘

Covered in this doc

How responsive visual testing works in Percy

A powerful feature of Percy is visual testing for responsive user interfaces, allowing you to automatically detect visual regressions on mobile, tablet, and desktop screens at once.

You provide a list of responsive breakpoint widths and we take care of the rest.

How it works


Because Percy stores the original DOM snapshot and page assets, we simply render the same page at different widths by resizing the browser when generating page screenshots. This is handled entirely server-side and hasĀ no effect on the speed of your testsĀ since all rendering and diffing takes place in Percy.

Configuring responsive snapshots

Configuring Percy for responsive visual testing is as easy as specifying your desired responsive breakpoint widths when you call Percy snapshots.

Check the documentation for the specific SDK you're using to learn how to add responsive widths to your snapshot calls.

Limits

  • Maximum of 10 different widths per snapshot.
  • Each width must be between 120px and 2000px inclusive.

Usage

Each responsive width counts as a separate screenshot that counts towards your monthly screenshot usage. For example, a snapshot of your homepage at 375px and 1280px will count as 2 screenshots.

Updated 7 months ago

Responsive visual testing


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.