cypress-io /cypress-realworld-app
A payment application to demonstrate real-world usage of Cypress testing methods, patterns, and workflows.
★ 5,917⑂ 2,637👁 85⑃ 1,505● 188▤ 19
+0
日增长
5,917
stars
2,637
forks
85
watchers
1,505
prs
188
issues
19
releases
README
A payment application to demonstrate real-world usage of Cypress testing methods, patterns, and workflows. 💬 Note from maintainers This application is purely for demonstration and educational purposes. Its setup and configuration resemble typical real-world applications, but it's not a full-fledged production system. Use this app to learn, experiment, tinker, and practice application testing with Cypress. Happy Testing! --- Features 🛠 Built with [React][reactjs], [XState][xstate], [Express][express], [lowdb][lowdb], [Material-UI][material-ui] and [TypeScript][typescript] ⚡️ Zero database dependencies 🚀 Full-stack [Express][express]/[React][reactjs] application with real-world features and tests 👮♂️ Local Authentication 🔥 Database Seeding with End-to-end Tests 💻 CI/CD + [Cypress Cloud][cypresscloud] Getting Started The Cypress Real-World App (RWA) is a full-stack Express/React application backed by a local JSON database ([lowdb]). The app is bundled with example data (data/database.json) that contains everything you need to start using the app and run tests out-of-the-box. 🚩 Note You can login to the app with any of the example app users. The default password for all users is s3cret. Example users can be seen by running yarn list:dev:users. Prerequisites This project requires Node.js to be installed on your machine. Refer to the .node-version file for the exact version. Yarn Classic is also required. Once you have Node.js installed, execute the following to install the npm module yarn (Classic - version 1) globally. shell npm install yarn@1 -g If you have Node.js' experimental Corepack feature enabled, then you should skip the step npm install yarn@1 -g to install Yarn Classic globally. The RWA project is locally configured for Corepack to use Yarn Classic (version 1). Yarn Modern This project is not compatible with Yarn Modern (version 2 and later). Installation To clone the repo to your local system and install dependencies, execute the following commands: shell git clone https://github.com/cypress-io/cypress-realworld-app cd cypress-realworld-app yarn Mac users with M-series chips will need to prepend PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true. shell PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true yarn install Run the app shell yarn dev 🚩 Note The app will run on port 3000 (frontend) and 3001 (API backend) by default. Please make sure there are no other applications or services running on both ports. If you want to change the default ports, you can do so by modifying PORT and VITE_BACKEND_PORT variables in .env file. However, make sure the modified port numbers in .env are not committed into Git since the CI environments still expect the application to run on the default ports. Start Cypress shell yarn cypress:open 🚩 Note If you have changed the default ports, then you need to update Cypress configuration file (cypress.config.ts) locally. There are three properties that you need to update in cyp
Top issues
#1551Build Project for Production and Serve Project4 comments · 2024-05-20#1607`cy.request('GET', '/')` no longer necessary in Cypress 141 comments · 2025-01-09#1555Migrate away from `react-virtualized`1 comments · 2024-06-25#1728API responses expose bcrypt password hashes via /login, /checkAuth and /users0 comments · 2026-08-26#1727Unauthenticated `/testData` endpoints leak password hashes and full financial data0 comments · 2026-08-26#1717Add test coverage for network resilience patterns (offline, retry, timeout)0 comments · 2026-06-18#1626[Feature] Add Docker Compose support for local development0 comments · 2025-03-09#1592Unexpected api /logout behavior0 comments · 2024-11-03
Discussions
#1730Remember me" checkbox on Sign In has no effect on session persistence1 comments · 2026-08-27#1614What exactly causes the welcome popup window that creates a Bank Account for new users0 comments · 2025-01-23#1601Testing first App: elements are 404, cannot continue course0 comments · 2024-12-19#1456Confused by number of transactions under "Everyone" tab0 comments · 2024-01-19#1449How to prevent going to the Specs folder when the page URL changes during the test0 comments · 2024-01-15#1387Will this project be upgraded to node 20?0 comments · 2023-08-04#1375How can the same tests be run locally and on the web?0 comments · 2023-07-03#1311Improvement login0 comments · 2023-02-13