# Maestro Deck

> Maestro Deck is a source-available desktop client and runner for the Maestro YAML format. Author, inspect, and run mobile end-to-end tests on iOS and Android, locally or in CI, without an account or telemetry. Business Source License 1.1 (BUSL-1.1).

Maestro Deck exists as a free, self-hostable alternative to mobile.dev's proprietary Maestro Studio. It is drop-in compatible with the Maestro YAML flow format, so existing flows run unchanged.

## Key URLs

- [Home](https://maestrodeck.cloud/): product overview and download.
- [Documentation](https://maestrodeck.cloud/docs): full docs index.
- [Installation](https://maestrodeck.cloud/docs/installation): install on macOS, Linux, Windows.
- [Quickstart](https://maestrodeck.cloud/docs/quickstart): run your first flow in five minutes.
- [First flow](https://maestrodeck.cloud/docs/first-flow): authoring a basic Maestro YAML flow.
- [Guides](https://maestrodeck.cloud/docs/guides): iOS, Android, CI/CD, parallel execution, debugging, screenshots.
- [Migration from Maestro Studio](https://maestrodeck.cloud/docs/migration/from-studio): switch from Studio with no flow rewrites.
- [Reference](https://maestrodeck.cloud/docs/reference): CLI, YAML schema, config, glossary.
- [vs Maestro Studio](https://maestrodeck.cloud/vs-maestro-studio): feature-by-feature comparison.
- [FAQ](https://maestrodeck.cloud/faq): common questions about pricing, compatibility, and self-hosting.
- [Changelog](https://maestrodeck.cloud/changelog): release notes.
- [GitHub](https://github.com/BlueShork/maestro-deck): source code, issues, releases.

## FAQ

### Is Maestro Deck free?
Yes. Maestro Deck is source-available under the Business Source License 1.1 (BUSL-1.1) and free to use, self-host, and modify for non-production and small-scale use.

### Does it work with existing Maestro flows?
Yes. Maestro Deck reads the same YAML flow format used by mobile.dev's Maestro CLI and Studio, so existing flows run without modification.

### How is it different from Maestro Studio?
Maestro Studio is mobile.dev's proprietary, cloud-tied product. Maestro Deck is open-source, self-hosted, has no account requirement, no telemetry, no usage caps, and no per-seat pricing.

### Does it support iOS and Android?
Yes — both platforms, on simulators, emulators, and physical devices.

### Can I run it in CI?
Yes. Maestro Deck is CI-native with documented setups for GitHub Actions, GitLab CI, and CircleCI.

### What's the license?
Business Source License 1.1 (BUSL-1.1). Source-available, free for non-production and small-scale production use.