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

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 ! 💪**