WalletTracker/TROUBLESHOOTING.md

🔧 Guide de dépannage - WalletTracker

Problème : L'app charge jusqu'au timeout après scan du QR code

✅ Solutions appliquées

1. Mise à jour des dépendances incompatibles

   npx expo install --fix
   

2. Configuration Metro améliorée

   • Ajout de metro.config.js avec timeout augmenté
   • Optimisation du bundler

3. Graphiques temporairement désactivés

   • react-native-chart-kit peut causer des problèmes de chargement
   • Remplacé par un placeholder dans AnalysisScreen
   • Sera réactivé après configuration complète

🚀 Relancer l'application

# Nettoyer le cache
npm start -- --clear

# Ou redémarrer complètement
rm -rf node_modules
npm install
npm start -- --clear

📱 Vérifications réseau

1. Même réseau Wi-Fi

   • Votre ordinateur et téléphone doivent être sur le même réseau
   • Désactivez les VPN si actifs

2. Pare-feu

   • Autorisez Expo dans votre pare-feu
   • Port 8081 doit être ouvert

3. Mode tunnel (si problème réseau)

   npm start -- --tunnel
   

   ⚠️ Plus lent mais fonctionne même avec des réseaux différents

🔍 Diagnostic

Si le problème persiste, vérifiez :

# 1. Vérifier la connexion
ping 192.168.1.132

# 2. Vérifier que Metro tourne
# Vous devriez voir "Metro waiting on exp://..."

# 3. Tester sur le web d'abord
npm run web

📊 Réactiver les graphiques (plus tard)

Une fois l'app fonctionnelle, pour réactiver les graphiques :

1. Installer les dépendances natives :

   npx expo install react-native-svg
   

2. Dans src/screens/AnalysisScreen.tsx :

   • Décommenter import { PieChart } from 'react-native-chart-kit'
   • Remplacer le placeholder par <PieChart ... />

3. Rebuild l'app

🆘 Autres problèmes courants

Erreur "Unable to resolve module"

npm start -- --clear

Erreur "Network request failed"

• Vérifiez votre connexion Internet
• Essayez le mode tunnel : npm start -- --tunnel

L'app crash au démarrage

• Vérifiez que Firebase est configuré dans src/config/firebase.ts
• Regardez les logs dans le terminal

"Expo Go" ne trouve pas l'app

• Assurez-vous que les deux appareils sont sur le même réseau
• Redémarrez Expo Go
• Rescannez le QR code

💡 Conseils

1. Première fois : Utilisez npm start -- --clear pour un démarrage propre
2. Développement : Le rechargement à chaud peut parfois causer des bugs, rechargez manuellement (secouer le téléphone > Reload)
3. Production : Les graphiques fonctionneront mieux dans un build natif

📞 Besoin d'aide ?

Si le problème persiste :

1. Vérifiez les logs dans le terminal
2. Regardez les erreurs dans Expo Go (secouer > Show Dev Menu > Debug)
3. Consultez la documentation Expo : https://docs.expo.dev/

✅ Checklist de vérification

• Dépendances mises à jour (npx expo install --fix)
• Cache nettoyé (npm start -- --clear)
• Même réseau Wi-Fi
• Pare-feu autorise Expo
• Firebase configuré (si vous testez l'auth)
• QR code scanné avec Expo Go (pas l'appareil photo)

---

L'app devrait maintenant se charger correctement ! 🎉