Repository navigation
[CI-6550] Add a page on running Maestro tests on Bitrise - #385
Merged
Merged
Conversation
The page sits at the top level of the Testing section, not under a platform folder: the Step runs Android and iOS flows, and React Native and Flutter apps too, like the Firebase device testing pages next to it. Inserting it at sidebar position 6 shifts the four pages after it. The page leaves out the Step's input table. The Steplib page and the Workflow Editor already show it, and a copy here would drift with every Step release.
The other procedures in the Testing section start at the Step itself, or at most with one line that opens the Workflow. The shared login and navigation partial added three steps here that a reader looking for a test setup doesn't need.
Maestro has its own cloud, so without saying it, a reader can't tell whether the Step runs the flows on the Bitrise VM or uploads them. The device sentence pointed at an earlier Step without naming it.
Maestro also runs flows in a browser, but the Step only accepts an .apk or a simulator .app, so a reader with web flows would only find out from the Step's error.
AndrasEszes
marked this pull request as ready for review
October 22, 2026 08:57
AndrasEszes
requested review from
aorcsik,
ilanazholobovsky,
matenadasdi and
zoltan-baba
as code owners
October 22, 2026 08:57
There was a problem hiding this comment.
🔵 Needs a closer look
Publication of maestro-test in Steplib needs confirmation before the draft documentation can safely be merged.
No open issues 🎉
What changed in this PR
Adds a Maestro testing guide to the Bitrise CI documentation and links it from related testing pages.
Changes:
- Documents Android and iOS setup through the Workflow Editor and YAML, including variables, tag filtering, parallel execution, and test results.
- Adds Maestro links to React Native, Flutter, sharding, and test-reporting guides.
- Adjusts sidebar positions to place the new guide after Firebase device testing.
| File | Description |
|---|---|
docs/bitrise-ci/testing/testing-react-native-apps/running-unit-and-ui-tests-for-react-native-apps.mdx |
Adds Maestro as an end-to-end testing option. |
docs/bitrise-ci/testing/testing-flutter-apps/running-unit-and-ui-tests-on-flutter-apps.mdx |
Links to Maestro for UI testing. |
docs/bitrise-ci/testing/test-sharding.mdx |
Links to Maestro sharding instructions and adjusts sidebar position. |
docs/bitrise-ci/testing/running-maestro-tests-on-bitrise.mdx |
Adds the Maestro setup, execution, and troubleshooting guide. |
docs/bitrise-ci/testing/measuring-your-code-coverage-with-codecov.mdx |
Adjusts sidebar position. |
docs/bitrise-ci/testing/detecting-and-quarantining-flaky-tests.mdx |
Adjusts sidebar position. |
docs/bitrise-ci/testing/deploying-and-viewing-test-results.mdx |
Lists Maestro Test as supported and adjusts sidebar position. |
Review effort: Balanced
The prerequisites are now the first step of each Android and iOS procedure, and the device sentence became a short overview of how a Maestro Workflow runs. The single-device warning moved next to the device steps. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
zoltan-baba
approved these changes
Oct 26, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a page on running Maestro flows with the new Maestro Test Step: Workflow Editor and YAML setup for Android and iOS, flow variables, tag filtering, and sharding across parallel Pipeline Workflows. The testing pages that list Steps or E2E tools now link to it.
Details
maestro-testStep ID in the YAML examples doesn't resolve.