Open
Description
Description
What would you like?
- Remove the section Get Started > Install Cypress > Direct download
- Alternatively, move the section Direct downloadto the References > Advanced Installation page.
Why is this needed?
- Direct download is not compatible with Cypress Cloud which is a major focus for the Cypress organization.
- Judging by lack of issue reports in GitHub and in Discord, "Direct download" is not commonly used.
- In order to install and run an application, users will generally already have Node.js and a package manager installed. There may be no requirement in practice to be able to run Cypress standalone, without Node.js and a package manager.
- The section takes up real estate on the "Install Cypress" page and diverts attention from core steps that belong to "Getting Started".
- When the Cypress binary is run directly, it outputs a warning which links back to the page where "Direct download" is described, so the instructions for "Direct download" (if retained) should not be on the same page as the instructions for regular installation via a package manager, otherwise this is a confusing circular reference:
It looks like you are running the Cypress binary directly.
This is not the recommended approach, and Cypress may not work correctly.Please install the cypress NPM package and follow the instructions here:
Other
- The recommendation to install Cypress with npm does not consider other supported package managers - Yarn and pnpm. If the article is retained and moved, this statement should be generalized.
- Placing the recommendation to install Cypress with npm inside the "Direct download" section is confusing because it is actually recommended not to use direct download.
- There is no description that running Cypress this way opens Cypress in global mode, or what other functionality is affected (in addition to missing Cypress Cloud), like missing CLI commands:
Then you can manually unzip and double click. Cypress will run without needing to install any dependencies.
If the section Get Started > Install Cypress > Direct download is not removed and instead moved to References > Advanced Installation, then it would need rewording.