Testing instructions

Make sure you've copied .env.example to .env.test and provided any required values.

Install dependencies in /dev-env

cd dev-env && pnpm i

Using Maestro

1. Install Maestro by following these instructions. This will help us run the E2E tests.
2. You can write Maestro tests in /.maestro/flows/ directory by creating a new .yml file or by modifying an existing one.
3. You can also use Maestro Studio which automatically generates commands by recording your actions on the app. Therefore, you can create realistic tests without having to manually write any code. Use the maestro studio command to start recording your actions.

Running on Android

You will need to allow your device access to the port that the mock server is running on.

adb reverse tcp:3000 tcp:3000

Running Maestro tests

• In one tab, run pnpm e2e:mock-server
• In a second tab, run pnpm e2e:build
• In a third tab, run pnpm e2e:run __e2e__

Using Flashlight for Performance Testing

1. Make sure Maestro is installed (optional: only for automated testing) by following the instructions above
2. Install Flashlight by following these instructions
3. The simplest way to get started is by running pnpm perf:measure which will run a live preview of the performance test results. You can see a demo here
4. The pnpm perf:test:measure will run the scroll.yaml test located in __e2e__/maestro/scroll.yaml and give the results in .perf/results.json which can be viewed by running pnpm perf:results
5. You can also run your own tests by running pnpm perf:test <path_to_test> where <path_to_test> is the path to your test file. For example, pnpm perf:test __e2e__/maestro/scroll.yaml will run the scroll.yaml test located in __e2e__/maestro/scroll.yaml.