@buivietphi/skill-mobile-mt 1.4.1 → 1.4.3

package/AGENTS.md

@@ -40,7 +40,7 @@ skill-mobile-mt/
 │   └── ios-native.md               ← Swift + UIKit/SwiftUI patterns (1,452 tokens)
 │
 ├── android/
-│   └── android-native.md           ← Kotlin + Compose patterns (2,100 tokens)
+│   └── android-native.md           ← Kotlin + Compose + Java legacy patterns (4,400 tokens)
 │
 └── shared/
     │
@@ -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)
@@ -69,8 +71,8 @@ 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)
+- Smart load (1 platform + core shared): **~40,900 tokens** (31.9% of 128K)
+- Full load (all files): **~77,000 tokens** (60.2% 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.
 
@@ -118,7 +122,7 @@ The agent reads the task, then decides which extra file to load:
 
 **No automatic trigger.** Full load happens when the AI reads every file without being selective — either because it's over-eager, or because the user explicitly asks for it.
 
-**Total:** ~70,000 tokens (54.7% of 128K, 35% of 200K)
+**Total:** ~72,300 tokens (56.5% of 128K, 36% of 200K)
 
 **How it actually works:**
 - `@skill-mobile-mt` only injects SKILL.md into context
@@ -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
-    smart_load_tokens: 38600
-    savings: "~45%"
+    max_tokens: 77000
+    smart_load_tokens: 40900
+    savings: "~47%"
 ```
 
 ---
@@ -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
 ```
 
 ---
@@ -457,10 +463,10 @@ npx @buivietphi/skill-mobile-mt --init all        # → all files
 {
   "id": "skill-mobile-mt",
   "name": "skill-mobile-mt",
-  "version": "1.4.0",
+  "version": "1.4.3",
   "author": "buivietphi",
   "category": "engineering",
-  "description": "Master Senior Mobile Engineer. Pre-built patterns from 18 production apps + project adaptation. Auto-detects language and framework. React Native, Flutter, iOS, Android.",
+  "description": "Master Senior Mobile Engineer. Pre-built patterns from 30+ production repos + project adaptation. Auto-detects language and framework. React Native, Flutter, iOS, Android.",
   "risk": "low",
   "source": "buivietphi (MIT)",
   "platforms": ["react-native", "flutter", "ios", "android"],

package/README.md

@@ -72,6 +72,73 @@ Reads your current project first, then follows **your** conventions:
 - Clones the most similar existing feature when scaffolding new ones
 - Never suggests migrations or imposes different architecture
 
+## Humanizer — Mobile Copy
+
+Installed automatically alongside the main skill. Removes AI writing patterns from mobile app text.
+
+```
+@humanizer-mobile
+```
+
+Use for: app store descriptions, release notes, error messages, onboarding, push notifications, permission prompts, paywall copy.
+
+**App Store Description**
+```
+❌ "TaskFlow is a powerful, comprehensive task management application that
+seamlessly integrates with your existing workflow."
+
+✅ "TaskFlow keeps your team's work in one place. Add tasks, assign them,
+set deadlines — everything syncs in real time. Works with Slack and Notion."
+```
+
+**Release Notes**
+```
+❌ "Version 2.1.0 introduces significant enhancements to the overall user
+experience including robust improvements to performance and reliability."
+
+✅ "2.1.0
+- Faster load times on older Android devices (was 4s, now 1.2s)
+- Fixed crash when opening notifications while offline
+- Dark mode now remembers your setting between sessions"
+```
+
+**Error Messages**
+```
+❌ "We apologize for the inconvenience. An unexpected error has occurred."
+
+✅ "Couldn't save — no internet connection.
+   [Try again] [Save for later]"
+```
+
+**Push Notifications**
+```
+❌ "You have received a new message from a team member."
+✅ "Alex commented on "Landing page redesign""
+```
+
+**Paywall**
+```
+❌ "Unlock the full potential of our comprehensive premium features."
+
+✅ "Go Pro
+   • Unlimited projects (free plan: 3)
+   • Team sharing
+   [Start 7-day free trial]"
+```
+
+Covers 24 AI patterns across: content inflation, chatbot artifacts, style issues, mobile-specific copy (App Store limits, permission prompts, rating requests, subscription CTAs).
+
+### Works with all agents
+
+| Agent | Invocation |
+|-------|-----------|
+| Claude Code | `@humanizer-mobile` |
+| Gemini CLI | `@humanizer-mobile` |
+| Codex / Kimi / Antigravity | `@humanizer-mobile` |
+| Cline / Roo Code / Cursor / Windsurf / Copilot | Paste the text and say "humanize this app copy" |
+
+---
+
 ## Quick Start Examples
 
 ### Step 1: Install the skill
@@ -101,6 +168,15 @@ You'll see an interactive checkbox — use arrow keys to navigate, space to sele
     ◯ Antigravity    [not found]
 ```
 
+Install output:
+
+```
+  ✓ skill-mobile-mt/    → Claude Code  (~/.claude/skills/skill-mobile-mt)
+  ✓ humanizer-mobile/   → Claude Code  (~/.claude/skills/humanizer-mobile)
+```
+
+Both are installed automatically. Use `@humanizer-mobile` for app store copy, release notes, and UX text.
+
 ### Step 2: Generate project rules
 
 ```bash
@@ -231,9 +307,9 @@ 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% |
-| **Smart load (recommended)** | **~38,600** | **30.2%** | **19.3%** |
+| Cross-platform (RN/Flutter + iOS + Android) | ~55,300 | 43.2% | 27.7% |
+| All files loaded | ~77,000 | 60.2% | 38.5% |
+| **Smart load (recommended)** | **~40,900** | **31.9%** | **20.5%** |
 
 ### Per-file token breakdown
 
@@ -244,7 +320,7 @@ iOS only?
 | `react-native/react-native.md` | 5,108 |
 | `flutter/flutter.md` | 2,100 |
 | `ios/ios-native.md` | 1,452 |
-| `android/android-native.md` | 2,100 |
+| `android/android-native.md` | 4,400 |
 | `shared/code-review.md` | 865 |
 | `shared/bug-detection.md` | 499 |
 | `shared/prompt-engineering.md` | 3,927 |
@@ -259,9 +335,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** | **~55,800** |
 
 ## Installed Structure
 
@@ -277,7 +355,7 @@ iOS only?
     ├── ios/
     │   └── ios-native.md              iOS Swift patterns
     ├── android/
-    │   └── android-native.md          Android Kotlin patterns
+    │   └── android-native.md          Android Kotlin + Java patterns
     └── shared/
         ├── code-review.md             Senior review checklist
         ├── bug-detection.md           Auto bug scanner
@@ -293,6 +371,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
 ```
@@ -423,66 +503,6 @@ your-project/
 | **Kiro** | Reads `.kiro/steering/` from project root | `npx skill-mobile-mt --init kiro` |
 | **Antigravity** | Reads from `~/.agents/skills/` | `npx skill-mobile-mt --antigravity` |
 
-## Humanizer — Mobile Copy
-
-Installed automatically alongside the main skill. Removes AI writing patterns from mobile app text.
-
-```
-@humanizer-mobile
-```
-
-Use for: app store descriptions, release notes, error messages, onboarding, push notifications, permission prompts, paywall copy.
-
-### Examples
-
-**App Store Description**
-```
-❌ "TaskFlow is a powerful, comprehensive task management application that
-seamlessly integrates with your existing workflow."
-
-✅ "TaskFlow keeps your team's work in one place. Add tasks, assign them,
-set deadlines — everything syncs in real time. Works with Slack and Notion."
-```
-
-**Release Notes**
-```
-❌ "Version 2.1.0 introduces significant enhancements to the overall user
-experience including robust improvements to performance and reliability."
-
-✅ "2.1.0
-- Faster load times on older Android devices (was 4s, now 1.2s)
-- Fixed crash when opening notifications while offline
-- Dark mode now remembers your setting between sessions"
-```
-
-**Error Messages**
-```
-❌ "We apologize for the inconvenience. An unexpected error has occurred."
-
-✅ "Couldn't save — no internet connection.
-   [Try again] [Save for later]"
-```
-
-**Push Notifications**
-```
-❌ "You have received a new message from a team member."
-✅ "Alex commented on "Landing page redesign""
-```
-
-**Paywall**
-```
-❌ "Unlock the full potential of our comprehensive premium features."
-
-✅ "Go Pro
-   • Unlimited projects (free plan: 3)
-   • Team sharing
-   [Start 7-day free trial]"
-```
-
-Covers 24 AI patterns across: content inflation, chatbot artifacts, style issues, mobile-specific copy (App Store limits, permission prompts, rating requests, subscription CTAs).
-
----
-
 ## License
 
 MIT — by [buivietphi](https://github.com/buivietphi)

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.3"
 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/android/android-native.md

@@ -254,5 +254,227 @@ dependencies {
 
 ---
 
+## Java Interop (Legacy Projects)
+
+> For projects still using Java. New code should use Kotlin.
+
+### Activity + XML Layout (Java)
+
+```java
+// MainActivity.java
+@AndroidEntryPoint
+public class MainActivity extends AppCompatActivity {
+
+    private MainViewModel viewModel;
+    private ActivityMainBinding binding;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        binding = ActivityMainBinding.inflate(getLayoutInflater());
+        setContentView(binding.getRoot());
+
+        viewModel = new ViewModelProvider(this).get(MainViewModel.class);
+
+        // Observe LiveData (Java equivalent of collectAsStateWithLifecycle)
+        viewModel.getUiState().observe(this, state -> {
+            if (state instanceof UiState.Loading) {
+                binding.progressBar.setVisibility(View.VISIBLE);
+                binding.recyclerView.setVisibility(View.GONE);
+            } else if (state instanceof UiState.Error) {
+                binding.progressBar.setVisibility(View.GONE);
+                Toast.makeText(this, ((UiState.Error) state).getMessage(), Toast.LENGTH_SHORT).show();
+            } else if (state instanceof UiState.Success) {
+                binding.progressBar.setVisibility(View.GONE);
+                binding.recyclerView.setVisibility(View.VISIBLE);
+                adapter.submitList(((UiState.Success<List<Product>>) state).getData());
+            }
+        });
+
+        binding.retryButton.setOnClickListener(v -> viewModel.load());
+    }
+}
+```
+
+### ViewModel + LiveData (Java)
+
+```java
+// ProductListViewModel.java
+@HiltViewModel
+public class ProductListViewModel extends ViewModel {
+
+    private final MutableLiveData<UiState<List<Product>>> _uiState =
+        new MutableLiveData<>(new UiState.Loading<>());
+    private final LiveData<UiState<List<Product>>> uiState = _uiState;
+
+    private final GetProductsUseCase getProducts;
+
+    @Inject
+    public ProductListViewModel(GetProductsUseCase getProducts) {
+        this.getProducts = getProducts;
+        load();
+    }
+
+    public LiveData<UiState<List<Product>>> getUiState() { return uiState; }
+
+    public void load() {
+        _uiState.setValue(new UiState.Loading<>());
+        // Use RxJava or ExecutorService for async in Java
+        ExecutorService executor = Executors.newSingleThreadExecutor();
+        executor.execute(() -> {
+            try {
+                List<Product> items = getProducts.executeSync(); // blocking call
+                new Handler(Looper.getMainLooper()).post(() -> {
+                    if (items.isEmpty()) _uiState.setValue(new UiState.Empty<>());
+                    else _uiState.setValue(new UiState.Success<>(items));
+                });
+            } catch (Exception e) {
+                new Handler(Looper.getMainLooper()).post(() ->
+                    _uiState.setValue(new UiState.Error<>(e.getMessage()))
+                );
+            } finally {
+                executor.shutdown();
+            }
+        });
+    }
+}
+```
+
+### Retrofit + Callback (Java)
+
+```java
+// ProductApi.java
+public interface ProductApi {
+    @GET("products")
+    Call<ApiResponse<List<ProductDto>>> getProducts();
+}
+
+// ProductRepositoryImpl.java
+public class ProductRepositoryImpl implements ProductRepository {
+    private final ProductApi api;
+    private final ProductDao dao;
+
+    @Inject
+    public ProductRepositoryImpl(ProductApi api, ProductDao dao) {
+        this.api = api;
+        this.dao = dao;
+    }
+
+    @Override
+    public void getProducts(Callback<List<Product>> callback) {
+        api.getProducts().enqueue(new retrofit2.Callback<ApiResponse<List<ProductDto>>>() {
+            @Override
+            public void onResponse(Call<ApiResponse<List<ProductDto>>> call,
+                                   Response<ApiResponse<List<ProductDto>>> response) {
+                if (response.isSuccessful() && response.body() != null) {
+                    List<Product> items = mapToDomain(response.body().getData());
+                    callback.onSuccess(items);
+                } else {
+                    callback.onError("Server error: " + response.code());
+                }
+            }
+
+            @Override
+            public void onFailure(Call<ApiResponse<List<ProductDto>>> call, Throwable t) {
+                callback.onError(t.getMessage());
+            }
+        });
+    }
+}
+```
+
+### Room DAO (Java)
+
+```java
+// ProductDao.java
+@Dao
+public interface ProductDao {
+    @Query("SELECT * FROM products")
+    LiveData<List<ProductEntity>> getAll();   // LiveData for Java observers
+
+    @Insert(onConflict = OnConflictStrategy.REPLACE)
+    void insertAll(List<ProductEntity> items);
+
+    @Query("DELETE FROM products")
+    void deleteAll();
+}
+```
+
+### Java-Kotlin Interop Annotations
+
+```kotlin
+// When writing Kotlin code that will be called from Java:
+
+// @JvmStatic — allows calling companion object functions as static
+class ProductMapper {
+    companion object {
+        @JvmStatic
+        fun toDomain(dto: ProductDto): Product = Product(dto.id, dto.name)
+    }
+}
+// Java: ProductMapper.toDomain(dto)  ✅ (without @JvmStatic: ProductMapper.Companion.toDomain(dto))
+
+// @JvmField — exposes Kotlin property as Java field (no getter/setter)
+class Config {
+    companion object {
+        @JvmField val BASE_URL = "https://api.example.com"
+    }
+}
+// Java: Config.BASE_URL  ✅
+
+// @JvmOverloads — generates overloaded methods for default parameters
+class ProductService @JvmOverloads constructor(
+    val baseUrl: String,
+    val timeout: Int = 30,
+    val retries: Int = 3,
+)
+// Java: new ProductService("url")  ✅  (without: must pass all 3 params)
+
+// @Throws — declares checked exceptions for Java callers
+@Throws(IOException::class)
+fun readFile(path: String): String { /* ... */ }
+```
+
+### Calling Kotlin Suspend from Java (Bridge Pattern)
+
+```java
+// Use CoroutineScope from Java via CoroutinesInstrumentationHelper or wrapper
+// ⚠️ Recommended: write a non-suspend wrapper in Kotlin
+
+// Kotlin wrapper (bridge.kt)
+object ProductBridge {
+    @JvmStatic
+    fun getProducts(scope: CoroutineScope, callback: ProductCallback) {
+        scope.launch {
+            try {
+                val items = getProductsUseCase()
+                callback.onSuccess(items)
+            } catch (e: Exception) {
+                callback.onError(e.message ?: "Error")
+            }
+        }
+    }
+}
+
+// Java side
+ProductBridge.getProducts(lifecycleScope, new ProductCallback() {
+    @Override public void onSuccess(List<Product> items) { /* update UI */ }
+    @Override public void onError(String message) { /* show error */ }
+});
+```
+
+### Java Common Pitfalls
+
+| Pitfall | Fix |
+|---------|-----|
+| NullPointerException | `@NonNull` / `@Nullable` + null checks |
+| Memory leak (Activity in async) | `WeakReference<Activity>` or cancel on `onDestroy` |
+| Main thread network call | `Executors.newSingleThreadExecutor()` |
+| No `Call.cancel()` | Store reference, cancel in `onDestroy` |
+| Anonymous inner class holding outer ref | Use static inner class |
+
+---
+
 > Multi-module Gradle + Hilt + Compose + offline-first.
 > Clean Architecture with domain module having zero dependencies.
+> Java legacy: use LiveData + Retrofit callbacks. Bridge Kotlin suspend with wrapper functions.

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.3           │`);
   log(`  │  Master Senior Mobile Engineer                    │`);
   log(`  │                                                  │`);
   log(`  │  Claude · Cline · Roo Code · Cursor · Windsurf  │`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@buivietphi/skill-mobile-mt",
-  "version": "1.4.1",
-  "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.",
+  "version": "1.4.3",
+  "description": "Master Senior Mobile Engineer skill for AI agents. Pre-built patterns from 30+ production repos. React Native, Flutter, iOS, Android. Supports Claude, Cline, Cursor, Windsurf, Copilot, Codex, Gemini, Kimi, Kilo Code, Kiro, Antigravity.",
   "author": "buivietphi",
   "license": "MIT",
   "keywords": [

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
+```