# Dépanner

> Symptômes fréquents (QR, écran blanc, module natif, types, RLS, cache Metro, hooks, Maestro) avec leur cause probable et l'action à mener.

Un symptôme, sa cause probable, l'action. Si rien ne correspond : `/daroms-fix` lit les erreurs (doctor, tsc, Metro, shot), corrige et relance, trois essais au plus, puis rend un rapport.

| Symptôme | Cause probable | Action |
|---|---|---|
| iPhone : « aucune donnée utilisable » au scan du QR | QR de build de dev (`exp+<app>://`) sans build installé | `bun daroms dev` (Expo Go) ; build de dev : `bun daroms build development` puis `--dev-client` |
| Le QR s'ouvre mais l'app ne charge pas | téléphone sur un autre réseau | même Wi-Fi, ou `bun daroms dev --tunnel` |
| Écran blanc, erreur rouge | exception au rendu | `bun daroms shot /route` (message), `/daroms-fix` |
| `Unable to resolve module` | paquet absent ou cache | `bunx expo install <paquet>` ; `bun daroms dev --clear` |
| Module natif introuvable dans Expo Go | MMKV, RevenueCat, push | `bun daroms build development` (client de dev) |
| Erreur de type sur une route | types de routes périmés | `bun daroms doctor` (les régénère) |
| Données vides alors que la table est remplie | RLS | vérifier les politiques et `auth.uid()` ; utilisateur connecté ? |
| Manifest ignoré sur le web | cache Metro | `bun daroms shot` redémarre le serveur ; sinon `bun daroms dev --web --clear` |
| Hook qui refuse une écriture | règle daroms | lire le message, corriger (pas de contournement) |
| `.env` refusé | protection des secrets | lire `.env.example` ; demander les valeurs à l'humain |
| Maestro : « driver did not start » ou gRPC UNAVAILABLE | Android très récent (API 37) ou émulateur lent | Maestro >= 2.11 puis `bun daroms e2e --go --driver` (pré-lance l'instrumentation) |
| Expo Go ne s'installe pas (`Fetching Expo Go` bloqué) | téléchargement lent | télécharger l'APK (adresse via `https://api.expo.dev/v2/versions`) puis `adb install` |

---

Page HTML : https://daromsartof.github.io/daroms-speedapp/guides/depanner/
Index de la documentation : https://daromsartof.github.io/daroms-speedapp/llms.txt