Update documentation for --release flag and iOS XCUITest features

- Add --release flag to BrowserStack examples in README.md
- Update mobench-sdk README and rustdocs with --release recommendation
- Update mobench CLI rustdocs with --release flag
- Expand template READMEs with BrowserStack workflow and video capture info
- Document benchmark report capture mechanism (5-second delay, JSON markers)

Author: dcbuilder.eth

README.md

@@ -37,8 +37,12 @@ cargo add mobench-sdk inventory
 cargo mobench build --target android
 cargo mobench build --target ios
 
-# Run a benchmark
+# Run a benchmark locally
 cargo mobench run --target android --function sample_fns::fibonacci
+
+# Run on BrowserStack (use --release for smaller APK uploads)
+cargo mobench run --target android --function sample_fns::fibonacci \
+  --devices "Google Pixel 7-13.0" --release
 ```
 
 ## Configuration

crates/mobench-sdk/README.md

@@ -123,7 +123,9 @@ BrowserStack:
 export BROWSERSTACK_USERNAME=your_username
 export BROWSERSTACK_ACCESS_KEY=your_key
 
-cargo mobench run --target android --function my_benchmark --devices "Google Pixel 7-13.0"
+# Use --release for BrowserStack (smaller APK: ~133MB vs ~544MB debug)
+cargo mobench run --target android --function my_benchmark \
+  --devices "Google Pixel 7-13.0" --release
 ```
 
 ## Examples (Repository)

crates/mobench-sdk/src/lib.rs

@@ -58,9 +58,9 @@
 //! # Build for iOS
 //! cargo mobench build --target ios
 //!
-//! # Run on BrowserStack
+//! # Run on BrowserStack (use --release for smaller APK uploads)
 //! cargo mobench run --target android --function my_expensive_operation \
-//!     --iterations 100 --warmup 10 --devices "Google Pixel 7-13.0"
+//!     --iterations 100 --warmup 10 --devices "Google Pixel 7-13.0" --release
 //! ```
 //!
 //! ## Architecture

crates/mobench-sdk/templates/android/README.md

@@ -8,17 +8,34 @@ This is an auto-generated Android app for running Rust benchmarks on real device
 # Build debug APK
 ./gradlew assembleDebug
 
-# Build release APK
+# Build release APK (recommended for BrowserStack - ~133MB vs ~544MB debug)
 ./gradlew assembleRelease
 ```
 
+## BrowserStack Testing
+
+```bash
+# Build with mobench (use --release for smaller APK uploads)
+cargo mobench build --target android --release
+
+# Run on BrowserStack
+cargo mobench run --target android --function my_benchmark \
+  --devices "Google Pixel 7-13.0" --release
+```
+
 ## Running Benchmarks
 
 The app reads benchmark configuration from:
 1. Intent extras (`bench_function`, `bench_iterations`, `bench_warmup`)
 2. `assets/bench_spec.json`
 3. Default values in code
 
+## Benchmark Report Capture
+
+The app captures benchmark results for BrowserStack:
+- Displays results on screen for 5 seconds (video capture)
+- Outputs JSON with `BENCH_JSON` marker to logcat
+
 ## Generated by
 
 [mobench](https://crates.io/crates/mobench) - Mobile benchmarking SDK for Rust

crates/mobench-sdk/templates/ios/BenchRunner/README.md

@@ -15,6 +15,22 @@ xcodebuild -scheme BenchRunner -destination 'platform=iOS Simulator,name=iPhone
 xcodebuild -scheme BenchRunner -destination 'generic/platform=iOS' build
 ```
 
+## BrowserStack Testing
+
+For BrowserStack testing, you need both the app IPA and the XCUITest runner:
+
+```bash
+# Package the app as IPA
+cargo mobench package-ipa --method adhoc
+
+# Package the XCUITest runner
+cargo mobench package-xcuitest
+
+# Run on BrowserStack (use --release for smaller builds)
+cargo mobench run --target ios --function my_benchmark \
+  --devices "iPhone 14-16" --release
+```
+
 ## Running Benchmarks
 
 The app reads benchmark configuration from:
@@ -23,6 +39,13 @@ The app reads benchmark configuration from:
 3. `bench_spec.json` in bundle
 4. Default values in code
 
+## Benchmark Report Capture
+
+The app captures benchmark results for BrowserStack:
+- Displays results on screen for 5 seconds (video capture)
+- Outputs JSON with `BENCH_REPORT_JSON_START/END` markers
+- XCUITest extracts results via accessibility identifiers
+
 ## Generated by
 
 [mobench](https://crates.io/crates/mobench) - Mobile benchmarking SDK for Rust

crates/mobench/src/lib.rs

@@ -35,9 +35,9 @@
 //! # Run locally (no device required)
 //! cargo mobench run --target android --function my_benchmark --local-only
 //!
-//! # Run on BrowserStack
+//! # Run on BrowserStack (use --release for smaller APK uploads)
 //! cargo mobench run --target android --function my_benchmark \
-//!     --iterations 100 --warmup 10 --devices "Google Pixel 7-13.0"
+//!     --iterations 100 --warmup 10 --devices "Google Pixel 7-13.0" --release
 //! ```
 //!
 //! ## Commands

templates/android/README.md

@@ -0,0 +1,41 @@
+# {{PROJECT_NAME}} Android Benchmark App
+
+This is an auto-generated Android app for running Rust benchmarks on real devices.
+
+## Building
+
+```bash
+# Build debug APK
+./gradlew assembleDebug
+
+# Build release APK (recommended for BrowserStack - ~133MB vs ~544MB debug)
+./gradlew assembleRelease
+```
+
+## BrowserStack Testing
+
+```bash
+# Build with mobench (use --release for smaller APK uploads)
+cargo mobench build --target android --release
+
+# Run on BrowserStack
+cargo mobench run --target android --function my_benchmark \
+  --devices "Google Pixel 7-13.0" --release
+```
+
+## Running Benchmarks
+
+The app reads benchmark configuration from:
+1. Intent extras (`bench_function`, `bench_iterations`, `bench_warmup`)
+2. `assets/bench_spec.json`
+3. Default values in code
+
+## Benchmark Report Capture
+
+The app captures benchmark results for BrowserStack:
+- Displays results on screen for 5 seconds (video capture)
+- Outputs JSON with `BENCH_JSON` marker to logcat
+
+## Generated by
+
+[mobench](https://crates.io/crates/mobench) - Mobile benchmarking SDK for Rust

templates/ios/BenchRunner/README.md

@@ -0,0 +1,51 @@
+# {{PROJECT_NAME_PASCAL}} iOS Benchmark App
+
+This is an auto-generated iOS app for running Rust benchmarks on real devices.
+
+## Building
+
+```bash
+# Generate Xcode project (if using xcodegen)
+xcodegen generate
+
+# Build for simulator
+xcodebuild -scheme BenchRunner -destination 'platform=iOS Simulator,name=iPhone 15' build
+
+# Build for device
+xcodebuild -scheme BenchRunner -destination 'generic/platform=iOS' build
+```
+
+## BrowserStack Testing
+
+For BrowserStack testing, you need both the app IPA and the XCUITest runner:
+
+```bash
+# Package the app as IPA
+cargo mobench package-ipa --method adhoc
+
+# Package the XCUITest runner
+cargo mobench package-xcuitest
+
+# Run on BrowserStack (use --release for smaller builds)
+cargo mobench run --target ios --function my_benchmark \
+  --devices "iPhone 14-16" --release
+```
+
+## Running Benchmarks
+
+The app reads benchmark configuration from:
+1. Environment variables
+2. Launch arguments
+3. `bench_spec.json` in bundle
+4. Default values in code
+
+## Benchmark Report Capture
+
+The app captures benchmark results for BrowserStack:
+- Displays results on screen for 5 seconds (video capture)
+- Outputs JSON with `BENCH_REPORT_JSON_START/END` markers
+- XCUITest extracts results via accessibility identifiers
+
+## Generated by
+
+[mobench](https://crates.io/crates/mobench) - Mobile benchmarking SDK for Rust