bsky-app/docs/testing.md

Testing instructions

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

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 Maestro tests

• In one tab, run yarn e2e:mock-server
• In a second tab, run yarn e2e:metro
• In a third tab, run yarn e2e:run

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 yarn perf:measure which will run a live preview of the performance test results. You can see a demo here
4. The yarn 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 yarn:perf:results
5. You can also run your own tests by running yarn perf:test <path_to_test> where <path_to_test> is the path to your test file. For example, yarn perf:test __e2e__/maestro/scroll.yaml will run the scroll.yaml test located in __e2e__/maestro/scroll.yaml.