@buivietphi/skill-mobile-mt 1.3.0 → 1.4.0

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,24 @@ 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)
+    ├── on-device-ai.md              ← Core ML / TFLite / llama.cpp patterns (700 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 +83,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.
@@ -107,6 +110,7 @@ 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` |
+| "On-device AI / ML / inference" | `shared/on-device-ai.md` |
 
 **Load cost:** +500 to +3,500 tokens per on-demand file.
 
@@ -116,7 +120,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 +145,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:
@@ -174,6 +178,7 @@ skill:
         # - shared/document-analysis.md
         # - shared/release-checklist.md
         # - shared/common-pitfalls.md
+        # - shared/on-device-ai.md
 
     project:
       description: "Read current project, adapt to its framework and conventions"
@@ -208,9 +213,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%"
 ```
 
 ---
@@ -256,6 +261,7 @@ Every agent MUST follow this loading sequence:
    - shared/observability.md          (when adding logging, analytics, crash tracking)
    - shared/common-pitfalls.md        (when encountering unfamiliar errors)
    - shared/release-checklist.md      (when preparing for App Store/Play Store submission)
+   - shared/on-device-ai.md           (when adding Core ML / TFLite / on-device inference)
 
 7. SKIP non-matching platform subfolders (saves ~66% context)
 ```
@@ -277,6 +283,7 @@ 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/on-device-ai.md — Core ML / TFLite / llama.cpp
 ```
 
 ---
@@ -455,7 +462,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,14 @@ 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/on-device-ai.md` | 700 |
 | `shared/claude-md-template.md` | ~500 |
 | `shared/agent-rules-template.md` | ~2,500 |
-| **Total** | **~46,000** |
+| **Total** | **~49,500** |
 
 ## Installed Structure
 
@@ -287,10 +289,12 @@ 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
+        ├── on-device-ai.md            Core ML / TFLite / llama.cpp
         ├── claude-md-template.md      CLAUDE.md template for projects
         └── agent-rules-template.md    Rules templates for all agents
 ```
@@ -385,7 +389,8 @@ 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)
+- **On-Device AI** (`on-device-ai.md`): Decision matrix (API vs on-device), Core ML (iOS), ML Kit + MediaPipe (Android), llama.cpp cross-platform, TFLite Flutter, React Native ML Kit — with performance rules and model size guidance
 - **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 +426,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.0"
 author: buivietphi
 priority: high
 user-invocable: true
@@ -126,6 +126,13 @@ 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
+
+"On-device AI / ML / inference" → Read: shared/on-device-ai.md
+                                  then: choose Core ML / TFLite / llama.cpp per platform
+
 ```
 
 **⛔ NEVER start coding without identifying the task type first.**
@@ -1358,9 +1365,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 +1381,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.0           │`);
   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.