Plugins provide a way to support and extend the behavior of Cypress. Follow these instructions to submit your own plugin.
Looking for the API docs?Check out our Plugins Guide or our API docs for writing a plugin.
Plugin Types
Authentication
Also take a look at "Logging in" recipes.
-
cypress-keycloak-commands
verifiedCypress commands for authenticate users with Keycloak Identity Provider
#authentication #login #keycloak #oauth #openid -
cypress-ntlm-auth
verifiedNTLM authentication support for Cypress
#authentication #ntlm -
cypress-otp
communityValid OTP token generation for Cypress
#authentication #otp #2fa #mfa -
cypress-social-logins
communityCypress authentication flows using social network providers
#authentication #login #social profiles #github #google
Component Testing
⚠️ Loading and mounting components from various frameworks is highly experimental and might change in the future.
-
cypress-angular-unit-test
experimentalTest Angular component using Cypress Test Runner
#component #angular -
cypress-angularjs-unit-test
experimentalUnit test Angularjs code using Cypress Test Runner
#component #angular.js -
cypress-cycle-unit-test
experimentalTest Cycle.js components using Cypress Test Runner
#component #cycle.js -
cypress-hyperapp-unit-test
experimentalTest Hyperapp components and applications using Cypress Test Runner
#component #hyperapp -
cypress-react-unit-test
experimentalTest React components using Cypress Test Runner
#component #react -
cypress-svelte-unit-test
experimentalTest Svelte components using Cypress Test Runner
#component #svelte -
cypress-vue-unit-test
experimentalTest Vue.js components using Cypress Test Runner
#component #vue #vue.js
Custom Commands
-
@bahmutov/cy-api
communityCypress custom command "cy.api" for HTTP API testing with server logs
#api -
@cypress/skip-test
officialSimple commands to skip a test based on platform, browser or a url
#commands -
cy-mobile-commands
communityMobile testing helper for Cypress
#mobile #swipe #touch #commands -
cy-spok
experimentalAdds assertions from Spok library for easy schema and value validations
#assertions -
cy-view
communityRun tests on multiple URLs at various viewport sizes.
#viewports -
cypress-axe
communityHelps test your applications for accessibility issues using axe-core.
#accessibility #a11y -
cypress-commands
communityA collection of Cypress commands to extend and complement the defaults
#commands -
cypress-cy-select
communitydata-cy shorthand notation for cypress get and find functions
#commands #shorthand -
cypress-downloadfile
communityA custom command to download different kinds of files and store them on your local machine
#commands #downloading -
cypress-drag-drop
communityAdds a cypress child command for drag'n'drop support.
#dragndrop #drag #drop #commands -
cypress-file-upload
communitySimple custom command to ease file upload testing
#fileupload #file #upload #commands -
cypress-fill-command
communityA Cypress command for fill inputs
#commands -
cypress-firebase
communityCustom commands for Firebase including Authentication and Database communication (both Real Time Database and Firestore).
#firebase #database #commands -
cypress-graphql-mock
communityAdds commands for executing a mocked GraphQL server using only the client
#graphql -
cypress-iframe
communityCustom commands for interacting with iframes
#commands #iframe -
cypress-layout-inspector
communityA simple utility to provide layout testing functionality to Cypress via custom assertions.
#testing #ui #dom #assertions -
cypress-localstorage-commands
communityCustom commands for localStorage. Allows preserving localStorage between tests
#commands #localstorage #persistence -
cypress-mailosaur
communityTest email and SMS messages using Mailosaur
#email #sms #commands -
cypress-pipe
communityCreate custom commands using plain-old functions. Similar to `cy.then` but with retriability.
#commands -
cypress-plugin-tab
experimentalA Cypress plugin to add a tab command
#commands -
cypress custom commands to locate react elements by component, props and state
#react #commands #locator -
cypress-redux
communityRun assertions against Redux stores.
#commands #redux -
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-unfetch
verifiedTrack, test, and block code execution based on network state.
#commands #routing #networking -
cypress-wait-until
verifiedAdd the Cypress waiting power to virtually everything 🎉
#commands #wait #wait-until #recursive-promise #check-async-value #check-value #open-source-saturday -
cypress-websocket-testing
communityTest WebSocket connections with Cypress
#commands #websocket -
cypress-xpath
officialAdds XPath command. This repo is also a good example of using custom commands to do retries, provide TypeScript definitions, etc.
#xpath #commands -
cypressautomocker
communityAllow recording API results and replaying the APIs as a mock server.
#routing #mock
Development Tools
-
@bahmutov/cypress-extends
communityCypress plugin that adds "extends" support to the configuration file
#config -
@cypress/code-coverage
officialPlugin to save code coverage collected during Cypress tests
#coverage -
@cypress/fiddle
officialQuickly generates Cypress tests from HTML and JS code
#prototype -
@cypress/instrument-cra
officialNPM module for create-react-app applications to instrument source code without ejecting react-scripts
#coverage -
CircleCI Cypress Orb
officialOfficial Cypress Orb for CircleCI configuration.
#continuous-integration -
cly
communityA prototype of generating quicker project scaffolding for Cypress.
#cypress cli #prototype #CLI #scaffolding -
cy-search
communitySearch Cypress documentation from the terminal
#cli -
cypress-audit
communityRun Lighthouse audit directly in your E2E test suites
#lighthouse -
cypress-autorecord
communitySimplify API mocking by auto-recording/stubbing HTTP interactions and automating the process of updating/deleting mocks.
#mock #recording #http #integration test -
cypress-autostub
communityAlleviates the need to mantain brittle manual mocks by automating the recording and stubbing of requests.
#mocking #stubbing #recording #fetch #xhr -
cypress-browser-permissions
communityControls permissions for desktop notifications, geolocation, and other browser APIs
#permissions #notifications #geolocation #camera #microphone -
cypress-dark
verifiedSeveral color themes for Cypress test runner
#theme -
cypress-dotenv
communityCypress plugin that enables compatability with dotenv.
#dotenv #env #environment #env var -
cypress-expect
communityCypress CLI wrapper where you can specify the total number of expected tests
#cli -
cypress-expect-n-assertions
communityCypress helper that checks number of expected and actual assertions in the test
#test #assertion -
cypress-har-generator
communityGenerate HTTP Archive (HAR) while running tests.
#har #http-archive #http #websocket #recording #chrome -
cypress-hmr-restarter
communityRestarts tests when receiving webpack-dev-server HMR updates
#webpack #webpack-dev-server #hmr -
cypress-plugin-livereload
communityReloads Cypress using livereload
#livereload -
cypress-plugin-retries
verifiedA Cypress plugin to retry failed tests.
#cypress-plugin-retries -
cypress-protobuf
communityEncode a fixture with Protocol Buffers.
#encoding #protobuf -
cypress-repeat
communityRun Cypress multiple times in a row, great at finding test flake
-
cypress-select-tests
communityUser space solution for grepping Cypress tests to run
#browserify -
cypress-watch-and-reload
communityReloads Cypress when one of the watched files changes
#file-watcher -
Docker
officialDocker images providing all the dependencies to run Cypress in CI including browsers.
#docker #continuous-integration -
ESLint
officialESLint plugin that sets globals for writing tests in Cypress.
#eslint -
Knapsack Pro Cypress
communityDynamic 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 -
npm-cy
communityThis 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 -
TypeScript
officialOfficial TypeScript definitions for the Cypress API.
#typescript -
vscode-cy-helper
communityVisual Studio Code extension for cypress and cucumber preprocessor
#vscode #extension #intellisense
Extending other testing frameworks
-
cyphell
communityConverts WDIO automation tests to Cypress.
#wdio -
cypress-capybara
communitySeveral Capybara finders re-implemented in Cypress to locate UI elements by their text and labels.
#testing-library #capybara -
cypress-jest-adapter
communityAdd jest assertion style to Cypress expect command
#jest -
PickleJS
communityAn addition to the Cucumber plugin, featuring a collection of phrases you can use for common actions (ex: "I click on an
#cucumber #collection #actions #commands", "I should see an ")
Framework tooling
-
Aurelia CLI
communityThe Aurelia CLI is the official command line tool for Aurelia.
#aurelia #cli -
Bison
communityA Full Stack Jamstack Template that uses Cypress and GitHub Actions for E2E testing.
#next.js #react #graphql #prisma #vercel -
Cypress Angular Schematic
communityAngular CLI addition that allows you to install Cypress E2E to an Angular CLI project
#angular #cli -
Cypress Nuxt
communityUtilities for using Cypress with Nuxt.
#vue.js #vue #nuxt #nuxt.js -
cypress-laravel
communityAdd commands and hooks to test Laravel applications
#php #laravel -
cypress-on-rails
communityRubygem for using cypress.io with Ruby on Rails applications
#ruby-rack #ruby-on-rails -
cypress-rails
communityRuby gem to run Cypress against Rails apps, replacing Capybara in system tests
#ruby #rails -
Elm Batteries Included
communityA project template to learn how Elm, Parcel, Cypress and Netlify work together.
#elm #parcel #netlify -
Next Right Now - Next.js Boilerplate
communityNext.js boilerplate with Jest/Cypress and CI/CD pipeline built-in (monorepo, multi-tenants)
#next.js #react #monorepo #multi-tenants -
Nx
communityNrwl Extensions for Angular
#angular #cli -
Vue CLI
verifiedVue CLI allows you to scaffold an application with Cypress E2E fully configured
#vue.js #vue #cli -
WordPress ReactJS Boilerplate
communityComplete WordPress Plugin Boilerplate including Cypress.io E2E tests.
#wp #wordpress
Preprocessors
-
Browserify
officialWatches and bundles your spec files via browserify. This is the default preprocessor that's built into Cypress.
#browserify -
Cucumber
communityRun cucumber/gherkin-syntaxed specs with cypress.io
#file-watcher #cucumber -
cypress-app-watcher-preprocessor
communityReruns Cypress tests when the back end server restarts
#file-watcher -
cypress-rollup-preprocessor
communityCypress preprocessor for bundling JavaScript via rollup
#rollup -
ESLint
communityRuns linting via ESLint on your spec files as they are loaded and display errors in the console
#eslint -
Rollup
communityWatches and bundles your spec files via Rollup
#rollup -
Watch
officialWatches your spec files and serves them as-is. Useful as an example reference or if you don't need transpiling/bundling.
#file-watcher -
Webpack
officialWatches and bundles your spec files via webpack.
#webpack
Reporting
-
cypress-allure-plugin
communityIntegrates Allure reporter with Cypress. Command logging and screenshot attachment out of the box.
#reporter #allure -
cypress-failed-log
communitySaves the Cypress test command log as a JSON file if a test fails.
#reporter -
cypress-log-to-output
communityPlugin that prints all browser console logs to the terminal while running Cypress tests. Currently, only Chrome is supported.
#logging -
cypress-slack-healthcheck
communityA simple tool which integrates Cypress with Slack to report failing tests.
#reporter #slack #healthcheck -
cypress-slack-reporter
communitySlack reporting tool. Uses mochawesome json reports, provides links to VCS Provider (github/bitbucket) and CircleCI logs
#reporter #mochawesome #slack -
cypress-terminal-report
communityLogs cypress commands, route request data and browser console errors and warnings to terminal when tests fail on CI.
#reporter #logs #terminal #CI #CLI -
cypress-testrail-reporter
communityCustom reporter for publishing Cypress results to a TestRail test run.
#testrail #reporter -
mochawesome-merge
communityMerges multiple mochawesome JSON reports
#reporter #mochawesome
Visual Testing
Visual testing is a great complement to functional testing
-
Applitools
verifiedFast, easy and reliable visual UI testing with Cypress
-
Cypress Image Diff
communityVisual regression testing plugin maintained by DIT - UK Gov.
#screenshots #visual regression #image-diff -
Cypress Image Snapshot
communityCatch visual regressions and compare image diffs locally and in Cypress Dashboard.
#image-diff #snapshot -
Cypress Visual Regression
communityAdds visual regression testing to Cypress
#image-diff #snapshot -
cypress-blink-test
communityModule for adding visual regression testing to Cypress.
#image-diff #snapshot -
cypress-plugin-snapshots
communityPlugin for snapshot tests in Cypress. Same API as Jest, but with graphical interface for reviewing and approving changes.
#snapshot -
Happo
communityCross-platform, cross-browser screenshot testing for modern user interfaces.
#screenshots #visual regression -
Percy
verifiedVisual regression testing for Cypress tests with Percy.
#screenshots #visual regression -
Visual Regression Tracker
communityIntegration with open source service for visual testing and managing its results.
#screenshots #image-diff #visual regression