{"id":22362902,"url":"https://github.com/lambdatest/cypress-cloud","last_synced_at":"2025-07-30T15:30:44.627Z","repository":{"id":39790937,"uuid":"491609113","full_name":"LambdaTest/Cypress-Cloud","owner":"LambdaTest","description":"Running Cypress tests at LambdaTest. Example and documentation on running Cypress tests at massive scale on LambdaTest automation cloud.","archived":false,"fork":false,"pushed_at":"2024-03-26T11:40:56.000Z","size":1693,"stargazers_count":21,"open_issues_count":0,"forks_count":42,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-03-26T12:54:39.350Z","etag":null,"topics":["automation","cloud","cucumber","cypress","cypress-example","cypress-examples","cypress-io","cypress-plugin","cypress-tests","javascript","lambdatest","testing"],"latest_commit_sha":null,"homepage":"https://www.lambdatest.com/cypress-testing","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LambdaTest.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG_OLD.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2022-05-12T17:31:31.000Z","updated_at":"2023-09-05T16:50:26.000Z","dependencies_parsed_at":"2024-03-26T12:48:14.736Z","dependency_job_id":"52c66801-13e2-4713-be6d-f10c984dfd95","html_url":"https://github.com/LambdaTest/Cypress-Cloud","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LambdaTest%2FCypress-Cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LambdaTest%2FCypress-Cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LambdaTest%2FCypress-Cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LambdaTest%2FCypress-Cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LambdaTest","download_url":"https://codeload.github.com/LambdaTest/Cypress-Cloud/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228154024,"owners_count":17877704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","cloud","cucumber","cypress","cypress-example","cypress-examples","cypress-io","cypress-plugin","cypress-tests","javascript","lambdatest","testing"],"created_at":"2024-12-04T17:12:28.936Z","updated_at":"2024-12-04T17:12:29.526Z","avatar_url":"https://github.com/LambdaTest.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Run Cypress Tests On LambdaTest ![cypress](https://img.shields.io/badge/-cypress-%23E5E5E5?style=for-the-badge\u0026logo=cypress\u0026logoColor=058a5e)\n\n\u003cimg height=\"500\" class =\"centre\" src=\"https://user-images.githubusercontent.com/70570645/171032160-65d8a2c3-e04b-482d-b1c6-538b75be5fb0.png\"\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.lambdatest.com/blog/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud\" target=\"_bank\"\u003eBlog\u003c/a\u003e\n  \u0026nbsp; \u0026#8901; \u0026nbsp;\n  \u003ca href=\"https://www.lambdatest.com/support/docs/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud\" target=\"_bank\"\u003eDocs\u003c/a\u003e\n  \u0026nbsp; \u0026#8901; \u0026nbsp;\n  \u003ca href=\"https://www.lambdatest.com/learning-hub/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud\" target=\"_bank\"\u003eLearning Hub\u003c/a\u003e\n  \u0026nbsp; \u0026#8901; \u0026nbsp;\n  \u003ca href=\"https://www.lambdatest.com/newsletter/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud\" target=\"_bank\"\u003eNewsletter\u003c/a\u003e\n  \u0026nbsp; \u0026#8901; \u0026nbsp;\n  \u003ca href=\"https://www.lambdatest.com/certifications/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud\" target=\"_bank\"\u003eCertifications\u003c/a\u003e\n  \u0026nbsp; \u0026#8901; \u0026nbsp;\n  \u003ca href=\"https://www.youtube.com/c/LambdaTest\" target=\"_bank\"\u003eYouTube\u003c/a\u003e\n\u003c/p\u003e\n\u0026emsp;\n\u0026emsp;\n\u0026emsp;\n\n*Learn how to get started with Cypress testing on the LambdaTest platform 🚀*\n\n[\u003cimg height=\"70\" width=\"220\" src=\"https://user-images.githubusercontent.com/70570645/171866795-52c11b49-0728-4229-b073-4b704209ddde.png\"\u003e](https://accounts.lambdatest.com/register)\n\n## Table of Contents 🗏\n\n\n* [Pre-requisites](#pre-requisites)\n* [Running Your First Cypress Test On LambdaTest Platform](#running-your-first-cypress-test-on-lambdatest)\n* [Local Testing With Cypress](#running-your-cypress-tests-locally)\n* [Authentication](#authentication)\n* [Cypress Parallel Testing](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/parallel-testing.md)\n* [Specify Browsers And OS](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/supported-browsers-os.md)\n* [Supported Cypress Versions](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/supported-cypress-versions.md)\n* [Cypress CLI Commands](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/cypress-cli.md)\n* [Run Settings](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/run-settings.md)\n* [Download Artefact For Cypress Project](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/download-artefacts.md)\n* [Integrate LambdaTest With Cypress Dashboard](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/cypress-dashboard.md)\n* [Execute Cypress Tests Including Private Dependencies](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/dependencies.md)\n* [Applitools Integration For Cypress](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/applitools-integration.md)\n* [ReportPortal.io Integration With LambdaTest For Cypress](https://github.com/LambdaTest/Cypress-Cloud/blob/master/cypress-docs/reportportalio-integration.md)\n\n\n## Pre-requisites\n\nBefore we get started, make sure to clone the LambdaTest Cypress Cloud Repo. You can run your first Cypress test on the LambdaTest platform in a few simple steps:\n\n- **Step 1:** Clone the LambdaTest-Cypress Cloud repo and navigate to the cloned directory.\n\n  ```bash\n  git clone https://github.com/LambdaTest/Cypress-Cloud\n  cd Cypress-Cloud\n  ```\n\n- **Step 2: Installing the LambdaTest CLI -**\n  You need to install the **LambdaTest-Cypress CLI** package with the help of npm, using the below command:\n\n  ```bash\n  npm install -g lambdatest-cypress-cli\n  ```\n\n- **Step 3: Setup configurations on which you want to run your test -**\n  Once you have installed the LambdaTest-Cypress CLI, now you need to setup the configuration. You can do that using the below command:\n\n  ```bash\n  lambdatest-cypress init\n  ```\n## Running Your First Cypress Test On LambdaTest\n\n\n\u003e**Test Scenario**: To demonstrate Cypress testing on LambdaTest, we will use the Cypress Kitchen Sink Example.\n\n1.  Clone the LambdaTest Cypress Cloud GitHub repo and switch to the cloned directory.\n\n```bash\ngit clone https://github.com/LambdaTest/Cypress-Cloud\ncd Cypress-Cloud\n```\n\n2.  Setup the **LambdaTest-Cypress CLI** and configure the configuration file, as shown in the pre-requisites before. A file named `lambdatest-config.json` is generated in your project using the below command:\n\n```bash\nlambdatest-cypress init\n```\n\nHere, we have used the below configuration as default and generated it in the `lambdatest-config.json` file. You need to set up the authentication by using LambdaTest credentials. You can check the [Authentication documentation](https://www.lambdatest.com/support/docs/authentication) for more details about authentication.\n\n```json\n{\n  \"lambdatest_auth\": {\n    \"username\": \"\u003cYOUR_LAMBDATEST_USERNAME\u003e\",\n    \"access_key\": \"\u003cYour LambdaTest access key\u003e\"\n  },\n  \"browsers\": [\n    {\n      \"browser\": \"Chrome\",\n      \"platform\": \"Windows 10\",\n      \"versions\": [\"latest\"]\n    },\n    {\n      \"browser\": \"Firefox\",\n      \"platform\": \"Windows 10\",\n      \"versions\": [\"latest\"]\n    }\n  ],\n  \"run_settings\": {\n    \"cypress_config_file\": \"cypress.json\",\n    \"build_name\": \"build-name\",\n    \"parallels\": 1,\n    \"specs\": \"./*.spec.js\",\n    \"ignore_files\": \"\",\n    \"npm_dependencies\": {\n      \"cypress\": \"9.1.0\"\n    },\n    \"feature_file_suppport\": false\n  },\n  \"tunnel_settings\": {\n    \"tunnel\": false,\n    \"tunnelName\": null\n  }\n}\n```\n\nAlso in `run-settings` section you need to specify the path of your `spec.js` file on which you want to run the test on. Here we will pass the path of a **all examples** spec.js file for our demo.\n\n```json\n\"specs\": \"./cypress/integration/examples/*.spec.js\"\n```\n\n\u003e In this demo, all occurrences of http://localhost:8080 have been replaced with [https://example.cypress.io](https://example.cypress.io) to prevent running the Cypress tests locally. Alternatively, if you want to run your tests locally, refer to the [**Run Cypress tests locally**](https://www.lambdatest.com/support/docs/running-your-first-cypress-test/#running-your-cypress-tests-locally-on-lambdatest-platform) section below.\n\n3. Execute your tests using the following command in the terminal:\n\n```bash\nlambdatest-cypress run\n```\n\n## View Your Cypress Testing Result\n\n\nAs soon as the tests starts executing, you can view them running. Visit your LambdaTest Automation Dashboard.\n\n\n\u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/70570645/169592614-d41ad246-32c5-46e1-935c-6f0101f467e6.png\"\u003e\n\nFor each test, you can view the live video feed, screenshots for each test run, console logs, terminal logs and do much more using the **LambdaTest platform**.\n\nIf the test gets executed successfully, you will see a green tick on the Timeline view and a \"Completed\" message on the Automation logs view of your Automation dashboard. If not, then you will see a red cross and a \"Failed\" message respectively.\n      \n\u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/70570645/169593512-94f845b7-3bcc-40f8-a5c1-0c9ab872e3ff.png\"\u003e\n\n\n## Running Your Cypress Tests Locally\n\n\nTo run your tests locally on the LambdaTest platform, you need to setup LambdaTest tunnel, and execute commands using the CLI, or [download UnderPass](https://downloads.lambdatest.com/underpass/master/UnderPass%20Setup.exe), our GUI based desktop app. Once you have the LambdaTest tunnel or Underpass set up and started, you can use the LambdaTest platform to run your Cypress tests locally.\n\nNow you need to activate the tunnel capability in the lambdatest_config.json file under the section \"connection_settings\" as shown below:\n\n```json\n  \"connection_settings\": {\n    \"tunnel\": true,\n    \"tunnel_name\": \"lt-cypress-tunnel\"\n  },\n```\n\nYou can provide the name of the **LambdaTest tunnel** as per your requirements.\n\n## Authentication\n\n    \nAuthenticate your Cypress test runs in the following ways -\n\n1. Set up the **environment variables**. (or)\n2. Utilizing the **CLI params**. (or)\n3. Mention yourusername and access key in the **lambdatest-config.json**.\n\n\u003e **Warning:** We use the following order of precedence to determine which auth credentials to use if you use more than one option to pass your auth credentials:\n\nCLI arguments \u003e Options set in lambdatest-config.json \u003e Environment variables\n\n### Utilizing CLI Params:\n\nThe following args can be used while running tests using the run command.\n\n| Arg        | Shorthand | Accepted values            |\n| ---------- | --------- | -------------------------- |\n| --username | -u        | Your LambdaTest username   |\n| --access_key      | -k        | Your LambdaTest access key |\n\nFor example -\n\n```bash\n lambdatest-cypress run --username YOUR_USERNAME --access_key YOUR_ACCESS_KEY\n```\n\n### Using lambdatest-config.json:\n\nThe auth option will help you in specifying your username and access key. You can find your username and access key in the [LambdaTest Automation Dashboard](https://automation.lambdatest.com/build). Both, the auth credentials set in environment variables and the ones mentioned in the lambdatest-config.json file will get overridden.\n      \n\u003cimg height=\"400\" src=\"https://user-images.githubusercontent.com/70570645/169593640-9672bc33-49c1-4abe-8887-645a33defab7.png\"\u003e\n\n      \nThe options supported in the auth are as follows:\n\n| Arg        | Accepted values            |\n| ---------- | -------------------------- |\n| username   | Your LambdaTest username   |\n| access_key | Your LambdaTest access key |\n\nFor example -\n\n```json\n\"lambdatest_auth\": {\n      \"username\": \"\u003cyour username\u003e\",\n      \"access_key\": \"\u003cyour access key\u003e\"\n   },\n```\n\n### Setup the Environment Variables:\n\nWhile utilizing the CLI params, you can set up the following environment variables.\n\n| Env variable  | Accepted values            |\n| ------------- | -------------------------- |\n| LT_USERNAME   | Your LambdaTest username   |\n| LT_ACCESS_KEY | Your LambdaTest access key |\n\nOr you can also set environment variables using following commands:\n\n- For **Linux/macOS**:\n\n```bash\nexport LT_USERNAME=\"YOUR_USERNAME\" export LT_ACCESS_KEY=\"YOUR ACCESS KEY\"\n```\n\n- For **Windows**:\n\n```bash\nset LT_USERNAME=\"YOUR_USERNAME\" set LT_ACCESS_KEY=\"YOUR ACCESS KEY\"\n```\n      \n\u003e **Note** - By doing so, the auth credentials you use in your lambdatest-config.json file will get overridden only if these options are not provided in lambdatest-config.json.\u003cbr\u003e\n\n\n## Tutorials 📙\n\nCheck out our latest tutorials on Cypress automation testing 👇\n\n* [Cypress Vs Selenium: Which is Better in 2022?](https://www.lambdatest.com/blog/cypress-vs-selenium-comparison/)\n* [Introduction to Cypress Test Automation Framework](https://www.lambdatest.com/blog/cypress-test-automation-framework/)\n* [Scalable and Reliable Cross Browser Testing with Cypress](https://www.lambdatest.com/blog/cross-browser-testing-with-cypress-framework/)\n* [Now Run Your Cypress Tests on LambdaTest](https://www.lambdatest.com/blog/cypress-cli-on-lambdatest/)\n* [How to Perform Cypress Testing at Scale with LambdaTest](https://www.lambdatest.com/blog/how-to-perform-cypress-testing-at-scale-with-lambdatest/)\n* [Complete Guide to Cypress Visual Regression Testing](https://www.lambdatest.com/blog/cypress-visual-regression-testing/)\n* [How to Fill and Submit Forms in Cypress](https://www.lambdatest.com/blog/fill-and-submit-forms-in-cypress/)\n* [How to Find HTML Elements Using Cypress Locators](https://www.lambdatest.com/blog/finding-html-elements-using-cypress-locators/)\n* [Handling Touch and Mouse Events in Cypress [Tutorial]](https://www.lambdatest.com/blog/handling-touch-and-mouse-events-in-cypress/)\n* [How to Find Broken Links using Cypress [With Examples]](https://www.lambdatest.com/blog/find-broken-links-using-cypress/)\n* [Web Performance Testing with Cypress and Google Lighthouse](https://www.lambdatest.com/blog/using-cypress-google-lighthouse-performance-testing/)\n\nFor video tutorials on Cypress testing, please refer to our [Cypress Testing Tutorial Playlist](https://www.youtube.com/playlist?list=PLZMWkkQEwOPnxrxi544nL1vdC1noooXPx). ▶️\n\nSubscribe To Our [LambdaTest YouTube Channel 🔔](https://www.youtube.com/c/LambdaTest) and keep up-to-date on the latest video tutorial around Cypress.\n\n## Documentation \u0026 Resources :books:\n\n      \nVisit the following links to learn more about LambdaTest's features, setup and tutorials around test automation, mobile app testing, responsive testing, and manual testing.\n\n* [LambdaTest Documentation](https://www.lambdatest.com/support/docs/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud)\n* [LambdaTest Blog](https://www.lambdatest.com/blog/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud)\n* [LambdaTest Learning Hub](https://www.lambdatest.com/learning-hub/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud)    \n\n## LambdaTest Community :busts_in_silhouette:\n\nThe [LambdaTest Community](https://community.lambdatest.com/) allows people to interact with tech enthusiasts. Connect, ask questions, and learn from tech-savvy people. Discuss best practices in web development, testing, and DevOps with professionals from across the globe 🌎\n\n## What's New At LambdaTest ❓\n\nTo stay updated with the latest features and product add-ons, visit [Changelog](https://changelog.lambdatest.com/) \n      \n## About LambdaTest\n\n[LambdaTest](https://www.lambdatest.com/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud) is a leading test execution and orchestration platform that is fast, reliable, scalable, and secure. It allows users to run both manual and automated testing of web and mobile apps across 3000+ different browsers, operating systems, and real device combinations. Using LambdaTest, businesses can ensure quicker developer feedback and hence achieve faster go to market. Over 500 enterprises and 1 Million + users across 130+ countries rely on LambdaTest for their testing needs.    \n\n### Features\n\n* Run Selenium, Cypress, Puppeteer, Playwright, and Appium automation tests across 3000+ real desktop and mobile environments.\n* Real-time cross browser testing on 3000+ environments.\n* Test on Real device cloud\n* Blazing fast test automation with HyperExecute\n* Accelerate testing, shorten job times and get faster feedback on code changes with Test At Scale.\n* Smart Visual Regression Testing on cloud\n* 120+ third-party integrations with your favorite tool for CI/CD, Project Management, Codeless Automation, and more.\n* Automated Screenshot testing across multiple browsers in a single click.\n* Local testing of web and mobile apps.\n* Online Accessibility Testing across 3000+ desktop and mobile browsers, browser versions, and operating systems.\n* Geolocation testing of web and mobile apps across 53+ countries.\n* LT Browser - for responsive testing across 50+ pre-installed mobile, tablets, desktop, and laptop viewports\n\n    \n[\u003cimg height=\"70\" width=\"220\" src=\"https://user-images.githubusercontent.com/70570645/171866795-52c11b49-0728-4229-b073-4b704209ddde.png\"\u003e](https://accounts.lambdatest.com/register)\n\n      \n## We are here to help you :headphones:\n\n* Got a query? we are available 24x7 to help. [Contact Us](support@lambdatest.com)\n* For more info, visit - [LambdaTest](https://www.lambdatest.com/?utm_source=github\u0026utm_medium=repo\u0026utm_campaign=cypress-cloud)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flambdatest%2Fcypress-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flambdatest%2Fcypress-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flambdatest%2Fcypress-cloud/lists"}