# Visual Tests

Visual regression testing in Buddy - capture snapshots from E2E tests, Storybook, or plain URLs, compare them against approved baselines, and review changes before they ship.

## Contents

- [Getting started](/docs/tests/visual-tests/getting-started.md) - Learn what Visual Tests in Buddy are, why they catch bugs functional tests miss, and how suites, sessions, and approvals work together.
- [E2E frameworks](/docs/tests/visual-tests/e2e-frameworks.md) - Add Buddy visual testing plugins to your existing E2E tests - Playwright, Selenium, Cypress, and Puppeteer.
  - [Playwright](/docs/tests/visual-tests/e2e-frameworks/playwright.md) - Add Buddy visual testing to your Playwright tests - install the plugin, take snapshots, and run sessions with the bdy CLI.
  - [Selenium](/docs/tests/visual-tests/e2e-frameworks/selenium.md) - Add Buddy visual testing to Selenium tests in Java, C#, or JavaScript - install the plugin, take snapshots, and run sessions with the bdy CLI.
  - [Cypress](/docs/tests/visual-tests/e2e-frameworks/cypress.md) - Add Buddy visual testing to your Cypress tests - install the plugin, take snapshots with cy.takeSnap, and run sessions with the bdy CLI.
  - [Puppeteer](/docs/tests/visual-tests/e2e-frameworks/puppeteer.md) - Add Buddy visual testing to your Puppeteer scripts - install the plugin, take snapshots, and run sessions with the bdy CLI.
- [Storybook](/docs/tests/visual-tests/storybook.md) - Run visual tests on your Storybook in Buddy - upload the built Storybook, compare stories against approved baselines, and get a hosted Storybook for every version.
- [Scriptless Testing](/docs/tests/visual-tests/scriptless-testing.md) - Visual testing without any test code - point Buddy at URLs or a sitemap and let it capture and compare snapshots, via CLI or a pipeline action.
- [Running Visual Tests](/docs/tests/visual-tests/running-visual-tests.md) - Where to run Buddy Visual Tests - in Buddy pipelines, GitHub Actions, or locally with the CLI.
  - [Buddy Pipelines](/docs/tests/visual-tests/running-visual-tests/buddy-pipelines.md) - Integrate visual tests into Buddy pipelines - select a suite in a build action, add an approval gate, and see complete pipeline examples.
  - [GitHub Actions](/docs/tests/visual-tests/running-visual-tests/github-actions.md) - Run Buddy Visual Tests from GitHub Actions workflows and block merges until visual changes are approved.
  - [Local](/docs/tests/visual-tests/running-visual-tests/local.md) - Run Buddy Visual Tests from your local machine with the bdy CLI - environment setup, a Cypress example, and scriptless captures.
- [Suite Settings](/docs/tests/visual-tests/suite-settings.md) - Every Visual Tests suite setting explained - browsers, devices, baseline branch, threshold, timeouts, and per-snapshot overrides.
- [Sessions, Snapshots & Baselines](/docs/tests/visual-tests/sessions-snapshots-baselines.md) - How Visual Tests sessions and snapshots work, and how the baseline for each snapshot is determined.
- [Reviewing & Approvals](/docs/tests/visual-tests/reviewing-approvals.md) - Review visual test sessions in Buddy - navigate diffs, approve or reject snapshots, configure auto-approve branches, and gate deployments on approval.
- [Troubleshooting](/docs/tests/visual-tests/troubleshooting.md) - Fix common Visual Tests problems - dynamic content, flaky rendering diffs, authenticated pages, and lazy-loaded elements.
  - [Dynamic Content](/docs/tests/visual-tests/troubleshooting/dynamic-content.md) - Stop dynamic and animated page fragments from generating visual diffs on every run by ignoring them with XPath or CSS selectors.
  - [Flaky rendering](/docs/tests/visual-tests/troubleshooting/flaky-rendering.md) - Deal with false-positive visual diffs caused by rendering noise - antialiasing, shadows, and rounded corners - by tuning the diff threshold.
  - [Authentication & Network](/docs/tests/visual-tests/troubleshooting/authentication-network.md) - Run visual tests on pages behind a login - configure request headers, cookies, and local storage keys so snapshots capture authenticated views.
  - [Lazy loading](/docs/tests/visual-tests/troubleshooting/lazy-loading.md) - Handle lazy-loaded and late-rendering content in visual tests with wait-for-selector, delays, and timeouts.

---
Original source: https://buddy.works/docs/tests/visual-tests