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
This commit is contained in:
149
QUICKSTART.md
Normal file
149
QUICKSTART.md
Normal file
@@ -0,0 +1,149 @@
|
||||
# 🚀 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 ! 💪**
|
||||
Reference in New Issue
Block a user