Bitrise
Maestro Cloud is compatible with all CI systems and provides native integrations with a number of common providers including Bitrise. You can start running your Flows in CI with just a few clicks using the Maestro Cloud Bitrise Step.

Then, go to your Bitrise dashboard and save your api key into a secret variable.

Open Workflow Editor in your Bitrise dashboard and select your desired workflow.
- 1.To add the Maestro step, you can search for "Maestro" in Bitrise's library of steps.
- 2.The step should be added after your app binary has been built.

Lastly, complete the required fields.
For example, we need to add our api key and path of the generated app file.

You can add the Maestro Cloud step directly into your
bitrise.yml
file.
Simply, add this line after your build step. (Make sure to replace the env variables)- maestro-cloud-upload@1:
inputs:
- app_file: "$BITRISE_APP_PATH"
- api_key: "$MDEV_API_KEY"
These are the available input variables for Maestro Cloud step
Note: For the latest inputs, you can check the bitrise step itself.
Inputs | Required | Description |
---|---|---|
api_key | true | Maestro Cloud API key |
app_file | true | File path that points to your app binary.
Android: An x86 compatible APK file.
iOS: An x86 compatible Simulator build. |
mapping_file | false | Android: Include the Proguard mapping file to deobfuscate Android performance traces.
iOS: Include the generated .dSYM file (unique per build) |
workspace | false | File path to your flow(s).
By default, the action is looking for a .maestro folder with Maestro flows in the root directory of the project. If you would like to customize this behaviour, you can override it with a workspace argument. |
upload_name | false | Upload name that will be displayed in Maestro Cloud console. |
async | false | By default the step will wait for flows to complete.
If you don't want to wait for the result, simply set async to true |
env | false | A list of env variables to be used in your flows.
Should be separated by \n
i.e VAR1=1\nVAR2=2 |
branch | false | The branch this upload originated from.
Displayed in the Maestro Cloud console. |
repo_name | false | Repository name (ie: GitHub repo slug)
Displayed in the Maestro Cloud console. |
repo_owner | false | Repository owner (ie: GitHub organization or user slug)
Displayed in the Maestro Cloud console. |
pull_request_id | false | The ID of the pull request this upload originated from
Used to enable pull request blocking. |
Last modified 7mo ago