@buivietphi/skill-mobile-mt 1.4.1 → 1.4.2

package/AGENTS.md

@@ -62,6 +62,8 @@ skill-mobile-mt/
     ├── release-checklist.md         ← App Store/Play Store checklist (587 tokens)
     │
     ├── offline-first.md             ← Local-first + sync patterns (2,566 tokens)
+    ├── testing-strategy.md          ← Detox + Maestro + XCUITest + Espresso E2E (2,200 tokens)
+    ├── ci-cd.md                     ← GitHub Actions CI templates (2,500 tokens)
     │
     ├── ── TEMPLATES (copy to your project) ────────────────────
     ├── claude-md-template.md        ← CLAUDE.md for Claude Code (copy to project root)
@@ -70,7 +72,7 @@ skill-mobile-mt/
 
 **Token totals:**
 - Smart load (1 platform + core shared): **~38,600 tokens** (30.2% of 128K)
-- Full load (all files): **~70,000 tokens** (54.7% of 128K)
+- Full load (all files): **~74,700 tokens** (58.4% of 128K)
 
 ---
 
@@ -109,6 +111,8 @@ The agent reads the task, then decides which extra file to load:
 | "Install this package / upgrade SDK" | `shared/version-management.md` |
 | "Prepare for App Store / Play Store" | `shared/release-checklist.md` |
 | "Weird issue, not sure why" | `shared/common-pitfalls.md` |
+| "Write / run E2E tests" | `shared/testing-strategy.md` |
+| "Setup CI/CD / GitHub Actions" | `shared/ci-cd.md` |
 
 **Load cost:** +500 to +3,500 tokens per on-demand file.
 
@@ -143,7 +147,7 @@ The agent reads the task, then decides which extra file to load:
 ```yaml
 skill:
   name: skill-mobile-mt
-  version: "1.4.0"
+  version: "1.4.2"
   author: buivietphi
   category: engineering
   tags:
@@ -210,9 +214,9 @@ skill:
     java: ".java files in app/src/"
 
   context_budget:
-    max_tokens: 70000
+    max_tokens: 74700
     smart_load_tokens: 38600
-    savings: "~45%"
+    savings: "~48%"
 ```
 
 ---
@@ -279,6 +283,8 @@ Priority 6 (ON-DEMAND): shared/observability.md — Sessions as 4th pillar
 Priority 6 (ON-DEMAND): shared/document-analysis.md — Parse images/PDFs → code
 Priority 6 (ON-DEMAND): shared/release-checklist.md — Pre-release verification
 Priority 6 (ON-DEMAND): shared/common-pitfalls.md — Known issue patterns
+Priority 6 (ON-DEMAND): shared/testing-strategy.md — Detox + Maestro + XCUITest + Espresso E2E
+Priority 6 (ON-DEMAND): shared/ci-cd.md — GitHub Actions CI/CD templates
 ```
 
 ---

package/README.md

@@ -232,7 +232,7 @@ iOS only?
 | SKILL.md only | ~13,200 | 10.3% | 6.6% |
 | + 1 platform + core shared/ | ~38,600 | 30.2% | 19.3% |
 | Cross-platform (RN/Flutter + iOS + Android) | ~53,000 | 41.4% | 26.5% |
-| All files loaded | ~70,000 | 54.7% | 35.0% |
+| All files loaded | ~74,700 | 58.4% | 37.4% |
 | **Smart load (recommended)** | **~38,600** | **30.2%** | **19.3%** |
 
 ### Per-file token breakdown
@@ -259,9 +259,11 @@ iOS only?
 | `shared/version-management.md` | 3,500 |
 | `shared/observability.md` | 3,000 |
 | `shared/offline-first.md` | 2,566 |
+| `shared/testing-strategy.md` | 2,200 |
+| `shared/ci-cd.md` | 2,500 |
 | `shared/claude-md-template.md` | ~500 |
 | `shared/agent-rules-template.md` | ~2,500 |
-| **Total** | **~48,800** |
+| **Total** | **~53,500** |
 
 ## Installed Structure
 
@@ -293,6 +295,8 @@ iOS only?
         ├── observability.md           Sessions as 4th pillar
         ├── release-checklist.md       Pre-release verification
         ├── offline-first.md           Local-first + sync patterns
+        ├── testing-strategy.md        Detox + Maestro + XCUITest + Espresso E2E
+        ├── ci-cd.md                   GitHub Actions CI/CD templates
         ├── claude-md-template.md      CLAUDE.md template for projects
         └── agent-rules-template.md    Rules templates for all agents
 ```

package/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: skill-mobile-mt
 description: "Master Senior Mobile Engineer. Patterns from 30+ production repos (200k+ GitHub stars: Ignite, Expensify, Mattermost, Immich, AppFlowy, Now in Android, TCA). Use when: building mobile features, fixing mobile bugs, reviewing mobile code, mobile architecture, React Native, Flutter, iOS Swift, Android Kotlin, mobile performance, mobile security audit, mobile code review, app release. Two modes: (1) default = pre-built production patterns, (2) 'project' = reads current project and adapts."
-version: "1.4.1"
+version: "1.4.2"
 author: buivietphi
 priority: high
 user-invocable: true
@@ -130,6 +130,12 @@ USER REQUEST                    → ACTION (Read tool required)
 "Offline / cache / sync"        → Read: shared/offline-first.md
                                   then: implement local-first architecture
 
+"Write/run E2E tests"           → Read: shared/testing-strategy.md
+                                  then: Detox (RN) or Maestro (cross-platform) or XCUITest/Espresso
+
+"Setup CI/CD / GitHub Actions"  → Read: shared/ci-cd.md
+                                  then: test → build → distribute pipeline
+
 ```
 
 **⛔ NEVER start coding without identifying the task type first.**

package/bin/install.mjs

@@ -70,7 +70,7 @@ const fail = m => log(`  ${c.red}✗${c.reset} ${m}`);
 
 function banner() {
   log(`\n${c.bold}${c.cyan}  ┌──────────────────────────────────────────────────┐`);
-  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.1           │`);
+  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.2           │`);
   log(`  │  Master Senior Mobile Engineer                    │`);
   log(`  │                                                  │`);
   log(`  │  Claude · Cline · Roo Code · Cursor · Windsurf  │`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buivietphi/skill-mobile-mt",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Master Senior Mobile Engineer skill for AI agents. Pre-built patterns from 18 production apps + local project adaptation. React Native, Flutter, iOS, Android. Supports Claude, Gemini, Kimi, Cursor, Copilot, Antigravity.",
   "author": "buivietphi",
   "license": "MIT",

package/shared/ci-cd.md

@@ -0,0 +1,423 @@
+# CI/CD Pipelines — GitHub Actions for Mobile
+
+> Automate: test → build → distribute. Never ship without CI.
+
+---
+
+## React Native — CI Pipeline
+
+```yaml
+# .github/workflows/rn-ci.yml
+name: React Native CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'           # or npm, pnpm
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: TypeScript check
+        run: yarn tsc --noEmit
+
+      - name: Lint
+        run: yarn lint
+
+      - name: Unit tests
+        run: yarn test --ci --coverage --maxWorkers=2
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  build-android:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - name: Cache Gradle
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.gradle/caches
+            ~/.gradle/wrapper
+          key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*') }}
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Build Android APK (debug)
+        run: cd android && ./gradlew assembleDebug
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: app-debug.apk
+          path: android/app/build/outputs/apk/debug/app-debug.apk
+
+  build-ios:
+    runs-on: macos-15
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Cache CocoaPods
+        uses: actions/cache@v4
+        with:
+          path: ios/Pods
+          key: ${{ runner.os }}-pods-${{ hashFiles('ios/Podfile.lock') }}
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile && cd ios && pod install
+
+      - name: Build iOS (simulator)
+        run: |
+          xcodebuild -workspace ios/MyApp.xcworkspace \
+            -scheme MyApp \
+            -sdk iphonesimulator \
+            -configuration Debug \
+            -derivedDataPath ios/build \
+            CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO
+```
+
+---
+
+## React Native — E2E with Detox
+
+```yaml
+# .github/workflows/rn-e2e.yml
+name: E2E Tests (Detox)
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  e2e-ios:
+    runs-on: macos-15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile && cd ios && pod install
+
+      - name: Install Detox CLI
+        run: npm install -g detox-cli
+
+      - name: Build for Detox
+        run: detox build --configuration ios.sim.debug
+
+      - name: Run E2E tests
+        run: detox test --configuration ios.sim.debug --headless
+
+      - name: Upload Detox artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: detox-artifacts
+          path: artifacts/
+```
+
+---
+
+## Flutter — CI Pipeline
+
+```yaml
+# .github/workflows/flutter-ci.yml
+name: Flutter CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.x'
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Analyze
+        run: flutter analyze
+
+      - name: Unit + Widget tests
+        run: flutter test --coverage
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+
+  build-android:
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.x'
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build APK
+        run: flutter build apk --debug
+
+      - name: Upload APK
+        uses: actions/upload-artifact@v4
+        with:
+          name: flutter-debug.apk
+          path: build/app/outputs/flutter-apk/app-debug.apk
+
+  build-ios:
+    runs-on: macos-15
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: subosito/flutter-action@v2
+        with:
+          flutter-version: '3.27.x'
+          cache: true
+
+      - name: Install dependencies
+        run: flutter pub get
+
+      - name: Build iOS (no codesign)
+        run: flutter build ios --debug --no-codesign
+```
+
+---
+
+## iOS — Release to TestFlight (Fastlane)
+
+```yaml
+# .github/workflows/ios-release.yml
+name: iOS Release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: macos-15
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile && cd ios && pod install
+
+      - name: Setup certificates
+        uses: apple-actions/import-codesign-certs@v2
+        with:
+          p12-file-base64: ${{ secrets.CERTIFICATES_P12 }}
+          p12-password: ${{ secrets.CERTIFICATES_P12_PASSWORD }}
+
+      - name: Setup provisioning profile
+        uses: apple-actions/download-provisioning-profiles@v1
+        with:
+          bundle-id: com.myapp
+          issuer-id: ${{ secrets.APPSTORE_ISSUER_ID }}
+          api-key-id: ${{ secrets.APPSTORE_KEY_ID }}
+          api-private-key: ${{ secrets.APPSTORE_PRIVATE_KEY }}
+
+      - name: Deploy to TestFlight
+        run: bundle exec fastlane ios beta
+        env:
+          APP_STORE_CONNECT_API_KEY_KEY_ID: ${{ secrets.APPSTORE_KEY_ID }}
+          APP_STORE_CONNECT_API_KEY_ISSUER_ID: ${{ secrets.APPSTORE_ISSUER_ID }}
+          APP_STORE_CONNECT_API_KEY_KEY: ${{ secrets.APPSTORE_PRIVATE_KEY }}
+```
+
+```ruby
+# ios/Fastfile
+lane :beta do
+  build_app(
+    workspace: "MyApp.xcworkspace",
+    scheme: "MyApp",
+    configuration: "Release",
+    export_method: "app-store"
+  )
+  upload_to_testflight(skip_waiting_for_build_processing: true)
+end
+```
+
+---
+
+## Android — Release to Play Store (Fastlane)
+
+```yaml
+# .github/workflows/android-release.yml
+name: Android Release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: 'temurin'
+          java-version: '17'
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'yarn'
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+
+      - name: Decode keystore
+        run: echo "${{ secrets.KEYSTORE_BASE64 }}" | base64 -d > android/app/release.keystore
+
+      - name: Build release AAB
+        run: cd android && ./gradlew bundleRelease
+        env:
+          KEYSTORE_PASSWORD: ${{ secrets.KEYSTORE_PASSWORD }}
+          KEY_ALIAS: ${{ secrets.KEY_ALIAS }}
+          KEY_PASSWORD: ${{ secrets.KEY_PASSWORD }}
+
+      - name: Deploy to Play Store
+        uses: r0adkll/upload-google-play@v1
+        with:
+          serviceAccountJsonPlainText: ${{ secrets.PLAY_STORE_SERVICE_ACCOUNT_JSON }}
+          packageName: com.myapp
+          releaseFiles: android/app/build/outputs/bundle/release/*.aab
+          track: internal
+```
+
+---
+
+## Required GitHub Secrets
+
+```
+# iOS
+CERTIFICATES_P12             ← base64-encoded .p12 file
+CERTIFICATES_P12_PASSWORD    ← password for .p12
+APPSTORE_KEY_ID              ← App Store Connect API key ID
+APPSTORE_ISSUER_ID           ← App Store Connect issuer ID
+APPSTORE_PRIVATE_KEY         ← App Store Connect private key (.p8 contents)
+
+# Android
+KEYSTORE_BASE64              ← base64-encoded release.keystore
+KEYSTORE_PASSWORD            ← keystore password
+KEY_ALIAS                    ← key alias
+KEY_PASSWORD                 ← key password
+PLAY_STORE_SERVICE_ACCOUNT_JSON  ← GCP service account JSON
+
+# Shared
+CODECOV_TOKEN                ← coverage reporting
+MAESTRO_API_KEY              ← Maestro Cloud E2E (optional)
+```
+
+---
+
+## Caching Strategy
+
+```yaml
+# Node modules — hash package-lock or yarn.lock
+- uses: actions/cache@v4
+  with:
+    path: node_modules
+    key: ${{ runner.os }}-node-${{ hashFiles('**/yarn.lock') }}
+    restore-keys: ${{ runner.os }}-node-
+
+# Gradle — hash .gradle files
+- uses: actions/cache@v4
+  with:
+    path: |
+      ~/.gradle/caches
+      ~/.gradle/wrapper
+    key: ${{ runner.os }}-gradle-${{ hashFiles('**/*.gradle*', '**/gradle-wrapper.properties') }}
+
+# CocoaPods — hash Podfile.lock
+- uses: actions/cache@v4
+  with:
+    path: ios/Pods
+    key: ${{ runner.os }}-pods-${{ hashFiles('ios/Podfile.lock') }}
+
+# Flutter pub — hash pubspec.lock
+- uses: actions/cache@v4
+  with:
+    path: ~/.pub-cache
+    key: ${{ runner.os }}-pub-${{ hashFiles('**/pubspec.lock') }}
+```
+
+---
+
+## Anti-Patterns
+
+```
+❌ Committing signing credentials to repo
+❌ Running E2E on every PR (too slow — run on main only)
+❌ No caching (3x slower builds)
+❌ Skipping unit tests before build jobs
+❌ Building on push to every branch
+
+✅ Store all secrets in GitHub Secrets
+✅ Cache node_modules + Gradle + CocoaPods + pub-cache
+✅ Unit tests on PR, E2E on merge to main
+✅ needs: test before build jobs
+✅ Upload build artifacts for download/QA
+```

package/shared/testing-strategy.md

@@ -0,0 +1,332 @@
+# Mobile Testing Strategy — Unit + E2E
+
+> Test the right things at the right layer. Don't test implementation details.
+
+---
+
+## Testing Pyramid
+
+```
+        ╱ E2E ╲          ← Detox / Maestro / XCUITest / Espresso
+       ╱───────╲         ← Few, slow, high-confidence
+      ╱Integration╲      ← API mocking, navigation flows
+     ╱─────────────╲     ← Medium count
+    ╱   Unit Tests   ╲   ← Jest / XCTest / JUnit
+   ╱─────────────────╲   ← Many, fast, cheap
+
+RULE: Most tests = unit. E2E = critical flows only (login, checkout, onboarding).
+```
+
+---
+
+## Unit Tests (Jest — React Native / TypeScript)
+
+```typescript
+// Test hooks, not components
+describe('useCart', () => {
+  it('adds item and updates total', () => {
+    const { result } = renderHook(() => useCart(), { wrapper: ReduxProvider })
+    act(() => { result.current.addItem(mockProduct) })
+    expect(result.current.total).toBe(mockProduct.price)
+  })
+
+  it('handles addToCart API error with rollback', async () => {
+    server.use(rest.post('/cart', (req, res, ctx) => res(ctx.status(500))))
+    const { result } = renderHook(() => useCart(), { wrapper: ReduxProvider })
+    await act(async () => { await result.current.addItem(mockProduct) })
+    expect(result.current.items).toHaveLength(0) // rolled back
+    expect(result.current.error).toBeTruthy()
+  })
+})
+
+// Test Redux slices directly
+describe('cartSlice', () => {
+  it('sets loading state on fetchCart.pending', () => {
+    const state = cartReducer(initialState, fetchCart.pending('', undefined))
+    expect(state.status).toBe('loading')
+  })
+})
+```
+
+**Rules:**
+- Test business logic (hooks, services, slices) — NOT component layout
+- Mock API calls with `msw` (Mock Service Worker)
+- 4 states per feature: loading / success / error / empty
+
+---
+
+## E2E Testing — Detox (React Native)
+
+> Best for: React Native apps, full native bridge testing.
+
+### Setup
+
+```bash
+# Install
+npm install --save-dev detox @config/detox
+
+# iOS build (required before tests)
+detox build --configuration ios.sim.debug
+
+# Run tests
+detox test --configuration ios.sim.debug
+detox test --configuration android.emu.debug
+```
+
+### Config (`detox.config.js`)
+
+```js
+module.exports = {
+  testRunner: {
+    args: { '$0': 'jest', config: 'e2e/jest.config.js' },
+    jest: { setupTimeout: 120000 }
+  },
+  apps: {
+    'ios.debug': { type: 'ios.app', binaryPath: 'ios/build/Build/Products/Debug-iphonesimulator/MyApp.app', build: 'xcodebuild -workspace ios/MyApp.xcworkspace -scheme MyApp -configuration Debug -sdk iphonesimulator -derivedDataPath ios/build' },
+    'android.debug': { type: 'android.apk', binaryPath: 'android/app/build/outputs/apk/debug/app-debug.apk', build: 'cd android && ./gradlew assembleDebug assembleAndroidTest -DtestBuildType=debug' }
+  },
+  devices: {
+    simulator: { type: 'ios.simulator', device: { type: 'iPhone 15' } },
+    emulator: { type: 'android.emulator', device: { avdName: 'Pixel_7_API_34' } }
+  },
+  configurations: {
+    'ios.sim.debug': { device: 'simulator', app: 'ios.debug' },
+    'android.emu.debug': { device: 'emulator', app: 'android.debug' }
+  }
+}
+```
+
+### Write Detox Tests
+
+```typescript
+// e2e/login.test.ts
+describe('Login Flow', () => {
+  beforeAll(async () => {
+    await device.launchApp({ newInstance: true })
+  })
+
+  beforeEach(async () => {
+    await device.reloadReactNative()
+  })
+
+  it('shows error on wrong password', async () => {
+    await element(by.id('email-input')).typeText('user@test.com')
+    await element(by.id('password-input')).typeText('wrongpass')
+    await element(by.id('login-button')).tap()
+    await expect(element(by.text('Invalid credentials'))).toBeVisible()
+  })
+
+  it('navigates to home on success', async () => {
+    await element(by.id('email-input')).typeText('user@test.com')
+    await element(by.id('password-input')).typeText('correctpass')
+    await element(by.id('login-button')).tap()
+    await expect(element(by.id('home-screen'))).toBeVisible()
+  })
+})
+```
+
+**testID rules:**
+```typescript
+// Add testID to interactive elements
+<TextInput testID="email-input" ... />
+<TouchableOpacity testID="login-button" ... />
+<View testID="home-screen" ... />
+```
+
+**What to test with Detox:**
+- Login / logout flow
+- Onboarding (first-time user)
+- Critical purchase / checkout path
+- Push notification tap → navigation
+- Deep link handling
+
+**What NOT to test with Detox:** minor UI variations, loading spinners, animations.
+
+---
+
+## E2E Testing — Maestro (Cross-Platform)
+
+> Best for: Simpler setup, works on React Native + Flutter + native iOS/Android.
+
+### Setup
+
+```bash
+# macOS
+brew tap mobile-dev-inc/tap
+brew install maestro
+
+# Run a flow
+maestro test e2e/login.yaml
+maestro test e2e/           # all flows in folder
+```
+
+### Write Maestro Flows (YAML)
+
+```yaml
+# e2e/login.yaml
+appId: com.myapp
+---
+- launchApp:
+    clearState: true
+
+- assertVisible: "Sign In"
+
+- tapOn:
+    id: "email-input"
+- inputText: "user@test.com"
+
+- tapOn:
+    id: "password-input"
+- inputText: "wrongpass"
+
+- tapOn:
+    id: "login-button"
+
+- assertVisible: "Invalid credentials"
+```
+
+```yaml
+# e2e/checkout.yaml
+appId: com.myapp
+---
+- launchApp
+- tapOn: "Products"
+- tapOn:
+    index: 0   # first product
+- tapOn: "Add to Cart"
+- tapOn: "Checkout"
+- assertVisible: "Order Confirmed"
+```
+
+### Maestro Cloud CI
+
+```bash
+# Run on real devices in Maestro Cloud
+maestro cloud --apiKey $MAESTRO_API_KEY e2e/
+```
+
+**Maestro vs Detox:**
+
+| | Maestro | Detox |
+|--|---------|-------|
+| Setup | Minutes | Hours |
+| YAML / Code | YAML | TypeScript |
+| Cross-platform | ✅ RN + Flutter + native | RN only |
+| Speed | Slower | Faster |
+| Power | Medium | High |
+| CI integration | Maestro Cloud | Self-hosted |
+
+**Use Maestro when:** simple flows, cross-platform team, quick setup.
+**Use Detox when:** complex interactions, React Native only, full control.
+
+---
+
+## Flutter Testing
+
+### Unit + Widget Tests
+
+```dart
+// Unit test — business logic
+test('CartBloc adds item correctly', () {
+  final bloc = CartBloc(cartRepository: MockCartRepository());
+  bloc.add(AddToCart(product: mockProduct));
+  expectLater(bloc.stream, emits(CartLoaded(items: [mockProduct])));
+});
+
+// Widget test — UI
+testWidgets('ProductCard shows title and price', (tester) async {
+  await tester.pumpWidget(MaterialApp(
+    home: ProductCard(product: mockProduct),
+  ));
+  expect(find.text(mockProduct.title), findsOneWidget);
+  expect(find.text('\$${mockProduct.price}'), findsOneWidget);
+});
+```
+
+### Integration Test (Flutter Driver replacement)
+
+```dart
+// integration_test/login_test.dart
+void main() {
+  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
+
+  testWidgets('login flow', (tester) async {
+    app.main();
+    await tester.pumpAndSettle();
+
+    await tester.enterText(find.byKey(Key('email')), 'user@test.com');
+    await tester.enterText(find.byKey(Key('password')), 'pass123');
+    await tester.tap(find.byKey(Key('login-button')));
+    await tester.pumpAndSettle();
+
+    expect(find.byKey(Key('home-screen')), findsOneWidget);
+  });
+}
+```
+
+```bash
+# Run on simulator
+flutter test integration_test/
+
+# Run on real device
+flutter test integration_test/ -d <device-id>
+```
+
+---
+
+## iOS — XCUITest
+
+```swift
+func testLoginFlow() throws {
+    let app = XCUIApplication()
+    app.launch()
+
+    let emailField = app.textFields["email-input"]
+    emailField.tap()
+    emailField.typeText("user@test.com")
+
+    let passwordField = app.secureTextFields["password-input"]
+    passwordField.tap()
+    passwordField.typeText("pass123")
+
+    app.buttons["login-button"].tap()
+
+    XCTAssertTrue(app.otherElements["home-screen"].waitForExistence(timeout: 5))
+}
+```
+
+---
+
+## Android — Espresso
+
+```kotlin
+@Test
+fun testLoginFlow() {
+    onView(withId(R.id.emailInput))
+        .perform(typeText("user@test.com"), closeSoftKeyboard())
+    onView(withId(R.id.passwordInput))
+        .perform(typeText("pass123"), closeSoftKeyboard())
+    onView(withId(R.id.loginButton)).perform(click())
+    onView(withId(R.id.homeScreen)).check(matches(isDisplayed()))
+}
+```
+
+---
+
+## Anti-Patterns
+
+```
+❌ Testing implementation details (internal state, private methods)
+❌ Testing every UI pixel (visual regression belongs in Storybook/Percy)
+❌ E2E for every edge case (unit test those)
+❌ Skipping testID on interactive elements
+❌ Running Detox without a stable test build
+❌ Using sleep() instead of waitFor()
+
+✅ Test user flows, not code internals
+✅ E2E for critical paths: login, purchase, onboarding
+✅ Unit test all business logic (hooks, slices, services)
+✅ Mock API calls in unit tests
+✅ Add testID to every tappable + input element
+✅ waitFor() over sleep() in Detox
+```