Documentation

1. We deploy the platform to your server within 3–7 days after purchase

2. Configure your PostgreSQL database and environment variables

3. Set up Firebase Realtime Database for live tracking

4. Configure Google Maps API keys for all apps

5. Build and publish mobile apps to App Store & Google Play

• Node.js 18+ (Next.js 16 for Admin & Website)

• PostgreSQL 14+ database

• Firebase project (Realtime Database + Cloud Messaging)

• Google Maps API key (Maps, Places, Directions, Geocoding)

• Expo SDK 54 (React Native mobile apps)

• Apple Developer Account (iOS) + Google Play Console (Android)

• VPS or cloud server with 2GB+ RAM (Ubuntu recommended)

• SSL certificate for API and web endpoints

• Customer posts ride request with pickup, destination, passengers, and preferred vehicle type

• Nearby drivers receive notification and submit bids (price + vehicle + rating)

• Customer compares bids and selects the best driver

• Ride begins with live GPS tracking via Firebase Realtime Database

• Payment collected, commission auto-deducted, driver receives net payout

• Driver publishes a route with departure time, available seats, and price per seat

• Riders search routes by origin/destination and date

• Riders book available seats; driver approves or auto-accepts

• Multiple riders share the ride and split costs

• Platform earns commission on each seat booking

• Admin or operators create travel packages (destination, duration, itinerary)

• Packages include vehicle, driver, and optional tour guide

• Customers browse, compare, and book packages

• Supports group bookings with passenger management

• Multi-day itineraries with day-wise scheduling

• Customers create parcel delivery requests with pickup and drop-off

• Select vehicle type based on package size

• Real-time tracking of delivery progress

• Proof of delivery with digital confirmation

• Same commission model as ride bookings

• Real-time ride monitoring with live map view

• Revenue analytics with daily/weekly/monthly breakdowns

• Driver bid management and marketplace activity

• Carpool route and travel package oversight

• Commission tracking and payout management

• Customer registration, verification, and account management

• Driver onboarding with document verification (license, insurance, RC)

• Fleet owner management with vehicle assignments

• Role-based access control with admin permissions

• Driver badge and reputation system management

• Commission rate configuration (default 15%, customizable per vehicle type)

• Vehicle type management (Auto, Sedan, SUV, Premium, Bus, etc. — 10 types)

• Zone-based pricing and surge pricing rules

• Promo code and discount campaign management

• Multi-currency and multi-language settings

1. Customer sets pickup and destination with Google Places autocomplete

2. Selects vehicle type and number of passengers

3. Posts ride request to the marketplace

4. Receives bids from nearby drivers with price, vehicle, and rating

5. Compares and selects preferred driver

6. Tracks ride live on map until completion

7. Pays via cash, card, or in-app wallet

• Carpool search — find shared rides by route and date

• Travel package browsing — discover guided tours

• Package delivery — send parcels with real-time tracking

• Ride scheduling — book rides in advance

• Ride history and digital receipts

• Rate and review drivers after each trip

• SOS emergency button and ride sharing with contacts

• Referral rewards system

• Browse nearby ride requests with fare and distance info

• Submit competitive bids with custom pricing

• Accept/decline rides with one tap

• Built-in GPS navigation to pickup and destinations

• Online/offline toggle to control availability

• Trip cancellation with reason tracking

• Real-time earnings dashboard (daily/weekly/monthly)

• Trip-wise earning breakdown with commission deductions

• Badge system — Bronze, Silver, Gold, Platinum based on performance

• Customer ratings and review history

• Carpool route publishing for additional income

• Tour driving assignments for premium earnings

• Add unlimited vehicles with registration details and documents

• Assign and reassign drivers to vehicles

• Track all fleet vehicles on a live map

• Vehicle maintenance scheduling with reminders

• Insurance and permit document expiry tracking

• Revenue analytics across entire fleet

• Vehicle-wise earning comparison

• Custom commission rates per driver or vehicle

• Driver payout calculations and history

• Exportable reports (PDF, CSV)

• Next.js 16 API routes (Admin Dashboard backend)

• PostgreSQL 14+ primary database (40+ tables)

• Firebase Realtime Database (live location tracking, ride state)

• Firebase Cloud Messaging (push notifications)

• RESTful API architecture with JWT authentication

• Prisma ORM for website database, raw pg for taxi operations

• Admin Dashboard: Next.js 16, React 19, MUI v5, Redux Toolkit

• Customer App: React Native, Expo SDK 54, Expo Router

• Driver App: React Native, Expo SDK 54, Expo Router

• Owner App: React Native, Expo SDK 54, Expo Router

• Sales Website: Next.js 16, Tailwind CSS, Prisma ORM

• Maps: react-native-maps (mobile), Google Maps API (web)

• State: AsyncStorage for session persistence, Context API for shared state

• Google Maps Platform (Maps, Places, Directions, Geocoding)

• Firebase (Realtime Database, Cloud Messaging, Auth)

• Stripe & Razorpay payment gateways (website sales)

• Resend / SendGrid email providers

• Tawk.to live chat

• Google Analytics GA4 & Facebook Pixel

• JWT Bearer tokens for all authenticated endpoints

• OTP-based login for mobile apps (SMS verification)

• Session persistence via AsyncStorage (mobile) and cookies (web)

• Rate limiting: configurable per endpoint

• POST /api/rides/request — Create ride request

• POST /api/rides/bid — Submit driver bid

• GET /api/rides/bids/:rideId — List bids for a ride

• POST /api/rides/accept-bid — Accept a driver bid

• POST /api/carpools/publish — Publish carpool route

• GET /api/carpools/search — Search carpool routes

• GET /api/packages/list — Browse travel packages

• POST /api/packages/book — Book a travel package

• GET /api/drivers/earnings — Driver earnings summary

• GET /api/admin/analytics — Platform analytics