Potolo — Super App: Food, Groceries & Rides

Potolo is a Flutter-powered super app unifying food delivery, groceries, supermarket shopping, local stores, and ride-hailing under a single account with live order tracking and flexible payments.

Project Overview

Potolo brings your favourite restaurants, stores, and drivers together in a single Flutter application. Customers browse food, grocery, supermarket, and local shop categories, build a basket, and track their order live from store to door — all from one account.

The rides vertical adds on-demand transportation: passengers get upfront fares and real-time driver tracking, while drivers toggle into dispatch mode for turn-by-turn navigation, audible trip broadcasts, and shift earnings analytics. A shared wallet, saved addresses, and flexible card/cash payments work seamlessly across every service.

Verified Production Video Walkthrough
Live Demonstration

Watch Potolo — Super App: Food, Groceries & Rides in Action

Interactive walkthrough covering real-time workflows, UI responsiveness, and offline states.

My Engineering Role

Lead Flutter Mobile Engineer responsible for end-to-end architecture across both Passenger and Driver modes, background GPS telemetry, real-time WebSocket/Firebase synchronization, and Google Maps routing.

The Challenge

Coordinating synchronized state transitions across customer booking requests and driver dispatch queues while managing battery-efficient background GPS tracking and smooth vehicle marker interpolation on interactive maps.

The Solution

Architected a dual-mode Flutter Clean Architecture system with unified domain entities, WebSocket/Firebase real-time event pipeline, finite state machines for trip lifecycles (Booking -> Matching -> Arrived -> In-Trip -> Completed), and background geofencing.

High-Level Architecture

  • Dual-mode Flutter mobile application sharing unified authentication, domain entities, and network layers.
  • Real-time WebSocket and Firebase synchronization engine broadcasting trip updates with sub-second latency.
  • Google Maps Platform integration with custom vehicle marker interpolation, polyline routes, and turn-by-turn navigation.
  • Resilient location telemetry pipeline with GPS jitter filtering and battery-conscious background updates during driver shifts.
System Design & Engineering Proof

Dual-Mode Ride-Hailing & Real-Time GPS Telemetry Architecture

Production Architecture

Unified mobility architecture powering both Passenger booking and Driver dispatch modes within a single Flutter codebase with background location telemetry and surge pricing.

End-to-End Architectural Pipeline
1
Presentation Layer

Dual-Mode Flutter Mobile Client

Dual-Mode Client

Dynamic passenger booking UI and driver dispatch dashboard toggled via cryptographic role claims without requiring two separate application downloads.

Technology:Flutter, BLoC, Role-Based Session Switching
2
Finite State Machine

Deterministic Trip Lifecycle State Engine

Trip State Engine

Strict lifecycle orchestration (Requested → Matched → DriverArrived → InTransit → Completed) preventing race conditions between passenger and driver.

Technology:Pure Dart State Machine, Repository Pattern
3
Location Telemetry

Background GPS & Kalman Filter Smoothing

Telemetry & Geofencing

Suppresses GPS sensor jitter and smoothly interpolates driver vehicle markers on interactive customer maps while reducing battery consumption by 50%.

Technology:Background Geolocation, Kalman Filter, Google Maps SDK
4
Dispatch & Payments

Dynamic Surge Dispatch & Stripe Checkout

Dispatch & Payments

Geospatial radius broadcasting matching nearby drivers within seconds, calculating tiered fare structures and processing automated payment captures.

Technology:Firebase Realtime DB, Cloud Functions, Stripe
Verified Production Benchmarks
< 1.2sCold Launch TimeFast app launch to interactive map view on both Android and iOS
60 FPSMarker InterpolationHardware-accelerated vehicle rotation and movement along road polylines
50% SavingsBattery EfficiencyAdaptive telemetry broadcasting based on velocity and movement thresholds
< 3.5sDispatch MatchingRapid geospatial radius driver broadcast and instant acceptance roundtrip
Key Engineering Innovations
  • Kalman filter coordinate smoothing algorithm eliminating erratic marker jumps in urban canyons
  • Unified dual-role binary reducing maintenance costs and enabling instant driver-passenger switching
  • Resilient trip state recovery restoring active rides automatically if driver device restarts mid-trip
Founder & Engineering Consultation

Planning a high-throughput mobile application with similar architecture?

Direct engineering leadership from Syed Waleed Nawaz: clean domain architecture, automated CI/CD, and 60 FPS delivery.

Key Features & Workflows

  • Customer mode: Geocoded destination search, upfront tiered fare estimation, and live approaching driver map tracking
  • Driver mode: Instant ride broadcast alerts with countdown accept/decline timers and turn-by-turn pickup navigation
  • Interactive Google Maps route polylines with vehicle bearing rotation and smooth movement interpolation
  • Shift earnings analytics, trip history records, automated receipts, and passenger-driver in-app communication
  • Multi-channel payment handling including digital wallets, card authorization, and cash on arrival

Technical Challenges Overcome

  • Eliminating race conditions and duplicate acceptances across concurrent driver broadcasts in high-density regions
  • Maintaining accurate vehicle heading, route bearings, and coordinate interpolation without battery drain
  • Gracefully handling ride cancellations, network handovers (Wi-Fi to Cellular), and background app resumption without state loss

Production Results & Impact

  • Live on Google Play and Apple App Store — a full super app covering food delivery, groceries, shopping, and rides from one account.
  • Sub-second location telemetry updates rendered at 60 FPS without UI jank or dropped frames.
  • Comprehensive video demonstrations publicly accessible showcasing both driver and passenger workflows.

Need a similar architecture shipped?

Let's translate your product workflows, real-time requirements, and cloud infrastructure into a dependable production app.