Plugins

Plugins provide a way to support and extend the behavior of Cypress. Follow these instructions to submit your own plugin.

Plugin Types

Preprocessors

  • Browserify

    official

    Watches and bundles your spec files via browserify. This is the default preprocessor that's built into Cypress.

    #browserify

  • Cucumber

    community

    Run cucumber/gherkin-syntaxed specs with cypress.io

    #file-watcher#cucumber

  • cypress-app-watcher-preprocessor

    community

    Reruns Cypress tests when the back end server restarts

    #file-watcher

  • cypress-eslint-preprocessor

    community

    Runs linting via ESLint on your spec files as they are loaded and display errors in the console

    #eslint

  • Watch

    official

    Watches your spec files and serves them as-is. Useful as an example reference or if you don't need transpiling/bundling.

    #file-watcher

  • Webpack

    official

    Watches and bundles your spec files via webpack.

    #webpack

  • Rollup

    community

    Watches and bundles your spec files via Rollup

    #rollup

  • cypress-markdown-preprocessor

    community

    Cypress preprocessor for extracting tests from Markdown files

    #markdown

  • cypress-rollup-preprocessor

    community

    Cypress preprocessor for bundling JavaScript via rollup

    #rollup

  • @bahmutov/cypress-esbuild-preprocessor

    community

    Bundle Cypress specs using esbuild

    #esbuild

  • cypress-esbuild-preprocessor

    community

    Uses evanw/esbuild to bundle your specs.

    #esbuild

Development Tools

  • CircleCI Cypress Orb

    official

    Official Cypress Orb for CircleCI configuration.

    #continuous-integration

  • cypress-dark

    verified

    Several color themes for Cypress test runner

    #theme

  • cypress-protobuf

    community

    Encode a fixture with Protocol Buffers.

    #encoding#protobuf

  • Docker

    official

    Docker images providing all the dependencies to run Cypress in CI including browsers.

    #docker#continuous-integration

  • eslint-plugin-cypress

    official

    ESLint plugin that sets globals for writing tests in Cypress.

    #eslint

  • Knapsack Pro Cypress

    community

    Dynamic tests split across parallel CI nodes with Knapsack Pro Queue Mode to get faster CI builds. Note - this is 3rd party implementation, different from the Cypress Dashboard parallelization.

    #CI parallelisation#continuous-integration

  • TypeScript

    official

    Official TypeScript definitions for the Cypress API.

    #typescript

  • cly

    community

    A prototype of generating quicker project scaffolding for Cypress.

    #cypress cli#prototype#CLI#scaffolding

  • cypress-watch-and-reload

    community

    Reloads Cypress when one of the watched files changes

    #file-watcher

  • cypress-autostub

    community

    Alleviates the need to mantain brittle manual mocks by automating the recording and stubbing of requests.

    #mocking#stubbing#recording#fetch#xhr

  • cypress-plugin-livereload

    community

    Reloads Cypress using livereload

    #livereload

  • cypress-select-tests

    community

    User space solution for grepping Cypress tests to run

    #browserify

  • cypress-grep

    community

    Filter tests using its title or tags

    #grep

  • cypress-autorecord

    community

    Simplify API mocking by auto-recording/stubbing HTTP interactions and automating the process of updating/deleting mocks.

    #mock#recording#http#integration test

  • @cypress/code-coverage

    official

    Plugin to save code coverage collected during Cypress tests

    #coverage

  • @cypress/instrument-cra

    official

    NPM module for create-react-app applications to instrument source code without ejecting react-scripts

    #coverage

  • @cypress/fiddle

    official

    Quickly generates Cypress tests from HTML and JS code

    #prototype

  • npm-cy

    community

    This GitHub Action for npm enables arbitrary actions with the npm command-line client, including testing with cypress.io and publishing to a registry.

    #github#actions#npm

  • vscode-cy-helper

    community

    Visual Studio Code extension for cypress and cucumber preprocessor

    #vscode#extension#intellisense

  • cypress-dotenv

    community

    Cypress plugin that enables compatability with dotenv.

    #dotenv#env#environment#env var

  • cypress-har-generator

    community

    Generate HTTP Archive (HAR) while running tests.

    #har#http-archive#http#websocket#recording#chrome

  • cypress-expect-n-assertions

    community

    Cypress helper that checks number of expected and actual assertions in the test

    #test#assertion

  • cypress-audit

    community

    Run Lighthouse audit directly in your E2E test suites

    #lighthouse

  • cypress-hmr-restarter

    community

    Restarts tests when receiving webpack-dev-server HMR updates

    #webpack#webpack-dev-server#hmr

  • @bahmutov/cypress-extends

    community

    Cypress plugin that adds "extends" support to the configuration file

    #config

  • cypress-browser-permissions

    community

    Controls permissions for desktop notifications, geolocation, and other browser APIs

    #permissions#notifications#geolocation#camera#microphone

  • cypress-repeat

    community

    Run Cypress multiple times in a row, great at finding test flake

  • cypress-expect

    community

    Cypress CLI wrapper where you can specify the total number of expected tests

    #cli

  • cy-search

    community

    Search Cypress documentation from the terminal

    #cli

  • cypress-tags

    community

    Use custom tags to slice up Cypress test runs

    #test#tag#browserify

  • @swimlane/cy-mockapi

    community

    Easily mock your REST API in Cypress by putting responses in the fixtures directory tree.

    #mock#rest#api

  • cypress-timings

    community

    A Cypress plugin for reporting individual command timings.

    #commands#performance

  • cypress-fail-fast

    community

    Enables fail fast in Cypress, skipping the rest of tests on first failure.

    #fail-fast#failure#skip#config

  • cypress-fail-on-console-error

    community

    Fail cypress test on console error.

    #console#error#fail

Custom Commands

  • cy-view

    community

    Run tests on multiple URLs at various viewport sizes.

    #viewports

  • cypress-unfetch

    verified

    Track, test, and block code execution based on network state.

    #commands#routing#networking

  • cypress-redux

    community

    Run assertions against Redux stores.

    #commands#redux

  • cypress-axe

    community

    Helps test your applications for accessibility issues using axe-core.

    #accessibility#a11y

  • cypress-drag-drop

    community

    Adds a cypress child command for drag'n'drop support.

    #dragndrop#drag#drop#commands

  • cypress-fill-command

    community

    A Cypress command for fill inputs

    #commands

  • cypress-firebase

    community

    Custom commands for Firebase including Authentication and Database communication (both Real Time Database and Firestore).

    #firebase#database#commands

  • cypress-graphql-mock-network

    community

    Custom commands to mock your GraphQL API at the network level. Using service-workers for complete isolation of the mock server.

    #graphql#mocking#networking#commands

  • cypress-graphql-mock

    community

    Adds commands for executing a mocked GraphQL server using only the client

    #graphql

  • cy-mobile-commands

    community

    Mobile testing helper for Cypress

    #mobile#swipe#touch#commands

  • cypress-pipe

    community

    Create custom commands using plain-old functions. Similar to `cy.then` but with retriability.

    #commands

  • cypress-downloadfile

    community

    A custom command to download different kinds of files and store them on your local machine

    #commands#downloading

  • cypress-testing-library

    verified

    🐅 Simple and complete custom Cypress commands and utilities that encourage good testing practices.

    #testing-library#dom-testing-library#react-testing-library

  • cypress-plugin-stripe-elements

    community

    Simple commands that make it easy to target and fill in Stripe Elements input fields

    #stripe#commands#elements#inputs

  • cypress-xpath

    official

    Adds XPath command. This repo is also a good example of using custom commands to do retries, provide TypeScript definitions, etc.

    #xpath#commands

  • cypressautomocker

    community

    Allow recording API results and replaying the APIs as a mock server.

    #routing#mock

  • cypress-plugin-tab

    experimental

    A Cypress plugin to add a tab command

    #commands

  • cypress-commands

    community

    A collection of Cypress commands to extend and complement the defaults

    #commands

  • cypress-wait-until

    verified

    Add the Cypress waiting power to virtually everything 🎉

    #commands#wait#wait-until#recursive-promise#check-async-value#check-value#open-source-saturday

  • cypress-recurse

    community

    A way to re-run Cypress commands until a predicate function returns true

    #commands#wait#wait-until#recursive-promise#check-async-value#check-value

  • cypress-cy-select

    community

    data-cy shorthand notation for cypress get and find functions

    #commands#shorthand

  • @cypress/skip-test

    official

    Simple commands to skip a test based on platform, browser or a url

    #commands

  • cypress-websocket-testing

    community

    Test WebSocket connections with Cypress

    #commands#websocket

  • @bahmutov/cy-api

    community

    Cypress custom command "cy.api" for HTTP API testing with server logs

    #api

  • cy-spok

    experimental

    Adds assertions from Spok library for easy schema and value validations

    #assertions

  • cypress-localstorage-commands

    community

    Custom commands for localStorage. Allows preserving localStorage between tests

    #commands#localstorage#persistence

  • cypress-iframe

    community

    Custom commands for interacting with iframes

    #commands#iframe

  • cypress-react-selector

    cypress custom commands to locate react elements by component, props and state

    #react#commands#locator

  • cypress-layout-inspector

    community

    A simple utility to provide layout testing functionality to Cypress via custom assertions.

    #testing#ui#dom#assertions

  • @swimlane/cy-dom-diff

    community

    cy-dom-diff allows matching chunks of DOM against HTML; including dynamic content.

    #dom#assertions

  • cypress-real-events

    community

    Fire native system events from Cypress like hover, swipe, etc

    #commands

  • cypress-azure-keyvault

    community

    Cypress custom command to get keys from Azure Key Vaults.

    #testing#azure#keyvault#secret

  • cypress-rest-graphql

    community

    Add visual output and helper functions for performing REST and graphQL queries

    #api#rest#graphQL

Extending other testing frameworks

  • cyphell

    community

    Converts WDIO automation tests to Cypress.

    #wdio

  • cypress-capybara

    community

    Several Capybara finders re-implemented in Cypress to locate UI elements by their text and labels.

    #testing-library#capybara

  • cypress-jest-adapter

    community

    Add jest assertion style to Cypress expect command

    #jest

  • PickleJS

    community

    An addition to the Cucumber plugin, featuring a collection of phrases you can use for common actions (ex: "I click on an <Element>", "I should see an <Element>")

    #cucumber#collection#actions#commands

Authentication

Also take a look at Logging in recipes.

  • cypress-keycloak-commands

    verified

    Cypress commands for authenticate users with Keycloak Identity Provider

    #authentication#login#keycloak#oauth#openid

  • cypress-ntlm-auth

    verified

    NTLM authentication support for Cypress

    #authentication#ntlm

  • cypress-otp

    community

    Valid OTP token generation for Cypress

    #authentication#otp#2fa#mfa

  • cypress-social-logins

    community

    Cypress authentication flows using social network providers

    #authentication#login#social profiles#github#google

Framework tooling

  • Cypress Angular Schematic

    community

    Angular CLI addition that allows you to install Cypress E2E to an Angular CLI project

    #angular#cli

  • cypress-on-rails

    community

    Rubygem for using cypress.io with Ruby on Rails applications

    #ruby-rack#ruby-on-rails

  • Nx

    community

    Smart, Fast and Extensible Build System

    #angular#react#cli#monorepo

  • Vue CLI

    verified

    Vue CLI allows you to scaffold an application with Cypress E2E fully configured

    #vue.js#vue#cli

  • Cypress Nuxt

    community

    Utilities for using Cypress with Nuxt.

    #vue.js#vue#nuxt#nuxt.js

  • Aurelia CLI

    community

    The Aurelia CLI is the official command line tool for Aurelia.

    #aurelia#cli

  • WordPress ReactJS Boilerplate

    community

    Complete WordPress Plugin Boilerplate including Cypress.io E2E tests.

    #wp#wordpress

  • Next Right Now - Next.js Boilerplate

    community

    Next.js boilerplate with Jest/Cypress and CI/CD pipeline built-in (monorepo, multi-tenants)

    #next.js#react#monorepo#multi-tenants

  • Elm Batteries Included

    community

    A project template to learn how Elm, Parcel, Cypress and Netlify work together.

    #elm#parcel#netlify

  • cypress-rails

    community

    Ruby gem to run Cypress against Rails apps, replacing Capybara in system tests

    #ruby#rails

  • cypress-laravel

    community

    Add commands and hooks to test Laravel applications

    #php#laravel

  • cypress-splitio

    community

    Stores your split.io toggles as environment variables. Helps to decide which e2e tests you need to run.

    #split.io#feature flags

  • Bison

    community

    A Full Stack Jamstack Template that uses Cypress and GitHub Actions for E2E testing.

    #next.js#react#graphql#prisma#vercel

  • @cypress/schematic

    official

    Adds Cypress to your Angular project via the Angular CLI

    #angular#cli

Component Testing

⚠️ Loading and mounting components from various frameworks is highly experimental and might change in the future.

Visual Testing

Visual testing is a great complement to functional testing

  • Applitools

    verified

    Fast, easy and reliable visual UI testing with Cypress

  • Percy

    verified

    Visual regression testing for Cypress tests with Percy.

    #screenshots#visual regression

  • Happo

    community

    Cross-platform, cross-browser screenshot testing for modern user interfaces.

    #screenshots#visual regression

  • cypress-plugin-snapshots

    community

    Plugin for snapshot tests in Cypress. Same API as Jest, but with graphical interface for reviewing and approving changes.

    #snapshot

  • Cypress Image Snapshot

    community

    Catch visual regressions and compare image diffs locally and in Cypress Dashboard.

    #image-diff#snapshot

  • Cypress Visual Regression

    community

    Adds visual regression testing to Cypress

    #image-diff#snapshot

  • cypress-blink-test

    community

    Module for adding visual regression testing to Cypress.

    #image-diff#snapshot

  • Visual Regression Tracker

    community

    Integration with open source service for visual testing and managing its results.

    #screenshots#image-diff#visual regression

  • Cypress Image Diff

    community

    Visual regression testing plugin maintained by DIT - UK Gov.

    #screenshots#visual regression#image-diff

  • Micoo

    community

    Cypress plugin for doing visual regression testing with Micoo service

    #visual regression testing#visual testing#screenshots comparison#testing service

Reporting

  • cypress-failed-log

    community

    Saves the Cypress test command log as a JSON file if a test fails.

    #reporter

  • cypress-log-to-output

    community

    Plugin that prints all browser console logs to the terminal while running Cypress tests. Currently, only Chrome is supported.

    #logging

  • autoset-status-cypress-testrail-reporter

    community

    TestRail Reporter which auto-set status for specific TestRun for Cypress.

    #testrail#reporter#autoset#status

  • cypress-testrail-reporter

    community

    Custom reporter for publishing Cypress results to a TestRail test run.

    #testrail#reporter

  • cypress-teamcity-reporter

    community

    Custom reporter for Teamcity which makes it possible to display test results in real-time and add them on the Tests tab of the Build Results page

    #teamcity#reporter

  • mochawesome-merge

    community

    Merges multiple mochawesome JSON reports

    #reporter#mochawesome

  • cypress-slack-healthcheck

    community

    A simple tool which integrates Cypress with Slack to report failing tests.

    #reporter#slack#healthcheck

  • cypress-slack-reporter

    community

    Slack reporting tool. Uses mochawesome json reports, provides links to VCS Provider (github/bitbucket) and CircleCI logs

    #reporter#mochawesome#slack

  • cypress-terminal-report

    community

    Logs cypress commands, route request data and browser console errors and warnings to terminal when tests fail on CI.

    #reporter#logs#terminal#CI#CLI

  • cypress-allure-plugin

    community

    Integrates Allure reporter with Cypress. Command logging and screenshot attachment out of the box.

    #reporter#allure

  • cypress-mochawesome-reporter

    community

    Zero config Mochawesome reporter for Cypress with screenshots.

    #reporter#mochawesome#screenshot

  • cypress-msteams-reporter

    community

    A reporting tool which sends a message to Microsoft Teams with information about the latest cypress test execution results.

    #reporter#ms-teams#allure-report

Email

  • cypress-mailosaur

    community

    Test email and SMS messages using Mailosaur

    #email#sms#commands

  • cypress-maildev

    community

    A bunch of Cypress commands in order to test your messages (SMS and Emails) by using Maildev REST API.

    #email#sms#commands

  • cypress-mailslurp

    community

    Use test email accounts to send and receive emails in Cypress tests with MailSlurp.

    #email#mailslurp#test#commands