The app-qa repository is responsible for running end-to-end (E2E) tests against the
app-next and the app-backend
repositories. These tests ensure the stability and functionality of the Aragon App by simulating real user interactions
using Playwright and Synpress.
Before setting up the project, ensure you have the following installed:
Follow these steps to set up and run E2E tests locally:
-
Install dependencies:
yarn install
-
Set up environment variables:
Create a
.envfile in the root directory using.env.exampleas a template. Ensure it includes the necessary variables:cp .env.example .env
Required environment variables:
METAMASK_SEED_PHRASE=<your-seed-phrase> METAMASK_PASSWORD=<your-password>
-
Build Synpress cache (required for MetaMask integration):
yarn setup
Ensure your MetaMask wallet has sufficient funds before running tests.
-
Run all tests:
yarn test -
Run tests on a specific browser (e.g., Firefox):
yarn test --project=firefox -
Run tests on a specific environment (e.g., Staging):
TEST_ENV=staging yarn test -
Run tests on a custom URL:
TEST_ENV=custom CUSTOM_URL=https://custom.app.aragon.org yarn test -
View more options in the Playwright configuration file:
playwright.config.js
The E2E testing framework utilizes the following tools:
For more details, refer to the Playwright Documentation and Synpress Documentation.
Contributions are welcome! If you plan to make significant changes, please open an issue first for discussion. Ensure that your tests cover expected behaviors before submitting a pull request.
If you discover any security issues, please report them to the security contact at sirt@aragon.org. Do not use the
issue tracker for security concerns.
For more information about Aragon and its ecosystem, please visit the Aragon website and explore our Developer Portal. Join our Developer Community to stay updated and contribute to the growth of decentralized governance.