Openfront Rideshare
Self-hosted ride booking and fleet operations for independent drivers and fleets, with dispatch, trip lifecycle, safety, support, and payments.
Openfront Rideshare is a self-hostable ride-booking and fleet-operations application. Riders browse a fleet's ride services, get a priced quote, request a ride, and follow the trip on a status page. Fleet operators set up service areas, ride services, and fare versions; onboard drivers and vehicles with compliance documents and eligibility reviews; dispatch requests to drivers by hand; move trips through their lifecycle; and handle cancellations, messages, reviews, support cases, safety incidents, and payments and refunds.
Operators choose the driver and vehicle for each request. Route distance and duration are estimated from the pickup and drop-off. Riders can pay by card through Stripe Checkout, or the fleet records payment on the trip.
Who it is for
- Fleet owners and dispatchers who run a small fleet or a group of independent drivers and want their own booking site and operations dashboard.
- Drivers who use the "My driving" workspace to go online, accept or decline offers, and advance their assigned trips.
- Riders who book as guests or with an account when the fleet opens rider accounts.
What the codebase contains
- Schema: 38 Keystone lists in
features/keystone/models/**, grouped into identity (fleets, memberships, drivers, riders), operations (vehicles, compliance documents, policies, provider connections), service (areas, ride services, availability, fare rules, quotes), ride (requests, offers, trips, events, location events, cancellations), safety (incidents, support cases, conversations, messages, reviews), finance (payment providers, payments, refunds, observations, ledger entries, payouts), and integration records (notifications, marketplace registration). - Custom GraphQL: named queries and mutations in
features/keystone/mutations/**for quoting, requesting, dispatching, trip transitions, cancellations, payments, fleet setup, and onboarding. Generic create and delete are closed on tenant lists, so records are created through these commands. - Operator surfaces:
features/platform/**mounted at/dashboard/platform/*for dispatch, my driving, trips, services and fares, drivers, vehicles, safety and support, reviews, finance, team, and settings. The shared Keystone admin shell lives infeatures/dashboard. - Storefront:
features/storefront/**serving/,/book,/rides/[confirmationCode], and rider account pages under/account. - Onboarding: a dashboard onboarding dialog that calls
bootstrapRidesharewith aminimalorfullstarter template, plus a custom setup path built from the fleet setup mutations.
Ownership and tenancy
Fleet is the tenant boundary. Almost every list is scoped to the fleets where the signed-in user has an active FleetMembership whose role grants the needed capability:
| Capability | Membership roles |
|---|---|
| operations | owner, dispatcher |
| drivers | owner, dispatcher |
| finance | owner, finance |
| safety | owner, support |
| fleetAdmin | owner |
A viewer membership grants none of these capabilities. A global admin role (canManageRoles) sees every fleet. Tenant relationships such as fleet, driver, vehicle, and trip are immutable after creation, and dispatch-gating status fields (driver status, driver dispatch status, vehicle status) change only through review and dispatch mutations.
Riders are User records, optionally with a RiderProfile. Account riders own requests through RideRequest.rider. Guests hold a signed request proof in the browser; private trip data is reached with that proof or a trip token, never with a confirmation code alone.
Getting started
Requirements, environment, migrations, and onboarding.
Dispatch
Offer requests to eligible drivers and vehicles.
Trips
Lifecycle, cancellation, payments, messages.
Services and fares
Areas, ride services, and fare rule versions.
Drivers and vehicles
Onboarding, documents, eligibility, and availability.
Payment providers
Stripe Checkout and manual payments.
Rider storefront
Book, track, pay, and review a ride.
How-to guides
Task walkthroughs for fleets and dispatchers.
API reference
Named GraphQL operations.
The application uses Next.js 16, React 19, Keystone 6, GraphQL, Prisma, and PostgreSQL.