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.
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.
Dual-Mode Ride-Hailing & Real-Time GPS Telemetry Architecture
Unified mobility architecture powering both Passenger booking and Driver dispatch modes within a single Flutter codebase with background location telemetry and surge pricing.
Dual-Mode Flutter Mobile Client
Dynamic passenger booking UI and driver dispatch dashboard toggled via cryptographic role claims without requiring two separate application downloads.
Deterministic Trip Lifecycle State Engine
Strict lifecycle orchestration (Requested → Matched → DriverArrived → InTransit → Completed) preventing race conditions between passenger and driver.
Background GPS & Kalman Filter Smoothing
Suppresses GPS sensor jitter and smoothly interpolates driver vehicle markers on interactive customer maps while reducing battery consumption by 50%.
Dynamic Surge Dispatch & Stripe Checkout
Geospatial radius broadcasting matching nearby drivers within seconds, calculating tiered fare structures and processing automated payment captures.
- 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
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.
Featured Case Studies
Explore More Production Architectures
WA Commerce Agent
AI-powered WhatsApp commerce system for small businesses worldwide.
Wasey — Food Multi-Vendor Delivery Platform
Customer, courier, and vendor apps with live GPS tracking and automated dispatch.
Need a similar architecture shipped?
Let's translate your product workflows, real-time requirements, and cloud infrastructure into a dependable production app.