TrustRide is a full-stack web platform built for intercity travel in Nigeria. Drivers post trips with seat maps, riders book and pay via bank transfer, and admins verify everything through a structured dashboard. The platform supports riders, drivers, ambassadors, and admin operators — each with their own dedicated interface.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Muhammadbugaje/trustride/llms.txt
Use this file to discover all available pages before exploring further.
Introduction
Understand what TrustRide is, who it’s for, and how the platform is structured.
Quickstart
Get TrustRide running locally in minutes — clone, configure, and launch.
Architecture
Explore the Django app structure, WebSocket layer, Celery tasks, and data models.
Rides & Trips
Learn how drivers create trips, manage vehicles, and publish seat availability.
Platform Highlights
Seat Selection
Visual seat maps with 30-minute reservation timers hold seats during checkout.
Payment Verification
Riders upload bank transfer receipts; drivers confirm payment via in-app chat.
Ambassador Program
Verified ambassadors book seats on behalf of others and earn commissions per trip.
Real-Time Notifications
Django Channels and Redis power live booking alerts, chat, and status updates.
GPS Tracking
Active trips stream GPS coordinates with automatic route deviation alerts.
Admin Dashboard
Manage users, verify drivers, process payouts, and export revenue reports.
Getting Started
Clone and install dependencies
Clone the repository and install Python dependencies using pip into a virtual environment.
Configure environment variables
Copy
.env.example to .env and fill in your database, Redis, and email settings.Run migrations and seed data
Apply Django migrations and optionally run
populate_sample_data.py for test data.TrustRide is designed for the Nigerian market. The payment flow uses manual bank transfer verification rather than a payment gateway, which suits environments where card infrastructure is limited.