# Cloner et installer
git clone git@git.fnix.fr:alempereur/WalletTracker.git
cd WalletTracker
npm install

# Configurer Firebase (copiez vos identifiants)
cp .env.example .env
# Éditez .env avec vos identifiants Firebase

# Lancer l'app
npm start

3. Scanner et tester

Scannez le QR code avec Expo Go
Créez un compte de test
Ajoutez votre première transaction !

Pour la configuration Firebase détaillée : consultez Configuration-Firebase

📚 Installation complète

Prérequis détaillés

Node.js v16 ou supérieur (Télécharger)
npm ou yarn
Expo Go sur votre téléphone (iOS | Android)
Compte Firebase (gratuit) (Créer un compte)
Git (Télécharger)

Étapes d'installation

1. Cloner le projet

git clone git@git.fnix.fr:alempereur/WalletTracker.git
cd WalletTracker

2. Installer les dépendances

npm install

Cette commande installera toutes les dépendances nécessaires listées dans package.json.

3. Configurer Firebase

Consultez le guide Configuration-Firebase pour les détails complets.

En résumé :

Créez un projet Firebase
Copiez les identifiants dans src/config/firebase.ts
Activez Authentication (Email/Password)
Créez une base Firestore
Configurez les règles de sécurité

4. Vérifier l'installation

# Vérifier que tout est installé
npm run check

# Vérifier TypeScript
npx tsc --noEmit

5. Lancer l'application

npm start

Un QR code s'affichera dans le terminal.

6. Tester sur votre appareil

Sur téléphone :

Ouvrez Expo Go
Scannez le QR code
L'app se charge automatiquement

Sur émulateur :

# iOS (Mac uniquement)
npm run ios

# Android
npm run android

# Web
npm run web

Structure du projet

WalletTracker/
├── App.tsx                 # Point d'entrée
├── src/
│   ├── components/         # Composants réutilisables
│   │   ├── Button.tsx
│   │   ├── InputText.tsx
│   │   ├── TransactionCard.tsx
│   │   └── SubscriptionCard.tsx
│   │
│   ├── config/             # Configuration
│   │   └── firebase.ts     # ⚠️ À configurer
│   │
│   ├── hooks/              # Custom hooks
│   │   └── useAuth.ts
│   │
│   ├── navigation/         # Navigation
│   │   └── AppNavigator.tsx
│   │
│   ├── screens/            # Écrans
│   │   ├── LoginScreen.tsx
│   │   ├── SignupScreen.tsx
│   │   ├── DashboardScreen.tsx
│   │   ├── TransactionScreen.tsx
│   │   ├── SubscriptionScreen.tsx
│   │   └── AnalysisScreen.tsx
│   │
│   ├── services/           # Services Firebase
│   │   ├── authService.ts
│   │   ├── transactionService.ts
│   │   ├── subscriptionService.ts
│   │   └── categoryService.ts
│   │
│   ├── types/              # Types TypeScript
│   │   └── index.ts
│   │
│   └── utils/              # Utilitaires
│       ├── constants.ts
│       ├── helpers.ts
│       └── sampleData.ts
│
├── package.json            # Dépendances
├── tsconfig.json           # Config TypeScript
├── app.json                # Config Expo
└── firestore.rules         # Règles Firestore

Problèmes courants

Erreur "Unable to resolve module"

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

Erreur de réseau

Utilisez le mode tunnel :

npm start -- --tunnel

L'app ne charge pas

Vérifiez que le serveur Metro tourne
Assurez-vous d'être sur le même Wi-Fi
Consultez Dépannage pour plus de solutions

Configuration avancée

Variables d'environnement

Créez un fichier .env à la racine :

FIREBASE_API_KEY=your_api_key
FIREBASE_AUTH_DOMAIN=your_auth_domain
# etc...

Mode développement vs production

# Développement (avec hot reload)
npm start

# Production (optimisé)
npm start -- --no-dev --minify

📚 Prochaines étapes

Maintenant que l'installation est terminée :

Configuration-Firebase - Configurer Firebase en détail
Tests - Tester toutes les fonctionnalités
Développement - Comprendre l'architecture du code
Déploiement - Publier sur les stores

🆘 Besoin d'aide ?

Dépannage - Solutions aux problèmes courants
Documentation Expo : https://docs.expo.dev/
Documentation Firebase : https://firebase.google.com/docs

Installation terminée ! L'app devrait maintenant fonctionner. 🎉