How to Create a Ride-Sharing Platform in FlutterFlow

Create a rides collection with fields: passengerId (String), driverId (String, null until assigned), status (String: requested, accepted, arrivedAtPickup, inProgress, completed, cancelled), pickupLat (double), pickupLng (double), pickupAddress (String), dropoffLat (double), dropoffLng (double), dropoffAddress (String), fare (double), estimatedMinutes (int), distanceKm (double), requestedAt (Timestamp), completedAt (Timestamp). Create a drivers collection: userId (String), displayName (String), vehicleInfo (String), lat (double), lng (double), geoHash (String, precision 5), isAvailable (Boolean), currentRideId (String, null when free), rating (double).

Create a PassengerHome page. Add two TextFields: pickup location and destination. Use Google Places Autocomplete via a Custom Action to convert addresses to coordinates as the user types. When both locations are set, display a FlutterFlowGoogleMap showing: a green marker at pickup, a red marker at destination, and a route polyline between them using the Google Directions API. Show a fare estimate card at the bottom: calculate distance from the Directions API response, multiply by a per-km rate (for example 1.50), add a base fare (2.00), and display the estimated total. Add a Request Ride button that creates a rides document with status 'requested' and the coordinates.

Write a Cloud Function triggered on rides document creation where status equals 'requested'. Compute the geoHash of the pickup location at precision 4. Query the drivers collection where geoHash starts with this prefix AND isAvailable equals true. From the results, calculate actual distance to each driver using the Haversine formula and pick the closest one. Update the ride document with driverId and status 'accepted'. Update the driver document: set isAvailable to false and currentRideId to the ride ID. If no driver is found, set status to 'noDriverAvailable' so the passenger sees a retry message.

1// Cloud Function: assignNearestDriver
2import * as functions from 'firebase-functions';
3import * as admin from 'firebase-admin';
4admin.initializeApp();
5
6function haversineKm(lat1: number, lng1: number, lat2: number, lng2: number): number {
7  const R = 6371;
8  const dLat = (lat2 - lat1) * Math.PI / 180;
9  const dLng = (lng2 - lng1) * Math.PI / 180;
10  const a = Math.sin(dLat/2)**2 +
11    Math.cos(lat1*Math.PI/180) * Math.cos(lat2*Math.PI/180) *
12    Math.sin(dLng/2)**2;
13  return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1-a));
14}
15
16export const assignNearestDriver = functions.firestore
17  .document('rides/{rideId}')
18  .onCreate(async (snap, context) => {
19    const ride = snap.data();
20    const pickupHash = ride.pickupGeoHash.substring(0, 4);
21    const driversSnap = await admin.firestore()
22      .collection('drivers')
23      .where('isAvailable', '==', true)
24      .where('geoHash', '>=', pickupHash)
25      .where('geoHash', '<', pickupHash + '~')
26      .get();
27
28    if (driversSnap.empty) {
29      return snap.ref.update({ status: 'noDriverAvailable' });
30    }
31
32    let nearest = { id: '', dist: Infinity };
33    driversSnap.forEach(doc => {
34      const d = doc.data();
35      const dist = haversineKm(ride.pickupLat, ride.pickupLng, d.lat, d.lng);
36      if (dist < nearest.dist) nearest = { id: doc.id, dist };
37    });
38
39    await snap.ref.update({ driverId: nearest.id, status: 'accepted' });
40    await admin.firestore().doc(`drivers/${nearest.id}`)
41      .update({ isAvailable: false, currentRideId: context.params.rideId });
42  });

Create a DriverHome page. Add a real-time listener (Single Time Query OFF) on rides where driverId equals current user and status equals 'accepted'. When a ride appears, show a ride request card: passenger name, pickup address, destination, estimated fare, and distance. Add Accept and Decline buttons. Accept navigates to a DriverNavigation page showing the route to pickup on a Google Map. Add status update buttons: Arrived at Pickup (sets status 'arrivedAtPickup'), Start Ride (sets 'inProgress'), and Complete Ride (sets 'completed'). On completion, set the driver's isAvailable back to true and currentRideId to null.

While a ride is in 'accepted' or 'inProgress' status, the driver app updates the driver's lat, lng, and geoHash in Firestore every 5 seconds using a Periodic Action that calls the geolocator Custom Action and writes the coordinates. On the passenger's ride tracking page, add a FlutterFlowGoogleMap with a real-time listener on the driver's location document. The driver marker updates its position on every Firestore change, showing movement in near-real-time. Also show the route polyline and estimated arrival time.

When the driver taps Complete Ride, a Custom Function calculates the final fare. Get the actual distance from the ride route or compute from the GPS trail logged during the ride. Apply the fare formula: baseFare + (distanceKm multiplied by perKmRate) + optional surge multiplier. Update the ride document with the final fare, distanceKm, and completedAt timestamp. Show the passenger a ride summary: map of the route taken, distance, duration, and fare. Add a rating prompt: 5 tappable star icons that update the driver's rating. Create a rating document and recalculate the driver's average rating via Cloud Function.