Arnel-rah/mada-depann

Geolocated mobile app connecting people with local service providers in Madagascar — built with React Native & Expo. # 🚗 Mada Dépann - Madagascar On-Demand Services ## 📋 Table of Contents - Overview - Features - Tech Stack - Project Structure - Prerequisites - Installation - Configuration - Running the App - API Documentation - Database Schema - Contributing - License ## 🎯 Overview **Mada Dépannage** is an on-demand service platform connecting customers with qualified service providers across Madagascar (Antananarivo, Toamasina, Mahajanga, Fianarantsoa, Antsiranana, and other provinces). The platform addresses urgent needs including: - Car/motorbike breakdowns 🚗 - Plumbing emergencies 💧 - Home hairstyling services ✂️ - Courier/delivery services 📦 **Key differentiators:** - 📍 Geolocation-based provider matching - 📡 Offline-first architecture (optimized for unstable connections) - ⭐ Verified profiles with rating system - 💰 Mobile Money integration (MVola, Orange Money) ## ✨ Features ### Customer Features - ✅ Easy registration & login - ✅ Find nearby providers in real-time - ✅ Request services with one tap - ✅ Track provider arrival live - ✅ Rate and review services - ✅ Payment via Mobile Money - ✅ Emergency SOS button ### Provider Features - ✅ Professional profile management - ✅ Accept/reject service requests - ✅ Real-time navigation to customer - ✅ Earnings dashboard - ✅ Service history - ✅ QR code check-in/out ### Admin Features - ✅ User management - ✅ Service validation - ✅ Transaction monitoring - ✅ Analytics dashboard - ✅ Push notifications ### Technical Features - 📱 Offline mode with data synchronization - 🗺️ Real-time GPS tracking - 🔔 Push notifications - 💾 Local caching (AsyncStorage + Redis) - 🔄 Automatic retry on network failure - 🌐 Multi-language support (French, Malagasy)