Quickstart
Before wiring into CI, we recommend uploading a local build from your terminal to see the process working end-to-end. These steps should take you less than 5 minutes.
1. Install the Maestro CLI
We'll be using the maestro cloud
command below, so start by installing the Maestro CLI if you haven't already:
2. Login to the CLI
Authenticate with mobile.dev on the command line using the following command:
If this is your first time logging in, you'll be prompted to create an account. Follow the printed instructions to complete the login process.
3. Download the Samples
Use the download-samples command to download a sample app and Flow file to upload to Maestro Cloud:
You can of course choose to upload your own app and Flow file, but we recommend using the samples first to see how it works!
4. Run your Flow on Maestro Cloud
Use the maestro cloud
command to run your flow Maestro Cloud. This command works the same whether you're running it locally or in CI.
Android
iOS
Note that if you want to run any of the advanced examples you need to upload the full samples
folder, since the advanced Flows make use of subflows. More information about subflows and what Flows to include can be found here.
To run both Android Flows in Maestro Cloud, you can for example run the following command outside of the samples
folder.
5. View results in the console
A link to the Maestro Console console is printed out after your Flow is uploaded successfully. Click on the link to view the results of your upload. It may take a minute or so before your results are ready.
Congrats 🎉
Congrats, you just ran your first Flow on Maestro Cloud! 🙌
Now that's you've seen how this works locally, let's take a look at how this can be integrated into your CI workflows:
Last updated