IMPORTANT: AI Usage Costs

This platform uses AI-powered features (content generation, subject line suggestions, analytics insights) that connect to external AI providers. AI API usage costs are NOT included in the purchase price. You will need to provide your own API keys and manage associated costs separately. Typical costs vary based on usage volume.

RideFlow is a complete, enterprise-grade ride booking and fleet management solution designed for modern transportation businesses. Whether you’re running a taxi company, limousine service, airport transfer business, corporate transportation, or private chauffeur service, RideFlow provides everything you need to manage bookings, drivers, vehicles, and customers—all from one powerful platform.

Built with cutting-edge technologies including React 18, TypeScript, Supabase, and Tailwind CSS, RideFlow delivers exceptional performance, security, and user experience across all devices.

Live Demo

Demo URL: https://rideflow.wrapcoders.com

Admin: admin@demo.com / Admin123!
Driver: driver@demo.com / Driver123!
User: user@demo.com / User123!

Why Choose RideFlow?

Production-Ready

Launch your transportation business immediately with a fully functional, tested, and optimized codebase.

Fully Customizable

Modern component architecture allows easy customization of branding, features, and business logic.

Mobile-First Design

Responsive design optimized for all screen sizes with dedicated mobile experiences for drivers and passengers.

Scalable Architecture

Built on Supabase with PostgreSQL, designed to handle thousands of concurrent users and bookings.

Self-Hosted Option

Deploy on your own infrastructure with complete control over your data and costs.

Comprehensive Documentation

Detailed documentation site included with setup guides, API references, and deployment instructions.

Customer Booking Experience

Intuitive 3-Step Booking Flow

RideFlow features a streamlined booking process that converts visitors into customers:

Step 1: Location & Schedule

Smart Address Autocomplete – Powered by Google Maps Places API with instant suggestions
Interactive Map Preview – Visual route display with distance and duration estimates
Multi-Stop Support – Add up to 3 additional stops along the route
Saved Locations – Logged-in users can save favorite addresses (Home, Work, etc.)
Date & Time Selection – Configurable business hours with 15-minute intervals
Passenger Count – Select number of passengers for vehicle recommendations
Flight Number Tracking – For airport pickups, track flight delays automatically
Child Seat Requests – Request up to 3 child seats per booking
Luggage Count – Specify luggage for vehicle matching
Special Notes – Add custom instructions for the driver

Step 2: Vehicle Selection

Multiple Vehicle Categories – Sedan, SUV, Van, Luxury, and custom categories
Real-Time Pricing – Dynamic fare calculation based on distance, time, and zones
Vehicle Comparison – Side-by-side feature comparison drawer
Favorite Vehicles – Save preferred vehicles for quick selection
Capacity Indicators – Passenger and luggage capacity clearly displayed
Feature Highlights – WiFi, leather seats, climate control, and more
Vehicle Images – High-quality photos for each vehicle type
Smart Recommendations – AI suggests vehicles based on passenger count and luggage

Step 3: Payment & Confirmation

Multiple Payment Methods – Credit/Debit Card, PayPal, Bank Transfer
Promo Code Support – Apply discount codes with real-time validation
Price Breakdown – Transparent display of base fare, distance, extras, and discounts
Billing Details – Optional invoice details with VAT/company support
Deposit System – Configurable deposit percentage (default 30%)
Terms Agreement – Customizable terms and conditions acceptance
Order Summary – Complete booking overview before confirmation
Instant Confirmation – Booking reference generated immediately

Guest Booking Support

RideFlow allows customers to book without creating an account:

No registration required for quick bookings
Email confirmation sent to guest email address
Track booking status using booking reference
Seamless experience without login barriers
Convert guests to registered users post-booking

Recurring Bookings

Perfect for regular commuters and corporate clients:

Frequency Options – Daily, Weekly, Weekdays only, or Custom days
Flexible Duration – Set start and optional end dates
Automatic Generation – Bookings created automatically via scheduled edge function
Easy Management – View, modify, or cancel recurring schedules
Template-Based – Uses original booking as template for consistency

Innovative ride-sharing feature for cost-conscious customers:

Share Invitations – Invite friends/colleagues to share a ride
Cost Split Negotiation – Propose and counter-propose split percentages
Real-Time Calculations – See exact amounts each party pays
Email Notifications – All parties notified of invites and changes
Sharing Achievements – Gamified badges for sharing milestones
Savings Tracker – View total savings from shared rides
Sharing History – Complete history of all shared rides

AI-Powered Features

Intelligent Booking Assistant

RideFlow includes a conversational AI chatbot that helps customers:

Natural Language Booking – Book rides through conversation
Fare Estimates – Get instant price quotes
Vehicle Recommendations – AI suggests best vehicle for needs
Real-Time Streaming – Smooth, character-by-character responses
Context-Aware – Understands current booking details
24/7 Availability – Always ready to assist customers
Multi-Language Support – Responds in user’s preferred language

Smart Fare Suggestions

AI-powered fare optimization:

Analyzes historical booking patterns
Suggests optimal booking times for lower fares
Identifies peak hours and pricing trends
Provides personalized recommendations

Surge Pricing Intelligence

Dynamic pricing with transparency:

Surge Detection – Automatic identification of high-demand periods
Price Forecasting – Hourly price predictions for the day
Optimal Windows – Suggests best times to book
User Alerts – Notifications when prices drop
One-Click Booking – Book directly from surge alert

Real-Time Traffic Integration

Traffic-aware fare and ETA calculations:

Live Traffic Data – Google Maps Distance Matrix integration
Traffic-Adjusted Fares – Pricing reflects actual travel conditions
Congestion Levels – Visual indicators (low, medium, high, severe)
Departure Suggestions – Recommend best departure times
Proactive Alerts – SMS/push notifications if traffic worsens before pickup
ETA Updates – Real-time arrival time recalculations

Driver Portal

Mobile-Optimized Dashboard

Purpose-built for drivers on the go:

720px Optimized Layout – Perfect for smartphone use
Pull-to-Refresh – Native mobile interaction patterns
Availability Toggle – Go online/offline with one tap
Today’s Schedule – View assigned shifts at a glance
Earnings Overview – Daily, weekly, and monthly earnings
Performance Metrics – Rating, completed rides, acceptance rate

Live Tracking Map

Interactive map with real-time features:

Dual View Modes – Toggle between Map and List views
GPS Tracking – Continuous location updates (1-second local, 3-second sync)
Pickup Markers – All assigned pickups displayed on map
Route Visualization – Auto-plotted routes to destinations
Greedy Gesture Handling – Full map interaction without conflicts
Pulsing LIVE Badge – Visual indicator of active tracking
Orientation-Aware Markers – Direction indicators on driver location

Pickup List Management

Efficient pickup organization:

ETA-Sorted List – Pickups ordered by urgency
Color-Coded Badges – Red (≤5min), Amber (≤10min), Blue (≤20min), Gray (>20min)
60-Second Refresh – Automatic updates via Distance Matrix API
Quick Actions – Navigate, call, or start ride with one tap
Customer Details – Name, phone, pickup location, notes

Urgent Pickup FAB

Floating Action Button for critical pickups:

Nearest Pickup Detection – Identifies most urgent confirmed booking
Countdown Timer – Real-time countdown to pickup time
Urgent Styling – Red pulsing animation when ≤15 minutes
Quick Navigation – One-tap access to directions
Ride Start – Begin ride directly from FAB
Smart Disable – Hidden when another ride is in progress

Active Ride Management

Comprehensive ride execution tools:

Start Ride – Begin trip with instant GPS activation
Live Duration Timer – Real-time ride duration tracking
Auto-Route Plotting – Automatic navigation to dropoff
ETA Countdown Overlay – Live arrival time with progress bar
Complete Ride – Finish with earnings preview
Confetti Celebration – Visual feedback on ride completion
Loading States – Isolated per-booking to prevent conflicts

Voice & Proximity Alerts

Hands-free notifications for safe driving:

Voice Announcements – Browser speech synthesis for milestones
Proximity Alerts – 500m (Approaching), 100m (Arriving), 30m (Arrived)
Audio Notifications – Sound alerts with toast messages
Geofencing – Location-based triggers for alerts
Toggle Controls – Enable/disable voice announcements

Navigation Integration

Seamless handoff to navigation apps:

Google Maps – Direct deep linking
Waze – Open in Waze app
Apple Maps – iOS native navigation
App Selector – Choose preferred navigation app
One-Tap Launch – Start navigation instantly

Shift Management

Complete shift scheduling system:

View Assigned Shifts – Today’s and upcoming shifts
Check-In/Check-Out – Record actual working hours
Zone Assignment – See assigned coverage area
Shift Status – Scheduled, Active, Completed states
Time Tracking – View check-in/out timestamps
Notes – Admin notes for special instructions

Earnings & Payouts

Transparent financial tracking:

Earnings Dashboard – Total, monthly, and daily earnings
Ride-by-Ride Breakdown – Individual ride earnings with details
Earning Types – Ride fares, tips, bonuses, adjustments
Payout History – View all completed payouts
Pending Payouts – Track upcoming payments
Payout Methods – Bank transfer support
Period Details – Start/end dates for each payout

Document Portal

Self-service document management:

Document Upload – License, insurance, registration, photos
Status Tracking – Pending, Verified, Rejected states
Expiration Alerts – Notifications before documents expire
Rejection Reasons – Clear feedback on rejected documents
Re-Upload Support – Easy document replacement
Secure Storage – Private bucket with RLS protection

Driver Onboarding

Streamlined application process:

3-Step Wizard – Personal info, License details, Agreement
Progress Tracker – 4-stage visual timeline
Document Requirements – Clear checklist of needed documents
Application Status – Real-time status updates
Re-Application – Apply again if rejected with pre-filled data
Email Notifications – Updates on application progress

Admin Dashboard

Real-Time Statistics

Live business metrics at a glance:

Active Rides Counter – Real-time in-progress bookings
Today’s Bookings – Total bookings for current day
Today’s Revenue – Confirmed/completed booking revenue
Supabase Realtime – Instant updates without refresh
Desktop Header Display – Clean mobile-hidden counters

Booking Management

Complete booking control:

Searchable Table – Find bookings by reference, customer, location
Status Filters – Pending, Confirmed, Completed, Cancelled
Date Range Filters – Filter by pickup date
Booking Details – Full information in slide-out sheet
Driver Assignment – Assign drivers to bookings
Status Updates – Change booking status
Cancel Bookings – Admin cancellation with notes
In-Progress Indicators – Live ride time remaining
Mobile Data Cards – Responsive card layout for small screens

Driver Management

Comprehensive driver administration:

Driver Directory – Searchable list with filters
Add New Drivers – Create driver profiles directly
Edit Driver Details – Update contact info, status, etc.
Performance Dashboard – Rating, rides, earnings analytics
Document Review – Verify/reject uploaded documents
Availability Status – Online/offline tracking
Location Tracking – Last known GPS position
Driver Applications – Dedicated application review page
Approve/Reject Flow – With feedback for rejections

Application Review

Dedicated driver application management:

Application Queue – Pending applications list
Full Application View – All submitted information
Document Verification – Review uploaded documents
Approve with Notes – Accept with optional comments
Reject with Reason – Provide feedback for resubmission
Email Notifications – Automatic notification on decision
Admin Alerts – Notify admins of new applications

Vehicle Fleet Management

Complete vehicle catalog control:

Vehicle Catalog – All vehicles with images and specs
Add/Edit Vehicles – Full CRUD operations
Categories – Sedan, SUV, Van, Luxury, custom
Pricing Configuration – Base price and per-km rates
Capacity Settings – Passengers and luggage limits
Features List – WiFi, leather, climate, etc.
Image Upload – Vehicle photos to storage bucket
Sort Order – Control display order
Active/Inactive – Toggle vehicle availability

Dynamic Pricing Engine

Sophisticated pricing rule management:

Rule Types – Time-based, Distance-based, Zone-based, Vehicle-based
Multipliers – Percentage increases/decreases
Flat Fees – Additional fixed charges
Day-of-Week Rules – Different pricing for weekends
Time Windows – Rush hour pricing
Distance Tiers – Min/max distance conditions
Priority Levels – Rule precedence control
Active Toggle – Enable/disable rules

Zone Management

Geographic pricing zones:

Zone Creation – Define service areas
Zone Multipliers – Premium pricing for zones
Zone Descriptions – Notes and boundaries
Active/Inactive – Enable/disable zones
Route Integration – Link routes to zones

Fixed Routes

Popular route management:

Route Catalog – Pre-defined popular routes
Origin/Destination – Clear endpoint definition
Base Pricing – Fixed price for route
Distance/Duration – Estimated metrics
Zone Linking – Associate with pricing zones
Sort Order – Control display order
Price Calculator Integration – Use routes in fare testing

Promo Code System

Complete discount management:

Code Creation – Custom or auto-generated codes
Discount Types – Percentage-based discounts
Usage Limits – Global and per-user limits
Validity Dates – Start and end date control
Minimum Amount – Minimum booking value required
Usage Tracking – Monitor redemptions
Active Toggle – Enable/disable codes
Descriptions – Marketing text for codes

Shift Scheduling

Driver schedule management:

Weekly Calendar View – Visual shift overview
Create Shifts – Assign drivers to zones and times
Bulk Scheduling – Efficient multi-driver assignment
Shift Templates – Reusable shift patterns
Conflict Detection – Prevent double-booking
AI Recommendations – Smart staffing suggestions
Driver Notifications – Email alerts for new shifts

Customer Management

Customer relationship tools:

Customer Directory – All registered users
Booking History – View customer’s past rides
Profile Details – Contact info and preferences
Admin View – Full access to customer data

Price Calculator

Fare testing and verification tool:

Fixed Route Mode – Select from predefined routes
Custom Address Mode – Enter any pickup/dropoff
Real Distance Calculation – Google Maps integration
Vehicle Selection – Test with any vehicle type
Date/Time Selection – Test time-based rules
Price Breakdown – See all pricing components
Rule Application – View which rules applied

System Settings

Comprehensive configuration:

General Settings

Business name and contact details
Business hours configuration
Default currency setting
Deposit percentage
Pickup time intervals

Appearance Settings

Logo upload (light/dark versions)
Favicon customization
Theme customization
Branding assets storage

Booking Settings

Maximum stops per booking
Maximum child seats
Booking policies
Cancellation rules

Notification Settings

Email templates configuration
SMS settings
Push notification preferences
Reminder timing

Security Settings

Authentication configuration
Session management
Role management

Integration Settings

Google Maps API configuration
Mapbox token management
Payment gateway setup
API quota monitoring
Usage statistics

Settings Audit Log

Track all configuration changes:

Change History – Complete audit trail
User Attribution – Who made each change
Before/After Values – JSONB diff display
Timestamp Tracking – When changes occurred
Filtering – Search by setting key

Payment System

Secure Payment Methods

Credit/Debit Cards – Visa, Mastercard, Amex detection
Luhn Validation – Real-time card number verification
Expiry Validation – Future date enforcement
Card Brand Detection – Automatic icon display
PayPal – Email-based PayPal integration
Bank Transfer – Bank name and account details

Payment Verification

Secure verification workflow:

Test Transactions – Random 1-99 cent charge
Amount Verification – User confirms exact amount
Attempt Limits – Maximum verification attempts
Expiration – Verification timeout handling
Email Notifications – Verification status updates
Status Tracking – Pending, Verified, Expired states

Saved Payment Methods

Multiple Methods – Save multiple cards/accounts
Default Selection – Set preferred payment method
Secure Storage – Encrypted sensitive data
Easy Management – Add, edit, delete methods
Account Settings – Manage in user profile

Billing & Invoicing

Billing Details – Full name, company, address
VAT Support – VAT number for business invoices
Address Prefill – Use pickup location for billing
Profile Saving – Save billing details to profile
Receipt Generation – Downloadable booking receipts

Notification System

Email Notifications

Powered by Resend:

Booking Confirmations – Instant confirmation emails
Status Updates – Driver assigned, ride started, completed
Reminders – 24-hour advance pickup reminders
Cancellation Notices – Booking cancellation alerts
Ride Share Invites – Share invitation emails
Driver Applications – Application status updates
Payment Verification – Verification status emails
Document Expiration – Expiring document alerts

Push Notifications

Web Push API integration:

VAPID Authentication – Secure push delivery
Service Worker – Background notification handling
Booking Updates – Real-time status notifications
Driver Proximity – “Driver arriving” alerts
User Preferences – Customizable notification settings

SMS Notifications

Driver Arriving – SMS when driver is near
Traffic Alerts – Proactive traffic warnings
Customizable – User preference controls

WhatsApp Integration

Evolution API support:

Booking Confirmations – WhatsApp message delivery
Driver Assignment – Notify via WhatsApp
Fallback Mode – Manual send link if API unavailable

In-App Notifications

Notification Bell – Unread count badge
Notification Center – Full notification history
Mark as Read – Individual and bulk actions
Real-Time Updates – Supabase Realtime integration

Notification Preferences

User-controlled settings:

Email booking confirmations
Email ride updates
Email promotions
SMS ride updates
SMS driver arriving
Push notifications toggle

Map Integrations

Dual Provider Support

Google Maps – Full integration with all APIs
Mapbox – Alternative mapping provider
Auto-Detection – Uses available provider
Admin Configuration – Easy API key setup

Google Maps APIs Used

Maps JavaScript API – Interactive map display
Places API – Address autocomplete
Directions API – Route calculation and display
Geocoding API – Address to coordinates
Distance Matrix API – Travel time and distance

API Usage Monitoring

Request Counting – Track API usage per type
Quota Alerts – Warnings at 70%, 80%, 90%
Usage Dashboard – Visual usage statistics
Cost Management – Prevent unexpected bills

Security Features

Authentication

Email/Password – Standard authentication
Auto-Confirm Emails – No email verification required
Password Reset – Secure reset flow
Session Management – Secure session handling

Role-Based Access Control

Admin Role – Full system access
Moderator Role – Limited admin capabilities
User Role – Standard customer access
Driver Access – Driver-specific permissions
Guest Access – Limited booking capabilities

Row Level Security

Database-level protection:

User Data Isolation – Users see only their data
Admin Override – Admins access all data
Driver Policies – Drivers see assigned bookings
Guest Policies – Limited insertion rights
Public Data – Vehicles, zones visible to all

API Key Security

Secure Storage – Keys stored as Supabase secrets
Masked Display – Keys hidden in admin UI
Admin-Only Updates – Role verification for changes
Audit Logging – Track key changes

Internationalization

Multi-Language Support

English – Full translation
Spanish (Español) – Full translation
French (Français) – Full translation
German (Deutsch) – Full translation
Easy Extension – Add new languages easily

Language Features

User Preference – Saved to profile
Automatic Detection – Browser language support
Instant Switching – No page reload required
Complete Coverage – All UI elements translated

Design System

Theme Support

Light Theme – Clean, professional appearance
Dark Theme – Easy on the eyes
System Preference – Follows OS setting
User Preference – Saved to profile
Instant Toggle – Smooth theme switching

UI Components

Shadcn/UI – High-quality component library
Radix UI – Accessible primitives
Tailwind CSS – Utility-first styling
Framer Motion – Smooth animations
Lucide Icons – Consistent iconography

Responsive Design

Mobile-First – Optimized for phones
Tablet Support – Adaptive layouts
Desktop Experience – Full-featured desktop UI
Custom Breakpoints – xs (380px), sm, md, lg, xl

Technical Specifications

Frontend Stack

React 18 – Latest React with hooks
TypeScript – Full type safety
Vite – Lightning-fast build tool
Tailwind CSS – Utility-first CSS
React Router v6 – Client-side routing
TanStack Query – Data fetching and caching
React Hook Form – Form handling
Zod – Schema validation

Backend Stack

Supabase – Backend as a Service
PostgreSQL – Robust relational database
Edge Functions – Serverless Deno functions
Realtime – WebSocket subscriptions
Storage – File uploads and serving
Auth – Authentication and authorization

External Integrations

Google Maps Platform – Maps, Places, Directions
Mapbox – Alternative mapping
Resend – Transactional emails
Evolution API – WhatsApp messaging
Web Push – Browser notifications

PWA Features

Installable – Add to home screen
Offline Support – Service worker caching
App-Like Experience – Full-screen mode
Push Notifications – Background notifications
Fast Loading – Optimized assets

Database Schema

Core Tables

bookings – All ride bookings with status, pricing, driver assignment
profiles – User profiles with preferences and billing info
drivers – Driver profiles, documents, earnings, location
vehicles – Vehicle catalog with pricing and features
user_roles – Role assignments for access control

Pricing Tables

pricing_rules – Dynamic pricing rules
zones – Geographic pricing zones
routes – Fixed popular routes
promo_codes – Discount codes
promo_code_uses – Redemption tracking

Driver Tables

driver_documents – Uploaded documents
driver_earnings – Earnings records
driver_payouts – Payout history
driver_ratings – Customer ratings
driver_shifts – Scheduled shifts

Feature Tables

recurring_bookings – Recurring ride templates
ride_shares – Ride sharing records
saved_locations – User saved addresses
favorite_vehicles – User vehicle preferences
payment_methods – Saved payment methods

System Tables

notifications – User notifications
notification_preferences – User notification settings
push_subscriptions – Web push subscriptions
system_settings – Application configuration
settings_audit_log – Configuration change history
map_api_usage – API usage tracking

Edge Functions

ai-booking-chat – AI chatbot conversations
analyze-surge-pricing – Surge price detection
auto-dispatch – Automatic driver assignment
calculate-eta – ETA calculations
check-api-usage-alerts – Quota monitoring
check-expiring-documents – Document expiration alerts
check-expiring-verifications – Verification expiry checks
check-traffic-alerts – Proactive traffic monitoring
generate-recurring-bookings – Recurring booking creation
get-maps-config – Map API configuration
get-traffic-data – Traffic data fetching
notify-admin-driver-application – Admin application alerts
notify-driver-shifts – Driver shift notifications
notify-new-shift – New shift alerts
notify-ride-completing – Ride completion alerts
predict-driver-deployment – AI staffing recommendations
predict-traffic – Traffic predictions
send-booking-email – Email notifications
send-booking-reminders – Reminder emails
send-document-notification – Document status emails
send-push-notification – Push notification delivery
send-sms – SMS messaging
send-verification-email – Payment verification emails
send-whatsapp-message – WhatsApp messaging
setup-demo-users – Demo account provisioning
smart-fare-suggestions – AI fare recommendations
update-map-secret – Secure API key updates

What’s Included

Complete React source code
All Supabase Edge Functions
Database migrations and schema
Comprehensive documentation site
Demo data setup scripts
Docker deployment configuration
Self-hosting guides (Vercel, Netlify, Docker)
Multi-language translation files
PWA configuration and service worker
Email templates

Requirements

Node.js 20+ or Bun
Supabase account (free tier works for development)
Google Maps API key (optional, for maps)
Resend API key (optional, for emails)

Support & Updates

6 months of support included
Regular updates with new features
Bug fixes and security patches
Detailed documentation

License

Regular License: Use in a single end product which end users are not charged for.

Extended License: Use in a single end product which end users can be charged for.

Changelogs: Version_1.2.0

● New Features
• Stripe Webhook Integration: Real-time payment status updates via stripe-webhook edge function
• PayPal IPN Handler: Instant Payment Notifications with verification handshake
• Coinbase Commerce: Cryptocurrency payments supporting Bitcoin, Ethereum, USDC, Litecoin, and Dogecoin
• Unified Payment Processor: New process-payment edge function handling all payment methods
• Refund Processing: Admin-initiated refunds with process-refund edge function
• Payment Status Tracker: Real-time payment lifecycle visualization on booking confirmation

● Improvements
• Enhanced payment gateway configuration in Admin Settings → Integrations
• Enhanced payment gateway configuration in Admin Settings → Integrations
• Test/Live mode toggle with visual indicators for all payment gateways
• Webhook URL display with copy-to-clipboard functionality
• Automated booking status updates triggered by payment webhooks
• In-app notifications for payment confirmations and failures        

● Documentation
• Added Payment Webhooks section with setup guides for all gateways
• Documented webhook event mappings and security configurations
• Added changelog section for version tracking

RideFlow - The Ultimate Ride Booking & Fleet Management SaaS Platform