Files
WalletTracker/QUICKSTART.md
Arthur Lempereur 5eb5c7a2f8 Add utilities, constants, sample data and quick start guide
- Add helper functions (formatCurrency, formatDate, validation, etc.)
- Add constants (colors, spacing, error messages, etc.)
- Add sample data generator for testing
- Add QUICKSTART.md for quick setup
- Update app.json with proper configuration
2025-10-23 14:39:15 +02:00

3.2 KiB

🚀 Démarrage rapide - WalletTracker

Guide pour lancer l'application en 5 minutes.

Étape 1 : Vérifier les prérequis

# Vérifier Node.js (v16+)
node --version

# Vérifier npm
npm --version

Étape 2 : Installer les dépendances

cd WalletTracker
npm install

Étape 3 : Configurer Firebase

Option A : Configuration rapide (pour tester)

  1. Allez sur https://console.firebase.google.com/
  2. Créez un nouveau projet "WalletTracker"
  3. Ajoutez une application Web
  4. Copiez les identifiants dans src/config/firebase.ts

Option B : Configuration complète

Suivez le guide détaillé dans FIREBASE_SETUP.md

Étape 4 : Lancer l'application

npm start

Vous verrez un QR code s'afficher dans le terminal.

Étape 5 : Tester sur votre téléphone

Sur iOS ou Android :

  1. Téléchargez Expo Go depuis l'App Store ou Google Play
  2. Ouvrez Expo Go
  3. Scannez le QR code affiché dans le terminal
  4. L'application se chargera automatiquement

Sur émulateur :

iOS (Mac uniquement) :

npm run ios

Android :

npm run android

🎉 C'est prêt !

Vous devriez voir l'écran de connexion de WalletTracker.

Première utilisation :

  1. Cliquez sur "Créer un compte"
  2. Remplissez le formulaire :
    • Nom : Votre nom
    • Email : votre@email.com
    • Mot de passe : minimum 6 caractères
  3. Cliquez sur "Créer mon compte"
  4. Vous êtes redirigé vers le Dashboard !

Ajouter votre première transaction :

  1. Cliquez sur le bouton "Dépense" ou "Revenu"
  2. Entrez le montant
  3. Sélectionnez une catégorie
  4. Ajoutez une note (optionnel)
  5. Cliquez sur "Ajouter la transaction"

📱 Commandes utiles

# Lancer l'application
npm start

# Lancer sur iOS
npm run ios

# Lancer sur Android
npm run android

# Lancer sur le web
npm run web

# Nettoyer le cache
npm start -- --clear

🐛 Problèmes courants

L'application ne se lance pas

# Nettoyer et réinstaller
rm -rf node_modules
npm install
npm start -- --clear

Erreur Firebase

Vérifiez que vous avez bien :

  • Copié les identifiants Firebase dans src/config/firebase.ts
  • Activé Authentication (Email/Password) dans Firebase Console
  • Créé la base de données Firestore

QR code ne fonctionne pas

  • Assurez-vous que votre téléphone et ordinateur sont sur le même réseau Wi-Fi
  • Essayez de scanner avec l'appareil photo puis ouvrir avec Expo Go
  • Utilisez le mode tunnel : npm start -- --tunnel

📚 Prochaines étapes

  • Lisez le README.md pour comprendre l'architecture
  • Consultez FIREBASE_SETUP.md pour la configuration complète
  • Utilisez TESTING.md pour tester toutes les fonctionnalités

💡 Conseils

  • Développement : Utilisez npm start et Expo Go pour un rechargement rapide
  • Production : Utilisez EAS Build pour créer des binaires iOS/Android
  • Débogage : Secouez votre téléphone pour ouvrir le menu de développement

🆘 Besoin d'aide ?


Bon développement ! 💪