@buivietphi/skill-mobile-mt 1.3.0 → 1.4.1

package/AGENTS.md

@@ -34,13 +34,13 @@ skill-mobile-mt/
 │   └── react-native.md             ← RN + Expo patterns (5,108 tokens)
 │
 ├── flutter/
-│   └── flutter.md                  ← Flutter + Dart patterns (1,617 tokens)
+│   └── flutter.md                  ← Flutter + Dart 3.x patterns (2,100 tokens)
 │
 ├── ios/
 │   └── ios-native.md               ← Swift + UIKit/SwiftUI patterns (1,452 tokens)
 │
 ├── android/
-│   └── android-native.md           ← Kotlin + Compose patterns (1,659 tokens)
+│   └── android-native.md           ← Kotlin + Compose patterns (2,100 tokens)
 │
 └── shared/
     │
@@ -54,21 +54,23 @@ skill-mobile-mt/
     ├── document-analysis.md         ← Parse images/PDFs/DOCX → code (1,200 tokens)
     ├── anti-patterns.md             ← PII, cardinality, payload detection (2,800 tokens)
     ├── performance-prediction.md    ← Frame budget, FPS prediction (1,500 tokens)
-    ├── platform-excellence.md       ← iOS 18+ vs Android 15+ UX (1,500 tokens)
+    ├── platform-excellence.md       ← iOS 18+ vs Android 15+ UX + HIG (2,200 tokens)
     ├── version-management.md        ← SDK compat matrix + release testing (3,500 tokens)
     ├── observability.md             ← Sessions as 4th pillar (3,000 tokens)
     ├── architecture-intelligence.md ← Patterns from 30+ production repos (4,500 tokens)
     ├── common-pitfalls.md           ← Known issue patterns (1,160 tokens)
     ├── release-checklist.md         ← App Store/Play Store checklist (587 tokens)
     │
+    ├── offline-first.md             ← Local-first + sync patterns (2,566 tokens)
+    │
     ├── ── TEMPLATES (copy to your project) ────────────────────
     ├── claude-md-template.md        ← CLAUDE.md for Claude Code (copy to project root)
     └── agent-rules-template.md      ← Rules for ALL agents: Cursor/.cursorrules, Windsurf/.windsurfrules, Copilot/.github/copilot-instructions.md, Codex/AGENTS.md, Gemini/GEMINI.md, Antigravity YAML
 ```
 
 **Token totals:**
-- Smart load (1 platform + core shared): **~14,200 tokens** (11.1% of 128K)
-- Full load (all files): **~41,700 tokens** (32.6% of 128K)
+- Smart load (1 platform + core shared): **~38,600 tokens** (30.2% of 128K)
+- Full load (all files): **~70,000 tokens** (54.7% of 128K)
 
 ---
 
@@ -80,13 +82,13 @@ skill-mobile-mt/
 
 **Loads automatically:**
 ```
-SKILL.md                           (6,100 tokens)
-+ 1 platform file                  (~1,600–5,100 tokens depending on platform)
-+ shared/code-review.md            (865 tokens)
-+ shared/bug-detection.md          (499 tokens)
-+ shared/prompt-engineering.md     (3,927 tokens)
+SKILL.md                           (~13,200 tokens)
++ 1 platform file                  (~1,580–5,730 tokens depending on platform)
++ shared/code-review.md            (~1,500 tokens)
++ shared/bug-detection.md          (~800 tokens)
++ shared/prompt-engineering.md     (~5,600 tokens)
 ─────────────────────────────────────────────────
-≈ 14,200 tokens total
+≈ 38,600 tokens total (estimated)
 ```
 
 **Use case:** Regular coding, new features, code review. Covers 90% of daily work.
@@ -116,7 +118,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:** ~41,700 tokens (32.6% of 128K, 20.9% of 200K)
+**Total:** ~70,000 tokens (54.7% of 128K, 35% of 200K)
 
 **How it actually works:**
 - `@skill-mobile-mt` only injects SKILL.md into context
@@ -141,7 +143,7 @@ The agent reads the task, then decides which extra file to load:
 ```yaml
 skill:
   name: skill-mobile-mt
-  version: "1.3.0"
+  version: "1.4.0"
   author: buivietphi
   category: engineering
   tags:
@@ -208,9 +210,9 @@ skill:
     java: ".java files in app/src/"
 
   context_budget:
-    max_tokens: 41700
-    smart_load_tokens: 14200
-    savings: "~66%"
+    max_tokens: 70000
+    smart_load_tokens: 38600
+    savings: "~45%"
 ```
 
 ---
@@ -455,7 +457,7 @@ npx @buivietphi/skill-mobile-mt --init all        # → all files
 {
   "id": "skill-mobile-mt",
   "name": "skill-mobile-mt",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "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.",

package/README.md

@@ -209,7 +209,7 @@ The skill automatically detects before any action:
 
 ## Smart Loading
 
-Only loads the relevant platform docs — saves **~60% context tokens**.
+Only loads the relevant platform docs — saves **~45% context tokens** vs loading everything.
 
 ```
 Flutter project?
@@ -229,22 +229,22 @@ iOS only?
 
 | Scenario | Tokens | % of 128K | % of 200K |
 |----------|-------:|----------:|----------:|
-| SKILL.md only | ~6,100 | 4.8% | 3.1% |
-| + 1 platform + core shared/ | ~14,200 | 11.1% | 7.1% |
-| Cross-platform (RN/Flutter + iOS + Android) | ~18,200 | 14.2% | 9.1% |
-| All files loaded | ~41,700 | 32.6% | 20.9% |
-| **Smart load (recommended)** | **~14,200** | **11.1%** | **7.1%** |
+| 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%** |
 
 ### Per-file token breakdown
 
 | File | Tokens |
 |------|-------:|
 | `SKILL.md` | 6,100 |
-| `AGENTS.md` | 1,541 |
+| `AGENTS.md` | 1,600 |
 | `react-native/react-native.md` | 5,108 |
-| `flutter/flutter.md` | 1,617 |
+| `flutter/flutter.md` | 2,100 |
 | `ios/ios-native.md` | 1,452 |
-| `android/android-native.md` | 1,659 |
+| `android/android-native.md` | 2,100 |
 | `shared/code-review.md` | 865 |
 | `shared/bug-detection.md` | 499 |
 | `shared/prompt-engineering.md` | 3,927 |
@@ -255,12 +255,13 @@ iOS only?
 | `shared/release-checklist.md` | 587 |
 | `shared/anti-patterns.md` | 2,800 |
 | `shared/performance-prediction.md` | 1,500 |
-| `shared/platform-excellence.md` | 1,500 |
+| `shared/platform-excellence.md` | 2,200 |
 | `shared/version-management.md` | 3,500 |
 | `shared/observability.md` | 3,000 |
+| `shared/offline-first.md` | 2,566 |
 | `shared/claude-md-template.md` | ~500 |
 | `shared/agent-rules-template.md` | ~2,500 |
-| **Total** | **~46,000** |
+| **Total** | **~48,800** |
 
 ## Installed Structure
 
@@ -287,10 +288,11 @@ iOS only?
         ├── document-analysis.md       Parse docs/images → code
         ├── anti-patterns.md           PII, cardinality, payload detection
         ├── performance-prediction.md  Frame budget, FPS prediction
-        ├── platform-excellence.md     iOS 18+ vs Android 15+ guidelines
+        ├── platform-excellence.md     iOS 18+ vs Android 15+ guidelines + HIG
         ├── version-management.md      SDK compatibility matrix
         ├── observability.md           Sessions as 4th pillar
         ├── release-checklist.md       Pre-release verification
+        ├── offline-first.md           Local-first + sync patterns
         ├── claude-md-template.md      CLAUDE.md template for projects
         └── agent-rules-template.md    Rules templates for all agents
 ```
@@ -385,7 +387,7 @@ your-project/
 
 - **Anti-Pattern Detection** (`anti-patterns.md`): Detect PII leaks (CRITICAL), high cardinality tags, unbounded payloads, unstructured logs, sync telemetry on main thread — with auto-fix suggestions
 - **Performance Prediction** (`performance-prediction.md`): Calculate frame budget, FlatList bridge calls, and memory usage BEFORE writing code. Example: `50 items × 3 bridge calls × 0.3ms = 45ms/frame → 22 FPS ❌ JANK`
-- **Platform Excellence** (`platform-excellence.md`): iOS 18+ vs Android 15+ native UX standards — navigation patterns, typography, icons, gesture handling, performance targets (cold start < 1s iOS, < 1.5s Android)
+- **Platform Excellence** (`platform-excellence.md`): iOS 18+ vs Android 15+ native UX standards — navigation patterns, typography, haptic feedback types, permission timing, ratings prompt flow, Live Activities/Dynamic Island, performance targets (cold start < 1s iOS, < 1.5s Android)
 - **Version Management** (`version-management.md`): Full SDK compatibility matrix for RN 0.73-0.76, Expo 50-52, Flutter 3.22-3.27, iOS 16-18, Android 13-15. Check SDK compat BEFORE `npm install`. Release-mode testing protocol.
 - **Observability** (`observability.md`): Sessions as the 4th pillar (Metrics + Logs + Traces + **Sessions**). Session lifecycle, enrichment API, unified instrumentation stack, correlation queries. Every event carries `session_id` for full user journey reconstruction.
 
@@ -421,6 +423,66 @@ 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.3.0"
+version: "1.4.1"
 author: buivietphi
 priority: high
 user-invocable: true
@@ -126,6 +126,10 @@ USER REQUEST                    → ACTION (Read tool required)
 
 "Build error / runtime crash"   → Read: shared/error-recovery.md
                                   then: apply matching fix pattern
+
+"Offline / cache / sync"        → Read: shared/offline-first.md
+                                  then: implement local-first architecture
+
 ```
 
 **⛔ NEVER start coding without identifying the task type first.**
@@ -1358,9 +1362,14 @@ skill-mobile-mt/
 ├── ios/ios-native.md                 ← iOS Swift MVVM + Clean Architecture
 ├── android/android-native.md         ← Android Kotlin + Clean Architecture
 └── shared/
+    │
+    ├── ── CORE (always load) ────────────────────────────────
     ├── code-review.md                ← 🔴 Senior review checklist
     ├── bug-detection.md              ← 🔴 Auto bug scanner
-    ├── prompt-engineering.md         ← 🟡 Auto-think templates
+    ├── prompt-engineering.md         ← 🔴 Auto-think templates
+    │
+    ├── ── ON-DEMAND (load by task) ──────────────────────────
+    ├── architecture-intelligence.md  ← 🟡 Patterns from 30+ production repos
     ├── release-checklist.md          ← 🟡 Before shipping to app store
     ├── common-pitfalls.md            ← 🟡 Problem → Symptoms → Solution
     ├── error-recovery.md             ← 🟡 Fix build/runtime errors
@@ -1369,5 +1378,7 @@ skill-mobile-mt/
     ├── performance-prediction.md     ← 🟡 Predict FPS/memory BEFORE shipping
     ├── platform-excellence.md        ← 🟡 iOS 18+ vs Android 15+ guidelines
     ├── version-management.md         ← 🟡 SDK compatibility matrix
-    └── observability.md              ← 🟡 Sessions as 4th pillar
+    ├── observability.md              ← 🟡 Sessions as 4th pillar
+    │
+    └── offline-first.md              ← 🟢 Local-first + sync patterns
 ```

package/android/android-native.md

@@ -192,6 +192,54 @@ dependencies {
 }
 ```
 
+## Compose Performance Optimization
+
+```kotlin
+// @Stable / @Immutable — tell Compose when to skip recomposition
+// Use when your class isn't a data class but values never change
+@Stable
+class UserState(val id: String, val name: String)
+
+@Immutable
+data class ProductUiModel(val id: String, val price: Double)
+
+// derivedStateOf — compute derived state only when inputs change
+// Prevents recomposition on every scroll position change
+val showFab by remember {
+    derivedStateOf { listState.firstVisibleItemIndex > 0 }
+}
+
+// key() in LazyColumn — stable identity prevents full recomposition
+LazyColumn {
+    items(products, key = { it.id }) { product ->
+        ProductCard(product)  // Only recomposes if THIS product changes
+    }
+}
+
+// Stateless components — pass data + callbacks, not ViewModel
+@Composable
+fun ProductCard(
+    product: Product,       // data only
+    onClick: () -> Unit,    // callback only
+) { /* no ViewModel here */ }
+```
+
+## Baseline Profiles (Startup Optimization)
+
+```kotlin
+// app/src/main/baseline-prof.txt (generated by Macrobenchmark)
+// Speeds up cold start 20-30% by AOT-compiling hot code paths
+
+// build.gradle.kts
+dependencies {
+    implementation("androidx.profileinstaller:profileinstaller:1.3.1")
+}
+
+// Generate with Macrobenchmark:
+// ./gradlew :app:generateBaselineProfile
+// Commit the generated baseline-prof.txt
+```
+
 ## Common Pitfalls
 
 | Pitfall | Fix |
@@ -201,6 +249,8 @@ dependencies {
 | Context leak | `@ApplicationContext`, never Activity |
 | Missing ProGuard | Test release builds |
 | Main thread blocking | `Dispatchers.IO` |
+| Unstable lambdas in Compose | `remember { {} }` or move to ViewModel |
+| List without keys | `items(list, key = { it.id })` |
 
 ---
 

package/bin/install.mjs

@@ -25,7 +25,7 @@
  *   npx @buivietphi/skill-mobile --init all        # Generate all project-level files
  */
 
-import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
 import { join, resolve, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
@@ -38,13 +38,14 @@ const HOME = homedir();
 // Structure: root files + subfolders
 const ROOT_FILES = ['SKILL.md', 'AGENTS.md'];
 
-const SUBFOLDERS = {
-  'react-native': ['react-native.md'],
-  'flutter':      ['flutter.md'],
-  'ios':          ['ios-native.md'],
-  'android':      ['android-native.md'],
-  'shared':       ['code-review.md', 'bug-detection.md', 'prompt-engineering.md', 'release-checklist.md', 'common-pitfalls.md', 'error-recovery.md', 'document-analysis.md', 'anti-patterns.md', 'performance-prediction.md', 'platform-excellence.md', 'version-management.md', 'observability.md', 'architecture-intelligence.md', 'claude-md-template.md', 'agent-rules-template.md'],
-};
+const SUBFOLDERS = ['react-native', 'flutter', 'ios', 'android', 'shared'];
+
+// Read all .md files from a folder dynamically
+function getMdFiles(folder) {
+  const dir = join(PKG_ROOT, folder);
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir).filter(f => f.endsWith('.md'));
+}
 
 const AGENTS = {
   claude:       { name: 'Claude Code',  dir: join(HOME, '.claude', 'skills'),   detect: () => existsSync(join(HOME, '.claude')) },
@@ -69,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.3.0           │`);
+  log(`  │  📱 @buivietphi/skill-mobile-mt v1.4.1           │`);
   log(`  │  Master Senior Mobile Engineer                    │`);
   log(`  │                                                  │`);
   log(`  │  Claude · Cline · Roo Code · Cursor · Windsurf  │`);
@@ -92,9 +93,9 @@ function showContext() {
     total += t;
     log(`  ${c.dim}  ${f.padEnd(30)} ~${t.toLocaleString()} tokens${c.reset}`);
   }
-  for (const [folder, files] of Object.entries(SUBFOLDERS)) {
+  for (const folder of SUBFOLDERS) {
     let ft = 0;
-    for (const f of files) ft += tokenCount(join(PKG_ROOT, folder, f));
+    for (const f of getMdFiles(folder)) ft += tokenCount(join(PKG_ROOT, folder, f));
     total += ft;
     log(`  ${c.dim}  ${(folder + '/').padEnd(30)} ~${ft.toLocaleString()} tokens${c.reset}`);
   }
@@ -104,6 +105,7 @@ function showContext() {
 }
 
 function install(baseDir, agentName) {
+  // Install main skill
   const dst = join(baseDir, SKILL_NAME);
   mkdirSync(dst, { recursive: true });
   let n = 0;
@@ -113,17 +115,26 @@ function install(baseDir, agentName) {
     cpSync(src, join(dst, f), { force: true });
     n++;
   }
-  for (const [folder, files] of Object.entries(SUBFOLDERS)) {
+  for (const folder of SUBFOLDERS) {
     const dstFolder = join(dst, folder);
     mkdirSync(dstFolder, { recursive: true });
-    for (const f of files) {
+    for (const f of getMdFiles(folder)) {
       const src = join(PKG_ROOT, folder, f);
-      if (!existsSync(src)) continue;
       cpSync(src, join(dstFolder, f), { force: true });
       n++;
     }
   }
   ok(`${c.bold}${SKILL_NAME}/${c.reset} → ${agentName} ${c.dim}(${dst})${c.reset}`);
+
+  // Auto-install humanizer-mobile as separate skill
+  const humanizerSrc = join(PKG_ROOT, 'humanizer', 'humanizer-mobile.md');
+  if (existsSync(humanizerSrc)) {
+    const humDst = join(baseDir, 'humanizer-mobile');
+    mkdirSync(humDst, { recursive: true });
+    cpSync(humanizerSrc, join(humDst, 'humanizer-mobile.md'), { force: true });
+    ok(`${c.bold}humanizer-mobile/${c.reset} → ${agentName} ${c.dim}(${humDst})${c.reset}`);
+  }
+
   return n;
 }
 
@@ -895,6 +906,22 @@ async function main() {
   } else if (flags.has('auto')) {
     targets = Object.keys(AGENTS).filter(k => AGENTS[k].detect());
     if (!targets.length) { info('No agents found. Using Claude.'); targets = ['claude']; }
+  } else if (flags.has('humanizer')) {
+    // Install humanizer-mobile as a separate skill
+    const src = join(PKG_ROOT, 'humanizer', 'humanizer-mobile.md');
+    if (!existsSync(src)) { fail('humanizer/humanizer-mobile.md not found'); process.exit(1); }
+    const detected = Object.keys(AGENTS).filter(k => AGENTS[k].detect());
+    const agentKeys = detected.length ? detected : ['claude'];
+    for (const k of agentKeys) {
+      const dst = join(AGENTS[k].dir, 'humanizer-mobile');
+      mkdirSync(dst, { recursive: true });
+      cpSync(src, join(dst, 'humanizer-mobile.md'), { force: true });
+      ok(`${c.bold}humanizer-mobile/${c.reset} → ${AGENTS[k].name} ${c.dim}(${dst})${c.reset}`);
+    }
+    log(`\n${c.green}${c.bold}  ✅ Done!${c.reset}\n`);
+    log(`  ${c.bold}Usage:${c.reset}`);
+    log(`    ${c.cyan}@humanizer-mobile${c.reset}  Humanize app store copy, release notes, error messages\n`);
+    return;
   } else if (flags.has('path')) {
     const p = args[args.indexOf('--path') + 1];
     if (!p) { fail('--path needs a directory'); process.exit(1); }

package/flutter/flutter.md

@@ -240,7 +240,65 @@ FirebaseMessaging.onMessage.listen((message) {
 | Firebase | firebase_core, messaging, firestore |
 | Image | cached_network_image |
 
+## Dart 3.x Patterns
+
+```dart
+// Sealed classes — exhaustive pattern matching (replaces abstract + subclasses)
+sealed class AuthState {}
+class Authenticated extends AuthState { final User user; Authenticated(this.user); }
+class Unauthenticated extends AuthState {}
+class Loading extends AuthState {}
+
+// Usage — compiler enforces all cases are handled
+Widget build() => switch (authState) {
+  Authenticated(:final user) => HomeScreen(user: user),
+  Unauthenticated()          => LoginScreen(),
+  Loading()                  => const CircularProgressIndicator(),
+};
+
+// Records — lightweight tuples with named fields (Dart 3.0)
+(String name, int age) getUser() => ('Alice', 30);
+final (name, age) = getUser();
+
+// Pattern matching in if/switch
+if (response case {'status': 'ok', 'data': final data}) {
+  processData(data);
+}
+
+// Riverpod + sealed class = clean state
+@riverpod
+class AuthNotifier extends _$AuthNotifier {
+  @override
+  AuthState build() => Unauthenticated();
+
+  Future<void> login(String email, String password) async {
+    state = Loading();
+    state = switch (await _repo.login(email, password)) {
+      Ok(:final value)  => Authenticated(value),
+      Err(:final error) => Unauthenticated(),  // or a separate Error state
+    };
+  }
+}
+```
+
+## Impeller (Flutter 3.10+)
+
+```
+Impeller is Flutter's new rendering engine — enabled by default on iOS.
+Android: opt-in via AndroidManifest.xml
+
+Benefits:
+- Eliminates shader compilation jank (the "jank on first frame" problem)
+- Consistent 60/120fps even on first run
+
+Enable on Android:
+<meta-data android:name="io.flutter.embedding.android.EnableImpeller" android:value="true" />
+
+Test: flutter run --enable-impeller
+```
+
 ---
 
 > Standard: Riverpod + get_it/injectable + Clean Architecture.
 > Dio/Retrofit for complex APIs. Floor for offline-first. Firebase for push/analytics.
+> Dart 3.x: sealed classes + records for type-safe state.

package/humanizer/humanizer-mobile.md

@@ -0,0 +1,295 @@
+# Humanizer — Mobile Copy & Text
+
+> Invoke with: @humanizer-mobile
+> Use for: app store descriptions, release notes, error messages, onboarding copy, push notifications, UI labels
+
+---
+
+## What this does
+
+Removes AI-generated writing patterns from mobile app text. Makes copy sound like a real person wrote it — not a language model.
+
+**Rule:** Sterile, voiceless writing is just as obvious as slop.
+
+---
+
+## The 24 AI Patterns to Kill
+
+### Content
+| Pattern | Example | Fix |
+|---------|---------|-----|
+| Inflated significance | "This significantly enhances the overall user experience" | "Checkout is now 3 steps instead of 7" |
+| Notability inflation | "A powerful, robust, feature-rich solution" | Just describe what it does |
+| Promotional language | "Seamlessly integrates with your workflow" | "Connects to Slack and Notion" |
+| Superficial -ing analysis | "By leveraging cutting-edge technology..." | State what the tech actually does |
+
+### Language
+| Pattern | Example | Fix |
+|---------|---------|-----|
+| Copula avoidance | "The app, being designed for..." | "The app works for..." |
+| Negative parallelism | "Not only fast, but also reliable, and furthermore secure" | Pick the one that matters most |
+| Rule of three | "Simple, powerful, and intuitive" | Say which one is actually true |
+| Elegant variation | "application... software... platform... tool..." | Pick one word and use it |
+
+### Style
+| Pattern | Example | Fix |
+|---------|---------|-----|
+| Em dash overuse | "Our app — designed for professionals — helps you..." | Rewrite the sentence |
+| Unnecessary bold | "This **feature** allows **users** to **manage** their **tasks**" | Bold nothing or bold the one key thing |
+| Inline headers mid-paragraph | "**Key features:** The app includes..." | Just write the features |
+| Emoji decoration | "🚀 Fast • 💪 Powerful • ✨ Beautiful" | Use 0 or 1 emoji max, never as decoration |
+
+### Communication (chatbot artifacts)
+| Pattern | Example | Fix |
+|---------|---------|-----|
+| "I hope this helps" | Any form of it | Delete |
+| "Feel free to..." | "Feel free to reach out" | "Contact us" |
+| "Please note that" | "Please note that this feature requires..." | "This feature requires..." |
+| Knowledge cutoff disclaimer | "As of my last update..." | Never use in app copy |
+| "Delve into" | "Delve into your analytics" | "Check your analytics" |
+| "Leverage" | "Leverage our AI" | "Use our AI" |
+| "Streamline" | "Streamline your workflow" | Say what actually gets faster |
+| "Robust" | "A robust solution" | Say what makes it strong |
+| "Seamlessly" | "Seamlessly integrates" | "Works with" or just remove |
+| "Intuitive" | "Intuitive interface" | Show don't tell — describe the UX |
+| "Comprehensive" | "Comprehensive dashboard" | Say what's in the dashboard |
+
+---
+
+## Mobile-Specific Rewrites
+
+### App Store Description
+
+```
+❌ AI:
+TaskFlow is a powerful, comprehensive task management application that seamlessly
+integrates with your existing workflow. By leveraging cutting-edge AI technology,
+it significantly enhances productivity and streamlines your daily operations.
+
+✅ Human:
+TaskFlow keeps your team's work in one place. Add tasks, assign them, set
+deadlines — everything syncs in real time. Works with Slack, Google Calendar,
+and Notion.
+```
+
+### Release Notes
+
+```
+❌ AI:
+Version 2.1.0 introduces significant enhancements to the overall user experience,
+including robust improvements to performance and reliability.
+
+✅ Human:
+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
+
+```
+❌ AI:
+We apologize for the inconvenience. An unexpected error has occurred while
+processing your request. Please try again later.
+
+✅ Human:
+Couldn't save your changes — no internet connection.
+[Try again] [Save for later]
+```
+
+### Onboarding Copy
+
+```
+❌ AI:
+Welcome to our powerful platform! By leveraging our intuitive interface,
+you'll be able to seamlessly manage all your tasks efficiently.
+
+✅ Human:
+Where do you want to start?
+[Import from Trello] [Start from scratch] [Use a template]
+```
+
+### Push Notifications
+
+```
+❌ AI:
+You have received a new message from a team member regarding an important update.
+
+✅ Human:
+Alex commented on "Landing page redesign"
+```
+
+### Empty States
+
+```
+❌ AI:
+No items found. Get started by creating your first item to begin
+leveraging the full power of the platform.
+
+✅ Human:
+No tasks yet.
+[Add your first task]
+```
+
+---
+
+## Two-Pass Process
+
+### Pass 1 — Rewrite
+1. Find all patterns from the table above
+2. Replace each with direct, specific language
+3. Remove filler words: "overall", "various", "multiple", "utilize", "leverage"
+4. Cut sentence length by 30%
+
+### Pass 2 — Anti-AI Audit
+Ask: *"What makes this obviously AI-generated?"*
+- Does it make a claim without evidence? → Add a number or cut the claim
+- Does it use an adjective where a verb would work? → Use the verb
+- Could this describe any app in the category? → Make it specific to THIS app
+- Would a person actually say this out loud? → If no, rewrite it
+
+---
+
+## Mobile Copy Principles
+
+```
+1. SPECIFIC BEATS VAGUE
+   ❌ "significantly faster"
+   ✅ "loads in under 1 second"
+
+2. VERBS BEAT ADJECTIVES
+   ❌ "intuitive navigation"
+   ✅ "swipe left to archive"
+
+3. SHORT SENTENCES FOR MOBILE
+   Max 12 words for notifications
+   Max 2 sentences for error messages
+   Max 3 sentences for onboarding screens
+
+4. SHOW DON'T TELL
+   ❌ "powerful search"
+   ✅ "search by name, tag, due date, or assignee"
+
+5. USER BENEFIT, NOT FEATURE
+   ❌ "real-time sync enabled"
+   ✅ "your team sees changes instantly"
+```
+
+---
+
+## App Store Character Limits
+
+```
+iOS App Store:
+  Title:          30 chars  → short, keyword-rich, no taglines
+  Subtitle:       30 chars  → 1 benefit, not a repeat of title
+  Description:   4000 chars → first 3 lines show before "More", make them count
+  Keywords:       100 chars → comma-separated, no spaces, no repeats from title
+  What's New:    4000 chars → bullet points, plain language, no marketing
+
+Google Play:
+  Title:          30 chars
+  Short desc:     80 chars  → shows in search results
+  Full desc:     4000 chars
+  What's New:    500 chars
+```
+
+```
+❌ Title: "TaskFlow - Ultimate Productivity & Task Management Solution"
+✅ Title: "TaskFlow: Team Tasks & Projects"
+
+❌ Subtitle: "The most powerful way to manage your workflow seamlessly"
+✅ Subtitle: "Shared tasks with real-time sync"
+
+❌ What's New: "This update introduces significant improvements to the overall
+user experience with enhanced performance and reliability."
+✅ What's New:
+• Fixed crash on iPhone 14 when swiping between projects
+• Dark mode now loads instantly instead of flashing white
+• Added swipe-to-complete on task cards
+```
+
+---
+
+## Permission Request Copy
+
+```
+❌ AI default (iOS):
+"[App] Would Like to Access Your Camera"
+(No context, user taps Don't Allow)
+
+✅ Custom NSCameraUsageDescription:
+"To scan receipts and attach photos to expenses"
+
+❌ "Notifications" permission with no context
+
+✅ Request at the right moment + explain:
+"Get notified when teammates comment on your tasks"
+[Allow] [Not now]
+```
+
+Common permission descriptions:
+| Permission | Bad | Good |
+|------------|-----|------|
+| Camera | "Access camera" | "Scan QR codes to join a workspace" |
+| Location | "Use your location" | "Show nearby team members on the map" |
+| Contacts | "Access contacts" | "Invite teammates by name instead of email" |
+| Notifications | "Send notifications" | "Alert you when your order ships" |
+| Microphone | "Access microphone" | "Record voice notes on tasks" |
+
+---
+
+## Rating Prompt Copy
+
+```
+❌ AI default:
+"Are you enjoying [App Name]? Rate us 5 stars!"
+
+✅ Human — ask a real question first:
+"Is [App] helping you get things done?"
+[Yes!] [Not really]
+
+If Yes → "Mind leaving a review? It helps us a lot."
+         [Sure] [Maybe later]
+If No  → "What's getting in the way?"
+         [Give feedback]
+```
+
+---
+
+## Subscription & Paywall Copy
+
+```
+❌ AI:
+"Unlock the full potential of our comprehensive premium features
+to seamlessly enhance your productivity experience."
+
+✅ Human — state what unlocks:
+"Go Pro
+• Unlimited projects (free plan: 3)
+• Team sharing
+• Priority support"
+[Start 7-day free trial]
+[See what's included]
+
+❌ CTA: "Subscribe Now" / "Upgrade Today" / "Get Premium"
+✅ CTA: "Start free trial" / "Unlock [specific feature]" / "Try Pro free"
+
+❌ After trial ends: "Your trial has expired. Please subscribe to continue."
+✅ "Your free trial ended. Pick a plan to keep your 12 projects."
+```
+
+---
+
+## Word Blacklist (delete on sight)
+
+```
+seamlessly / robust / powerful / comprehensive / intuitive / streamline /
+leverage / utilize / cutting-edge / state-of-the-art / innovative /
+revolutionary / game-changing / transformative / holistic / synergy /
+delve / Furthermore / Additionally / Moreover / In conclusion /
+It is worth noting / Please note that / Feel free to /
+experience the difference / take your [X] to the next level /
+designed with you in mind / your one-stop solution
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buivietphi/skill-mobile-mt",
-  "version": "1.3.0",
+  "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.",
   "author": "buivietphi",
   "license": "MIT",
@@ -31,7 +31,8 @@
     "flutter/",
     "ios/",
     "android/",
-    "shared/"
+    "shared/",
+    "humanizer/"
   ],
   "scripts": {
     "postinstall": "node bin/install.mjs --auto",

package/shared/offline-first.md

@@ -0,0 +1,377 @@
+# Offline-First — Mobile Data Strategy
+
+> On-demand. Load when: "offline", "offline-first", "cache", "sync", "local database", "persistence"
+> Source: Mattermost, Immich, Expensify, Ignite
+
+---
+
+## Architecture
+
+```
+┌─────────────────────────────────────┐
+│  UI Layer (reads local only)        │
+└──────────────┬──────────────────────┘
+               │
+┌──────────────▼──────────────────────┐
+│  Repository Layer (sync logic)      │
+└──────┬──────────────────────┬───────┘
+       │                      │
+┌──────▼──────┐     ┌─────────▼───────┐
+│  Local DB   │◄───►│   Remote API    │
+│  (primary)  │     │   (sync only)   │
+└─────────────┘     └─────────────────┘
+```
+
+**Rule:** UI always reads local. API is sync-only, never primary.
+
+---
+
+## React Native — WatermelonDB (Reference Implementation)
+
+### Schema
+
+```typescript
+// db/schema.ts
+export const schema = appSchema({
+  version: 1,
+  tables: [
+    tableSchema({
+      name: 'posts',
+      columns: [
+        { name: 'title', type: 'string' },
+        { name: 'body', type: 'string' },
+        { name: 'author_id', type: 'string' },
+        { name: 'created_at', type: 'number' },
+        { name: 'updated_at', type: 'number' },
+        { name: 'is_synced', type: 'boolean' },
+        { name: 'is_deleted', type: 'boolean' },  // soft delete required for sync
+      ],
+    }),
+  ],
+});
+```
+
+### Model
+
+```typescript
+export default class Post extends Model {
+  static table = 'posts';
+  static associations = {
+    comments: { type: 'has_many', foreignKey: 'post_id' },
+  };
+
+  @field('title') title!: string;
+  @field('body') body!: string;
+  @field('author_id') authorId!: string;
+  @readonly @date('created_at') createdAt!: Date;
+  @field('updated_at') updatedAt!: number;
+  @field('is_synced') isSynced!: boolean;
+  @field('is_deleted') isDeleted!: boolean;
+
+  async markAsDeleted() {
+    await this.update(post => {
+      post.isDeleted = true;
+      post.isSynced = false;
+    });
+  }
+}
+```
+
+### Sync Engine
+
+```typescript
+export async function syncDatabase() {
+  await synchronize({
+    database,
+    pullChanges: async ({ lastPulledAt }) => {
+      const { changes, timestamp } = await api.get('/sync', {
+        params: { last_pulled_at: lastPulledAt },
+      });
+      return { changes, timestamp };
+    },
+    pushChanges: async ({ changes, lastPulledAt }) => {
+      await api.post('/sync', { changes, last_pulled_at: lastPulledAt });
+    },
+    migrationsEnabledAtVersion: 1,
+  });
+}
+
+export function startBackgroundSync() {
+  const interval = setInterval(syncDatabase, 30000);
+  AppState.addEventListener('change', state => {
+    if (state === 'active') syncDatabase();
+  });
+  return () => clearInterval(interval);
+}
+```
+
+### Repository
+
+```typescript
+export class PostRepository {
+  private posts = database.get<Post>('posts');
+
+  getAll() {
+    return this.posts.query(
+      Q.where('is_deleted', false),
+      Q.sortBy('created_at', Q.desc),
+    ).fetch();
+  }
+
+  observeAll() {
+    return this.posts.query(
+      Q.where('is_deleted', false),
+      Q.sortBy('created_at', Q.desc),
+    ).observe();
+  }
+
+  async create(data: { title: string; body: string; authorId: string }) {
+    return database.write(async () => {
+      return this.posts.create(post => {
+        Object.assign(post, data);
+        post.isSynced = false;
+        post.isDeleted = false;
+        post.updatedAt = Date.now();
+      });
+    });
+  }
+
+  async update(post: Post, data: Partial<{ title: string; body: string }>) {
+    return database.write(async () =>
+      post.update(p => { Object.assign(p, data); p.isSynced = false; p.updatedAt = Date.now(); })
+    );
+  }
+
+  async delete(post: Post) {
+    return database.write(async () => post.markAsDeleted());
+  }
+}
+```
+
+---
+
+## Flutter — Drift + Riverpod
+
+### Key differences from RN
+
+```dart
+// Table definition
+class Posts extends Table {
+  TextColumn get id => text()();
+  TextColumn get title => text()();
+  BoolColumn get isSynced => boolean().withDefault(const Constant(false))();
+  BoolColumn get isDeleted => boolean().withDefault(const Constant(false))();
+  @override Set<Column> get primaryKey => {id};
+}
+
+// Watch (reactive, like observeAll)
+Stream<List<Post>> watchAllPosts() => (select(posts)
+  ..where((p) => p.isDeleted.equals(false))
+  ..orderBy([(p) => Ordering.desc(p.createdAt)]))
+  .watch();
+
+// Soft delete
+Future<void> softDeletePost(String id) => (update(posts)).write(
+  PostsCompanion(id: Value(id), isDeleted: const Value(true), isSynced: const Value(false)),
+);
+```
+
+```dart
+// Sync: check connectivity first
+Future<void> sync() async {
+  final result = await Connectivity().checkConnectivity();
+  if (result == ConnectivityResult.none) return;
+  await _pushChanges();
+  await _pullChanges();
+}
+
+// Background sync on connectivity restore
+Connectivity().onConnectivityChanged.listen((result) {
+  if (result != ConnectivityResult.none) sync();
+});
+```
+
+---
+
+## iOS — SwiftData (iOS 17+) / Core Data
+
+```swift
+@Model final class Post {
+    @Attribute(.unique) var id: String
+    var title: String
+    var isSynced: Bool = false
+    var isDeleted: Bool = false
+    var updatedAt: Date?
+}
+
+// Sync with NWPathMonitor
+private func startNetworkMonitoring() {
+    monitor.pathUpdateHandler = { [weak self] path in
+        Task { @MainActor in
+            if path.status == .satisfied { await self?.sync() }
+        }
+    }
+    monitor.start(queue: queue)
+}
+
+func sync() async {
+    guard isConnected else { return }
+    let unsynced = try await repository.fetchUnsynced()
+    for post in unsynced {
+        post.isDeleted
+            ? try await apiClient.deletePost(post.id)
+            : try await apiClient.upsertPost(post)
+        post.isSynced = true
+    }
+    let remote = try await apiClient.fetchPosts()
+    for post in remote { try await repository.upsert(post) }
+}
+```
+
+---
+
+## Android — Room + WorkManager
+
+```kotlin
+@Entity(tableName = "posts")
+data class PostEntity(
+    @PrimaryKey val id: String,
+    val title: String,
+    val isSynced: Boolean = false,
+    val isDeleted: Boolean = false,
+    val updatedAt: Long? = null,
+)
+
+@Dao interface PostDao {
+    @Query("SELECT * FROM posts WHERE isDeleted = 0 ORDER BY createdAt DESC")
+    fun observeAll(): Flow<List<PostEntity>>
+
+    @Query("SELECT * FROM posts WHERE isSynced = 0")
+    suspend fun getUnsynced(): List<PostEntity>
+
+    @Query("UPDATE posts SET isDeleted = 1, isSynced = 0 WHERE id = :id")
+    suspend fun softDelete(id: String)
+}
+
+// Use WorkManager for background sync (respects battery/network constraints)
+fun triggerSync() {
+    val request = OneTimeWorkRequestBuilder<SyncWorker>()
+        .setConstraints(Constraints.Builder().setRequiredNetworkType(NetworkType.CONNECTED).build())
+        .build()
+    WorkManager.getInstance(context).enqueue(request)
+}
+```
+
+---
+
+## Conflict Resolution
+
+```typescript
+// 1. Last Write Wins (simple, most apps)
+const resolve = (local: Post, remote: Post) =>
+  local.updatedAt > remote.updatedAt ? local : remote;
+
+// 2. Field-Level Merge (collaborative editing)
+const merge = (local: Post, remote: Post, base: Post) => ({
+  ...base,
+  title: local.title !== base.title ? local.title : remote.title,
+  body: local.body !== base.body ? local.body : remote.body,
+  updatedAt: Date.now(),
+});
+
+// 3. Operational Transform (counters/accumulators)
+const resolveCounter = (local: Counter, remote: Counter, base: Counter) => ({
+  ...remote,
+  value: base.value + (local.value - base.value) + (remote.value - base.value),
+});
+```
+
+---
+
+## UI Components
+
+```typescript
+// Offline banner
+export function OfflineBanner() {
+  const [isOffline, setIsOffline] = useState(false);
+  useEffect(() => NetInfo.addEventListener(s => setIsOffline(!s.isConnected)), []);
+  if (!isOffline) return null;
+  return <Banner message="Offline — changes sync when connected." />;
+}
+
+// Sync status
+type SyncStatus = 'synced' | 'pending' | 'syncing' | 'error';
+const STATUS_CONFIG = {
+  synced:  { icon: 'check-circle', color: 'green' },
+  pending: { icon: 'clock',        color: 'orange' },
+  syncing: { icon: 'sync',         color: 'blue' },
+  error:   { icon: 'alert-circle', color: 'red' },
+};
+
+// Optimistic update with rollback
+const updateOptimistic = async (id: string, updates: Partial<Post>) => {
+  const prev = queryClient.getQueryData(['posts', id]);
+  queryClient.setQueryData(['posts', id], old => ({ ...old, ...updates }));
+  try {
+    await repository.update(id, updates);
+    await syncDatabase();
+  } catch {
+    queryClient.setQueryData(['posts', id], prev);
+  }
+};
+```
+
+---
+
+## Database Selection
+
+| DB | Platform | Use when |
+|----|----------|----------|
+| **WatermelonDB** | React Native | Complex queries, observables, built-in sync |
+| **MMKV** | React Native | Key-value only, speed critical |
+| **Realm** | RN / Flutter / iOS | Cross-platform, reactive |
+| **SQLite** | All | Full SQL control |
+| **Drift** | Flutter | Type-safe, migrations, code gen |
+| **SwiftData** | iOS 17+ | Simple models, native |
+| **Core Data** | iOS | Complex relationships, migrations |
+| **Room** | Android | Flow/LiveData integration |
+
+---
+
+## Checklist
+
+```
+Data:
+□ All data written to local DB first
+□ Soft deletes (never hard delete)
+□ isSynced flag per record
+□ Conflict resolution strategy defined
+□ Retry for failed syncs
+
+UI:
+□ Offline banner
+□ Sync status indicator
+□ Optimistic updates
+□ Pull-to-refresh triggers sync
+
+Sync:
+□ Sync on app foreground
+□ Sync on connectivity restore
+□ Background sync (30s interval)
+□ Sync doesn't block UI thread
+```
+
+---
+
+## Anti-Patterns
+
+```
+❌ UI reads directly from API
+❌ Blocking UI during sync
+❌ Hard deletes (breaks sync)
+❌ Syncing on every keystroke
+❌ No retry for failed syncs
+❌ No offline indicator
+❌ Assuming network is available
+❌ Losing data on conflict
+```

package/shared/platform-excellence.md

@@ -144,6 +144,86 @@ export const LoginScreen = Platform.select({
 
 ---
 
+## iOS Haptics
+
+```swift
+// 3 feedback types — use the right one
+UIImpactFeedbackGenerator(style: .medium).impactOccurred()  // button tap, card flip
+UINotificationFeedbackGenerator().notificationOccurred(.success)  // save success / error / warning
+UISelectionFeedbackGenerator().selectionChanged()  // picker scroll, toggle
+
+// ✅ Rules
+// - Impact: physical interactions (drag drop, button press)
+// - Notification: outcomes (success, error, warning) — max 1 per action
+// - Selection: discrete value changes (picker, slider step)
+// ⛔ Never chain multiple haptics in <300ms
+// ⛔ Never use for routine navigation (back, tab switch)
+```
+
+## Permission Timing (iOS/Android)
+
+```
+RULE: Ask ONLY when the feature needs it — not at launch
+
+Permission     When to ask
+─────────────────────────────────────────────────────
+Camera         User taps "Take Photo" button
+Location       User taps "Find Nearby" or map feature
+Contacts       User taps "Invite from Contacts"
+Notifications  After onboarding, show a pre-permission dialog first
+Microphone     User taps "Record Voice Note"
+
+PRE-PERMISSION DIALOG (iOS — before system prompt):
+"Get notified when teammates reply"
+[Allow] [Not now]
+→ Only show system prompt if user taps Allow
+→ Saves 1 chance at permission — don't waste it at cold start
+```
+
+## Ratings Timing
+
+```
+// 2-step flow — ask only after success
+Step 1: "Is [App] helping you get things done?"
+        [Yes!] [Not really]
+
+Step 2 (if Yes): "Mind leaving a review? It helps us a lot."
+                 [Sure] [Maybe later]
+Step 2 (if No):  "What's getting in the way?" [Give feedback]
+
+// iOS: Use SKStoreReviewController.requestReview() — max 3x/year
+// Android: Use ReviewManager from Play Core library
+// NEVER ask after an error, payment, or on app cold start
+```
+
+## Live Activities / Dynamic Island (iOS 16.1+)
+
+```swift
+// 1. Define attributes
+struct DeliveryAttributes: ActivityAttributes {
+    struct ContentState: Codable, Hashable {
+        var status: String
+        var eta: Date
+    }
+    var orderId: String
+}
+
+// 2. Start activity
+let initialState = DeliveryAttributes.ContentState(status: "Preparing", eta: Date())
+let activity = try? Activity.request(
+    attributes: DeliveryAttributes(orderId: "123"),
+    content: .init(state: initialState, staleDate: nil)
+)
+
+// 3. Update
+await activity?.update(.init(state: .init(status: "Out for delivery", eta: Date()), staleDate: nil))
+
+// 4. End
+await activity?.end(dismissalPolicy: .default)
+```
+
+---
+
 ## Anti-Patterns
 
 ```
@@ -151,9 +231,14 @@ export const LoginScreen = Platform.select({
 ❌ iOS navigation on Android
 ❌ Ignoring platform conventions
 ❌ "Write once, look mediocre everywhere"
+❌ Asking permissions at app launch
+❌ Chaining multiple haptics back-to-back
+❌ Rating prompt right after install
 
 ✅ Native look & feel per platform
 ✅ Shared logic, platform UI
 ✅ Respect platform guidelines
 ✅ "Write once, look native everywhere"
+✅ Ask permissions at the moment they're needed
+✅ Rating prompts only after clear success moments
 ```