eodenyire/taveta-rides

African Camel – Taveta Rides Your ride, anywhere in Taveta Features • Tech Stack • Getting Started • App Journeys • Screenshots • Database Schema • Contributing --- ## 🌍 About **African Camel** is a full-stack, multi-role ride-hailing super-app tailored for **Taveta, Kenya** and the surrounding region. It serves three user roles: | Role | What they do | |------|-------------| | **Customer (Rider)** | Book rides, track in real-time, pay via M-Pesa, rate drivers | | **Driver** | Accept ride requests, track earnings, onboard vehicles, rate customers | | **Administrator** | Manage users, review drivers, set promo codes, view revenue & commissions | The platform supports a wide range of transport modes: **Boda Boda (motorcycle)**, **Tuk-tuk**, **Horse/Donkey Cart**, **Economy/Comfort/Premium Car**, **Matatu**, **Shuttle**, and **Truck (parcels)**. It is localised in **English and Swahili**. --- ## ✨ Features ### Customer Features - 🔐 Email/Password + Google OAuth authentication - 📍 Google Maps / Leaflet location picker with coordinate capture - 🚀 Instant ride booking with vehicle type selection (9 types) - 💰 Dynamic fare estimation with real-time breakdown (base + per-km + surge) - 🏷️ Promo code support with validation and discount application - 📅 Scheduled rides (one-time, daily, weekdays, weekly recurrence) - ❤️ Favourite routes with one-tap re-use - 📱 M-Pesa STK Push payment (Daraja API integration) - 💳 In-app wallet with top-up via M-Pesa Paybill - 🗂️ Full ride history with status tracking - ⭐ Driver rating & feedback system - 💬 Real-time in-trip chat with driver - 🌐 Swahili / English language toggle - 🔔 Real-time ride status updates via Supabase Realtime ### Driver Features - 🚗 Vehicle registration (make, model, year, plate number, licence upload) - ✅ Profile review & approval workflow (pending → approved / rejected) - 📋 Available ride request queue with accept / cancel controls - 🗺️ Live map showing active ride pickup and destination - 🛣️ O …