mobile-app-architect

name	mobile-app-architect
description	Architecture d'applications mobiles (native, cross-platform, hybrid). Se déclenche avec "architecture mobile", "app mobile", "native vs cross-platform", "Flutter vs React Native", "MVVM", "Clean Architecture mobile", "offline first". Also triggers on "mobile app architecture", "offline-first mobile".

Mobile App Architect

Workflow

1. Qualifier le besoin avant de choisir un framework

Poser ces questions avant toute décision :

Critère	Impact
Plateformes cibles	iOS seul → Swift/SwiftUI ; Android seul → Kotlin/Compose ; les deux → cross-platform
Animations custom & jeux	Natif ou Flutter (Impeller) ; React Native acceptable avec Skia
Accès hardware spécifique (BLE, NFC, ARKit)	Natif de préférence ; sinon plugin Flutter/RN à vérifier avant de committer
Taille équipe / compétences	Équipe JS → React Native ; équipe C# → MAUI ; équipe polyvalente → Flutter
Time-to-market	Cross-platform réduit ~30-40 % du temps pour les apps "standard"
Performance critique (<16 ms frames)	Flutter (Dart AOT) ou natif ; React Native avec JSI+Fabric acceptable

---

2. Choisir la stack technologique

Matrice de décision rapide (2026) :

Native iOS   → Swift 6 + SwiftUI 5 + Combine/Swift Concurrency
Native Android → Kotlin 2 + Jetpack Compose 1.7 + Coroutines + Flow
Flutter      → Dart 3 + Flutter 3.22+ + Riverpod 2 + Impeller (default)
React Native → RN 0.75+ + Expo SDK 52 + New Architecture (Fabric+JSI) activée
KMP          → Kotlin Multiplatform + Compose Multiplatform (UI partagée si besoin)
MAUI         → .NET 9 + MAUI pour équipes C# existantes

Règle empirique :

• App vitrine / catalogue / dashboard → Flutter ou RN, gain de temps net
• App fintech / bancaire critique → natif par plateforme ou KMP (logique partagée, UI native)
• App déjà en Swift/Kotlin → ajouter KMP plutôt que réécrire

---

3. Architecturer les couches (Clean Architecture mobile)

Structure recommandée (indépendante du framework) :

presentation/
  screens/         ← UI pure, aucune logique métier
  viewmodels/      ← expose des états immuables à la vue
domain/
  usecases/        ← une classe = une action métier
  entities/        ← modèles purs sans annotations framework
  repositories/    ← interfaces uniquement
data/
  repositories/    ← implémentations concrètes
  datasources/
    remote/        ← API REST/GraphQL/gRPC
    local/         ← Room, sqflite, Core Data, SQLDelight
  models/          ← DTOs + mappers vers entities

Pattern par framework :

Framework	Pattern recommandé	Alternative
Flutter	BLoC 8+ ou Riverpod 2	Provider (legacy)
React Native	Zustand + React Query	Redux Toolkit
SwiftUI	MVVM + @Observable (iOS 17)	TCA (The Composable Architecture)
Jetpack Compose	MVVM + ViewModel + StateFlow	MVI avec Orbit/MoleculeFlow

Exemple Flutter (Riverpod + UseCase) :

// domain/usecases/get_transactions.dart
class GetTransactions {
  final TransactionRepository _repo;
  const GetTransactions(this._repo);
  Future<List<Transaction>> call(String accountId) => _repo.fetch(accountId);
}

// presentation/providers/transactions_provider.dart
@riverpod
Future<List<Transaction>> transactions(Ref ref, String accountId) {
  return ref.watch(getTransactionsProvider).call(accountId);
}

---

4. Navigation et deep linking

// Flutter — GoRouter 14+ (type-safe routes)
@TypedGoRoute<HomeRoute>(path: '/')
class HomeRoute extends GoRouteData {
  const HomeRoute();
  Widget build(BuildContext context, GoRouterState state) => const HomeScreen();
}

// Deep link universel : https://app.example.com/payment/42
// → GoRouter intercepte via flutter_branch_io ou firebase_dynamic_links

// SwiftUI — NavigationStack (iOS 16+)
NavigationStack(path: $path) {
    ContentView()
        .navigationDestination(for: Route.self) { route in
            switch route {
            case .payment(let id): PaymentDetailView(id: id)
            }
        }
}

---

5. Data layer : offline-first

Stratégie en 4 temps :

1. Lecture → SQLite local en source de vérité ; réseau en refresh asynchrone (stale-while-revalidate)
2. Écriture → file de mutations offline (Drift/Room + worker background)
3. Sync → résolution de conflits : Last-Write-Wins par défaut, CRDT si collaboration temps réel
4. Connectivité → surveiller connectivity_plus (Flutter) / NetInfo (RN) pour déclencher la sync

// Android — Room + WorkManager (offline queue)
@Entity data class PendingOperation(
    @PrimaryKey val id: String = UUID.randomUUID().toString(),
    val payload: String,   // JSON sérialisé
    val retries: Int = 0,
    val createdAt: Long = System.currentTimeMillis()
)

---

6. Sécurité mobile — checklist actionnable

• Certificate pinning : dio + http_certificate_pinning (Flutter) / TrustKit (iOS) / OkHttp CertificatePinner (Android)
• Secure storage : flutter_secure_storage / KeyStore Android / Keychain iOS — jamais SharedPreferences/UserDefaults pour tokens
• Biométrie : local_auth (Flutter) — toujours fallback PIN, jamais bloquer l'accès
• Obfuscation : flutter build apk --obfuscate --split-debug-info=./debug ; ProGuard/R8 activé en release Android
• Jailbreak/root detection : flutter_jailbreak_detection — adapter la réponse (désactiver features sensibles, ne pas crasher)
• Pas de secrets dans le code : .env via flutter_dotenv, jamais committé ; secrets injectés en CI via Secrets Manager

---

7. Performance — points de contrôle critiques

# Flutter — profiling
flutter run --profile
flutter pub run flutter_launcher_icons  # vérifier tailles
# DevTools → Timeline, Memory, CPU Profiler

# React Native — Hermes + Flipper
npx react-native start --experimental-debugger
# Activer Hermes dans android/app/build.gradle : hermesEnabled = true

Cibles 2026 :

• Startup à froid < 2 s (budget : splash → premier frame interactif)
• Frame budget : 16 ms (60 fps) / 8 ms (120 fps — iPad Pro, Pixel 9)
• APK/IPA < 30 MB pour le premier install ; assets en lazy loading

---

8. CI/CD mobile

# GitHub Actions — Flutter
- uses: subosito/flutter-action@v2
  with: { flutter-version: '3.22.x', channel: 'stable' }
- run: flutter test --coverage
- run: flutter build appbundle --release --obfuscate --split-debug-info=./debug-symbols
- uses: r0adkll/upload-google-play@v1   # deploy Play Store

# Fastlane — iOS
lane :beta do
  match(type: "appstore")           # certificates via git repo chiffré
  build_ios_app(scheme: "MyApp")
  upload_to_testflight
  slack(message: "Beta #{lane_context[SharedValues::BUILD_NUMBER]} uploadé")
end

Versioning automatique :

# Incrémenter build number depuis le numéro de run CI
VERSION_CODE=$GITHUB_RUN_NUMBER
flutter build apk --build-number=$VERSION_CODE

---

Anti-patterns à éviter

Anti-pattern	Pourquoi c'est un problème	Correction
Logique métier dans les Widgets/Views	Impossible à tester, couplage fort	Extraire dans ViewModel/UseCase
setState() global dans Flutter	Re-renders inutiles, performance	Riverpod/BLoC scoped
Appels réseau sans retry/timeout	UX cassée sur réseau mobile instable	Dio interceptors + retry package
Tokens JWT en clair dans AsyncStorage	Vol trivial via backup ADB	Secure Storage obligatoire
Gros monorepo sans lazy imports	Startup time > 4 s	Code splitting + deferred loading
Navigation par routes string	Erreurs silencieuses à runtime	Routes typées (GoRouter, TCA Router)
Tests uniquement sur simulateur	Ne détecte pas les régressions perf réelles	Firebase Test Lab / AWS Device Farm

---

Bonnes pratiques 2026

• Swift 6 strict concurrency : activer SWIFT_STRICT_CONCURRENCY = complete dès le départ, évite les data races
• Compose Multiplatform : stable pour iOS depuis fin 2024, viable pour les apps non-critique en perf
• Expo EAS : remplace Fastlane pour React Native dans la majorité des projets (build cloud, OTA updates)
• Impeller (Flutter) : activé par défaut sur Android depuis Flutter 3.22 — profiler avec flutter run --profile si régressions
• Privacy manifests (iOS 17+) : obligatoire pour toute soumission App Store — déclarer chaque API accédant aux données utilisateur
• AGP 8+ / Gradle 8+ : activer nonTransitiveRClass = true et enableR8FullMode = true pour réduire la taille APK