Release v1.0.9: desktop browser testing, CLI flags, banner fix

- Add CHANGELOG entry for v1.0.9 with all new features and fixes
- Update README: web platform, browser CDP driver, DeviceLab driver,
  install specific version, web testing guide link
- Bump version to 1.0.9
- Fix banner: remove Unicode box-drawing, strip OSC 8 hyperlinks in CI

Author: omnarayan

CHANGELOG.md

@@ -7,7 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.9] - 2026-03-11
+
 ### Added
+- **Desktop browser testing** — new `--platform web` with built-in CDP driver for Chrome/Chromium. Headless by default, `--headed` for visible browser. Supports parallel browser execution
+  ```bash
+  maestro-runner --platform web test flow.yaml
+  maestro-runner --platform web --headed --browser chrome test flow.yaml
+  maestro-runner --platform web test --parallel 3 flows/
+  ```
+- **Browser-specific commands** — `evalBrowserScript`, `setCookies`, `getCookies`, `saveAuthState`, `loadAuthState`, `openTab`, `switchTab`, `closeTab`, `mockNetwork`, `blockNetwork`, `setNetworkConditions`, `waitForRequest`, `clearNetworkMocks`, `uploadFile`, `waitForDownload`, `grantPermissions`, `resetPermissions`, `getConsoleLogs`, `clearConsoleLogs`, `assertNoJSErrors`, `runBrowserScript`
+- **Browser selectors** — `css` and `xpath` selectors for web elements, in addition to `text` and `id`
+  ```yaml
+  - tapOn:
+      css: "button.submit"
+  - inputText:
+      id: "username"
+      text: "hello"
+  ```
+- `--no-app-install` flag — skip app installation even if `--app-file` is provided. Useful when the app is already installed
+  ```bash
+  maestro-runner --no-app-install --app-file app.apk test flow.yaml
+  ```
+- `--no-driver-install` flag — skip driver installation (UIAutomator2, WDA, DeviceLab). Useful when drivers are already installed on the device
+  ```bash
+  maestro-runner --no-driver-install test flow.yaml
+  ```
 - Flutter VM Service fallback for element finding — when the native driver (WDA/UIAutomator2) can't find a Flutter element, automatically discovers the Dart VM Service and searches the semantics/widget trees in parallel. Works on Android and iOS simulators. Non-Flutter apps pay only one log read on first miss, then fully bypassed. Disable with `--no-flutter-fallback`
 - Flutter widget tree cross-reference — when semantics tree search fails, falls back to widget tree analysis (hint text, identifiers, suffix icons) and cross-references with semantics nodes for coordinates
 - DeviceLab Android driver — WebSocket-based on-device automation with bounds stabilization for animated elements and special character handling. ~2x faster than UIAutomator2
@@ -74,6 +99,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Cloud Providers section in README with TestingBot setup guide
 
 ### Fixed
+- iOS simulator no longer requires `--team-id` — simulators don't need code signing, so the validation now only enforces `--team-id` for real devices
+  ```bash
+  # Before: required --team-id even for simulators
+  # Now: just works
+  maestro-runner --platform ios --start-simulator <UDID> test flow.yaml
+  ```
 - `runFlow: when` conditions with variable expressions (e.g., `${output.element.id}`) were never expanded, causing conditions to always evaluate as false and silently skip conditional blocks
 - iOS real device: `acceptAlertButtonSelector` matched "Don't Allow" instead of "Allow" — `CONTAINS[c] 'Allow'` matched both buttons, causing WDA to reject permission dialogs. Changed to `BEGINSWITH[c] 'Allow'` with `OK` fallback for older iOS versions
 - `AllocatePort` was ignoring existing port allocations and `assertCondition` had duplicate `timeout` yaml tag

README.md

@@ -4,11 +4,11 @@
 
 ---
 
-**Fast mobile UI test automation for Android, iOS, React Native, Flutter & Expo**
+**Fast UI test automation for Android, iOS, Web, React Native, Flutter & Expo**
 <br>
 *Open-source Maestro alternative — single binary, no JVM. 100% free, no features behind a paywall.*
 <br>
-*Supports real iOS devices, simulators, emulators, and cloud providers.*
+*Supports real iOS devices, simulators, emulators, desktop browsers, and cloud providers.*
 
 ![3.6x faster](https://img.shields.io/badge/3.6x_faster-3a9d5c?style=for-the-badge) ![14x less memory](https://img.shields.io/badge/14x_less_memory-3a9d5c?style=for-the-badge)
 
@@ -25,22 +25,26 @@
 
 ---
 
-- Runs Maestro YAML flows on real devices, emulators, and simulators
-- Supports Android (UIAutomator2), iOS (WebDriverAgent), and cloud (Appium)
+- Runs Maestro YAML flows on real devices, emulators, simulators, and desktop browsers
+- Supports Android (UIAutomator2), iOS (WebDriverAgent), Web (Chrome CDP), and cloud (Appium)
 - Built-in parallel execution, HTML/JUnit/Allure reports, and JavaScript scripting
 - Addresses [78% of the top 100 most-discussed open issues](docs/maestro-issues-analysis.md) on Maestro's GitHub
 
 ## Install
 
 ```bash
 curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash
+
+# Install a specific version
+curl -fsSL https://open.devicelab.dev/install/maestro-runner | bash -s -- --version 1.0.9
 ```
 
 ## Run Tests
 
 ```bash
 maestro-runner test flow.yaml                                           # Android (default)
 maestro-runner --platform ios test flow.yaml                            # iOS
+maestro-runner --platform web test flow.yaml                            # Desktop browser (Chrome)
 maestro-runner --app-file app.apk test flows/                           # Install app and run
 maestro-runner --driver appium --appium-url <server-url> test flow.yaml # Appium
 maestro-runner test --parallel 3 flows/                                 # Parallel on 3 devices
@@ -51,6 +55,7 @@ maestro-runner test --parallel 3 flows/                                 # Parall
 - **Zero migration** — Runs your existing Maestro YAML flows as-is, no changes needed
 - **Real iOS device testing** — Supports physical iOS devices, not just simulators [Guide →](https://devicelab.dev/blog/maestro-ios-real-device-testing)
 - **Cloud testing** — BrowserStack, Sauce Labs, LambdaTest, TestingBot via Appium driver [Guide →](https://devicelab.dev/blog/run-maestro-flows-any-cloud)
+- **Desktop browser testing** — Run Maestro flows on Chrome/Chromium via CDP. Supports `css`, `xpath`, `id`, and `text` selectors with `--platform web` [Guide →](https://devicelab.dev/open-source/maestro-runner/docs/web-testing)
 - **React Native & Flutter** — Smart element finding for RN testIDs and Flutter semantics [Guide →](https://devicelab.dev/blog/flutter-testing-maestro-patrol-appium)
 - **DeviceLab driver** — Optional on-device Android driver via WebSocket, ~2x faster than UIAutomator2 and ~5x faster than Maestro CLI. Just add `--driver devicelab`
 - **Parallel execution** — Dynamic work distribution across devices, not static sharding. Faster devices pick up more tests automatically, so no device sits idle
@@ -72,7 +77,9 @@ maestro-runner test --parallel 3 flows/                                 # Parall
 | Driver | Platform | Description |
 |--------|----------|-------------|
 | **UIAutomator2** | Android | Direct connection to device. Default driver, no external server needed. |
+| **DeviceLab** | Android | `--driver devicelab`. On-device WebSocket driver, ~2x faster than UIAutomator2. |
 | **WDA (WebDriverAgent)** | iOS | Auto-selected with `--platform ios`. Supports simulators and physical devices. |
+| **Browser (CDP)** | Web | `--platform web`. Chrome/Chromium automation via Chrome DevTools Protocol. |
 | **Appium** | Android & iOS | `--driver appium`. For cloud testing providers and existing Appium infrastructure. |
 
 ### DeviceLab Driver (Android)
@@ -119,6 +126,7 @@ waitForIdleTimeout: 3000    # Device idle wait (ms), 0 to disable
 
 - **Android testing:** `adb` (Android SDK Platform-Tools)
 - **iOS testing:** Xcode command-line tools (`xcrun`)
+- **Web/Browser testing:** Chrome or Chromium
 - **Cloud & Appium testing:** Appium 2.x or 3.x — works with local Appium servers and cloud providers (BrowserStack, Sauce Labs, LambdaTest, TestingBot)
 
 ## Cloud Providers

pkg/cli/cli.go

@@ -11,7 +11,7 @@ import (
 
 // Build info — set at build time via -ldflags.
 var (
-	Version   = "1.0.1"
+	Version   = "1.0.9"
 	Commit    = "unknown"
 	BuildDate = "unknown"
 )

pkg/cli/test.go

@@ -474,42 +474,29 @@ type RunConfig struct {
 	NoFlutterFallback bool // Disable automatic Flutter VM Service fallback
 }
 
-func printBanner() {
-	// Make DeviceLab.dev clickable and colored (cyan)
-	// OSC 8 hyperlink format: ESC]8;;URL BEL TEXT ESC]8;; BEL
-	deviceLabLink := "\x1b]8;;https://devicelab.dev\x07" + color(colorCyan) + "DeviceLab.dev" + color(colorReset) + "\x1b]8;;\x07"
-
-	// Make GitHub link clickable
-	githubLink := "\x1b]8;;https://github.com/devicelab-dev/maestro-runner\x07Star us on GitHub\x1b]8;;\x07"
-
-	// Box width is 64 characters (between the ║ symbols)
-	// Calculate padding for version line
-	// Visible text: "  maestro-runner " + Version + " - by DeviceLab.dev"
-	versionLineVisible := 16 + len(Version) + 20 // "  maestro-runner " + version + " - by DeviceLab.dev"
-	versionPadding := strings.Repeat(" ", 64-versionLineVisible)
+func hyperlink(url, text string) string {
+	if colorsEnabled {
+		return "\x1b]8;;" + url + "\x07" + text + "\x1b]8;;\x07"
+	}
+	return text
+}
 
-	// Calculate padding for GitHub line
-	// Visible text: "  ⭐ Star us on GitHub"
-	githubLineVisible := 21 // "  ⭐ " + "Star us on GitHub" (⭐ is 3 bytes but 1 visual char)
-	githubPadding := strings.Repeat(" ", 64-githubLineVisible)
+func printBanner() {
+	deviceLabLink := hyperlink("https://devicelab.dev", color(colorCyan)+"DeviceLab.dev"+color(colorReset))
+	githubLink := hyperlink("https://github.com/devicelab-dev/maestro-runner", "Star us on GitHub")
 
 	fmt.Println()
-	fmt.Println("╔═══════════════════════════════════════════════════════════════════╗")
-	fmt.Printf("║  maestro-runner %s - by %s%s   ║\n", Version, deviceLabLink, versionPadding)
-	fmt.Println("║  Fast, lightweight Maestro test runner                            ║")
-	fmt.Printf("║  ⭐ %s%s  ║\n", githubLink, githubPadding)
-	fmt.Println("╚═══════════════════════════════════════════════════════════════════╝")
+	fmt.Printf("  maestro-runner %s - by %s\n", Version, deviceLabLink)
+	fmt.Println("  Fast, lightweight Maestro test runner")
+	fmt.Printf("  %s\n", githubLink)
 	fmt.Println()
 }
 
 func printFooter() {
-	// Make DeviceLab.dev clickable and colored (cyan)
-	deviceLabLink := "\x1b]8;;https://devicelab.dev\x07" + color(colorCyan) + "DeviceLab.dev" + color(colorReset) + "\x1b]8;;\x07"
+	deviceLabLink := hyperlink("https://devicelab.dev", color(colorCyan)+"DeviceLab.dev"+color(colorReset))
 
 	fmt.Println()
-	fmt.Println("╔══════════════════════════════════════════════════════════════════════════╗")
-	fmt.Printf("║ Built by %s - Turn Your Devices Into a Distributed Device Lab ║\n", deviceLabLink)
-	fmt.Println("╚══════════════════════════════════════════════════════════════════════════╝")
+	fmt.Printf("  Built by %s - Turn Your Devices Into a Distributed Device Lab\n", deviceLabLink)
 	fmt.Println()
 }