GitHub Actions

Maestro Cloud is compatible with all CI systems and provides native integrations with a number of common providers including GitHub Actions. You can start running your Flows in CI with just a few lines of configuration using the Maestro Cloud GitHub Action.

Create a Maestro Cloud account

This doesn’t cost anything up front and you’ll have $10 of free credit each month to play around with the platform. If you haven’t already, start by creating a Maestro Cloud account: Create a Maestro Cloud Account

Add your API key secret

The GitHub Action will need to authenticate with Maestro Cloud. So the first step is to expose your API key as a GitHub “Repository Secret”.

Grab your API key

1. Log in to Maestro Cloud Console, click on your username in bottom left corner and click on View API Key

2. Copy your API Key and save it somewhere. You will need it in next steps!

Add your API key as a “Repository Secret”

1. Navigate to your GitHub repo and click on Settings in top nav bar.

2. In repository settings page click on Secrets -> Actions. It will open Action Secrets page.

3. On Action Secrets page, click on New Repository Secret button. Use MAESTRO_CLOUD_API_KEY as the secret name and paste your API key from the previous step into the “Secret” value text box. Click “Add Secret” to add the secret.

Commit your Maestro Flows to your repository

Create a .maestro/ directory at the root of your repository and commit your Flows there:

<root>
├── .maestro/
│   ├── Login.yaml
│   ├── Add to Cart.yaml
│   └── Search.yaml

It’s common to have some Flow files that are only meant to be executed as part of another Flow via the runFlow command. These "subflows" can be nested under a subdirectory to prevent them from running as a top-level Flow.

<root>
├── .maestro/
│   ├── subflows/
│   │   └── MySubflow.yaml
│   ├── Login.yaml
│   ├── Add to Cart.yaml
│   └── Search.yaml

Update your GitHub Actions workflow

Next, you’ll need to update your GitHub Actions workflow to add in the Maestro Cloud step. The workflows above execute generally the same steps for each platform:

• For every push or pull_request to main branch trigger this job

• Build the application

• Upload the built application and Flow files to Maestro Cloud

• Note the MAESTRO_CLOUD_API_KEY is the same secret you added to your Github repository earlier

Usage examples

Below you can find various examples for different platforms for how to structure your GitHub action to build and upload your app to Maestro Cloud:

pageNative iOS

pageNative Android

pageFlutter

That’s it!

Check out the Maestro Cloud Action README for more information on how to configure the step.