Taxi Connect - Ride Hailing App, API & Admin

Taxi Connect is a complete ride-hailing starter kit: a Flutter mobile app for riders and drivers, a NestJS + MongoDB API with real-time Socket.io, and a React admin dashboard. It is designed for local taxi markets (small and shared taxis) and is easy to adapt to any city or vehicle type.

Riders see nearby taxis moving live on a Mapbox map, request a ride, follow the driver and rate the trip. Drivers upload their documents and vehicle, wait for approval, go online and accept rides. Admins manage everything from the web dashboard: riders, drivers, vehicles, rides, document validation, withdrawals, SOS alerts, promo codes and sub-admins with granular permissions.

Full English documentation is included in the main ZIP: installation, configuration, basic usage, a mobile rebranding guide (app name, IDs, colors, icons, native and in-app splash screen, animations), a mobile release guide (Android keystore and signing, App Bundle/APK, iOS signing and App Store upload, Firebase), and a production deployment guide (Docker, HTTPS, backups, security checklist). The package also contains the full readable source code (no obfuscation), an API reference, a Postman collection, a test APK and a brand kit.

Please read documentation/FEATURES.md: it lists honestly what is production-ready and what still needs work (push notifications setup, card payment screens, scheduled rides, password reset).

Features

Rider and driver flows in one Flutter app (iOS and Android) Live map with moving nearby taxis (Mapbox, Socket.io) Ride request, offers, status updates, cancellation, history, ratings Driver onboarding: documents upload, vehicle, admin approval Wallet, withdrawal requests and promo codes SOS alerts and incident reports JWT auth, refresh tokens, roles and granular sub-admin permissions React admin dashboard: riders, drivers, vehicles, rides, documents, withdrawals, SOS, promos, sub-admins Android release signing ready (key.properties) and branded native splash screens Docker Compose deployment, API documentation and Postman collection Full English documentation: install, configure, rebrand, release, deploy Brand kit: logos, app icons, map icons, Lottie onboarding animations

Requirements

Node.js 20+ and npm Flutter 3.35+ (Dart 3.9+) with Xcode and/or Android Studio MongoDB 6+ (local or Atlas), Redis optional in development A Mapbox access token (free tier is enough to start) Optional: Stripe, Firebase, Twilio, SendGrid, AWS S3 accounts Docker and Docker Compose v2, a Linux server and a domain for production Apple Developer and Google Play accounts to publish the mobile app

Instructions

Unzip the package and read README.md, then documentation/README.md (reading order) Run locally with documentation/INSTALLATION.md (backend, dashboard, mobile app) Set variables and third-party keys with documentation/CONFIGURATION.md Learn the roles and a full ride with documentation/USAGE.md Rename and rebrand the app (ids, icon, splash screen) with documentation/MOBILE_BRANDING.md Build, sign and publish the apps with documentation/MOBILE_RELEASE.md Deploy to a server with Docker and HTTPS with documentation/DEPLOYMENT.md Optional: install demo-apk/taxi-connect-demo.apk to try the app against the live demo