- 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
150 lines
3.2 KiB
Markdown
150 lines
3.2 KiB
Markdown
# 🚀 Démarrage rapide - WalletTracker
|
|
|
|
Guide pour lancer l'application en 5 minutes.
|
|
|
|
## Étape 1 : Vérifier les prérequis
|
|
|
|
```bash
|
|
# Vérifier Node.js (v16+)
|
|
node --version
|
|
|
|
# Vérifier npm
|
|
npm --version
|
|
```
|
|
|
|
## Étape 2 : Installer les dépendances
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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)** :
|
|
```bash
|
|
npm run ios
|
|
```
|
|
|
|
**Android** :
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
# 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
|
|
|
|
```bash
|
|
# 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 ?
|
|
|
|
- Documentation Expo : https://docs.expo.dev/
|
|
- Documentation Firebase : https://firebase.google.com/docs
|
|
- React Native : https://reactnative.dev/docs/getting-started
|
|
|
|
---
|
|
|
|
**Bon développement ! 💪**
|