AudiOhm/archives/docs/START_GUIDE.md

🎵 AudiOhm - Guide de Démarrage Rapide

🚀 Démarrage Rapide (3 Options)

Option 1: Web (Le Plus Simple)

Avantages:

• Aucune installation requise
• Lance dans le navigateur
• Idéal pour tester rapidement

# Dans le dossier frontend
cd /opt/audiOhm/frontend
flutter run -d chrome

L'application s'ouvrira automatiquement dans Chrome.

---

Option 2: Mode Développement

Web (Recommandé)

cd /opt/audiOhm/frontend
flutter run -d chrome

Android (Émulateur requis)

cd /opt/audiOhm/frontend
flutter run -d android

Windows Desktop

cd /opt/audiOhm/frontend
flutter run -d windows

---

Option 3: Script Automatisé

# Lancer le backend ET le frontend web ensemble
cd /opt/audiOhm
./START_WEB.sh

---

📦 Builds de Production

Android APK

cd /opt/audiOhm/frontend
flutter build apk --release

# L'APK sera dans: build/app/outputs/flutter-apk/app-release.apk

Installation:

1. Transférer l'APK sur l'appareil
2. Activer "Sources inconnues"
3. Ouvrir l'APK pour installer

Windows EXE

cd /opt/audiOhm/frontend
flutter build windows --release

# L'EXE sera dans: build/windows/runner/Release/audiOhm.exe

Web

cd /opt/audiOhm/frontend
flutter build web --release

# Les fichiers seront dans: build/web/

Déploiement:

# Servir avec un serveur web simple
cd build/web
python3 -m http.server 8080

# Ou avec nginx
cp -r build/web/* /var/www/html/

---

🔧 Configuration API

Développement Local

# Override de l'URL API pour localhost
flutter run -d chrome --dart-define=API_BASE_URL=http://localhost:8000/api/v1

Production

L'URL est configurée dans lib/core/constants/api_constants.dart:

• Par défaut: https://api.audiOhm.com/api/v1
• WebSocket: wss://api.audiOhm.com

---

🎨 Fonctionnalités à Tester

✅ Phase 1 & 2 Corrections

1. Hover States - Survoler les cards (desktop)

   • Border cyan néon au hover
   • Glow néon subtil
   • Transition 200ms

2. Cursor Pointer - Elements cliquables

   • Curseur main sur toutes les cards
   • Feedback immédiat

3. Skeleton Loading - Chargement

   • Shimmer animation pendant le chargement
   • Changez isLoading = true dans mobile_home_page.dart pour tester

4. Gestion d'Erreurs - Messages user-friendly

   • Erreurs affichées avec bouton Retry
   • Messages d'erreur clairs

5. HTTPS - Communications sécurisées

   • Toutes les requêtes API utilisent HTTPS
   • Certificat SSL validé

---

🧪 Tests Manuels

Test 1: Navigation

1. Lancer l'application
2. Naviguer entre Home, Search, Library, Settings
3. Vérifier que les transitions sont fluides

Test 2: Audio

1. Cliquer sur un morceau
2. Vérifier que la lecture démarre
3. Tester play/pause/skip
4. Vérifier que le mini player fonctionne

Test 3: Recherche

1. Aller dans l'onglet Search
2. Taper une requête
3. Vérifier les résultats
4. Cliquer sur un résultat

Test 4: Erreurs

1. Mettre le backend offline
2. Essayer de jouer un morceau
3. Vérifier que l'erreur s'affiche
4. Relancer le backend
5. Tester le bouton Retry

---

🐛 Problèmes Communs

Flutter non trouvé

# Vérifier que Flutter est dans le PATH
which flutter

# Ou utiliser le chemin complet
/opt/flutter/bin/flutter --version

Gradle errors

# Nettoyer gradle
cd frontend
rm -rf build .gradle
flutter clean
flutter pub get

Port 8000 déjà utilisé

# Trouver et tuer le processus
lsof -ti:8000
kill -9 [PID]

# Ou utiliser un autre port
flutter run -d chrome --dart-define=API_BASE_URL=http://localhost:8001/api/v1

---

📚 Documentation

• Guide Complet: STYLE_GUIDE.md
• Référence Rapide: QUICK_REFERENCE.md
• Instructions Build: BUILD_INSTRUCTIONS.md
• Index Docs: DOCS_INDEX.md

---

🎯 Checklist Avant Release

• Tous les tests passent
• Android APK se compile
• Windows EXE se compile
• Web build fonctionne
• Pas d'erreurs console
• Performance acceptable
• [] Accessibilité vérifiée

---

Bonne découverte d'AudiOhm ! 🎵