Manzil Delivery Platform

Key results

• 4 apps — Admin · merchant · driver · fleet company
• 1 stack — API + PostGIS + Socket.io shared across surfaces
• EN + AR — Full bilingual UX with RTL across web portals
• Live ops — Dispatch offers, live map, chat, wallet deductions

TL;DR

• Built an end-to-end Kuwait delivery platform that replaces fragmented WhatsApp, spreadsheet, and third-party courier workflows.
• Merchants create orders with Kuwait-style addresses and cash signals, fund a prepaid wallet, and chat with ops or drivers.
• Admins run a command center: kanban orders, auto-dispatch with manual escalation, live PostGIS map, vendors, fleet companies, invoices, and reports.
• Drivers go online, receive timed offers, navigate with Google Maps, verify pickup, collect cash when required, and finish with proof-of-delivery photos.
• Delivery companies get their own portal for fleet map, driver management, and payout visibility—screenshots below show all four apps.

Project Overview

A logistics front end that connects restaurants, platform ops, riders, and external fleets in one Kuwait-native product.

Kuwait restaurants needed more than a dispatch phone number. They needed structured order intake, prepaid delivery billing, branch-aware operations, and visibility into who is picking up and when. Platform operators needed a live map and assignment board that works when auto-dispatch fails. Drivers needed a shift tool that opens native directions and unlocks customer details only after verified pickup. Fleet partners needed a portal that is not the admin console.

Manzil ships that system as four coordinated products on one Node / Prisma / PostGIS backend. Screenshots above are from those admin, merchant, driver, and company surfaces.

• Admin command center — live map, order kanban, drivers, vendors, fleets, invoices, chat, reports
• Merchant portal — create orders, wallet top-up (MyFatoorah), team roles, support chat, pickup codes
• Driver app — web + React Native: online status, offers, directions, verification, cash, POD
• Company portal — fleet live map, driver CRUD, payout windows, support

Business Challenge / Problem Statement

Restaurants and fleets in Kuwait were operating delivery without a shared system of record.

Orders lived in aggregator apps, calls, and chats with inconsistent addresses and no clear cash signal for riders.

Ops could not see free vs busy drivers on a live map, or escalate when no rider accepted an offer.

Merchants needed verification before releasing bags; drivers needed customer details only after pickup.

Delivery fees needed prepaid wallet deduction in KWD, with room for per-merchant pricing and periodic invoicing—and both platform drivers and external fleets needed first-class tools.

• Fragmented intake — Addresses and cash signals were inconsistent across chats, calls, and aggregators.
• Blind dispatch — No shared live map or clean escalation when auto-assign failed.
• Trust at pickup — Verification and privacy gates were missing between merchant, rider, and customer.
• Money + dual workforce — KWD wallet ops and fleet partners needed first-class product surfaces.

Objectives & Goals

Ship a Kuwait-ready delivery OS merchants and fleets actually operate in.

Give merchants a portal to place orders, fund wallets, and track riders in real time.

Give admins a command center with live map, auto-dispatch, and manual assign.

Give drivers a mobile-first shift flow from online → offer → pickup verify → cash → POD.

Give fleet companies a scoped portal for their riders and payouts.

Localize for Kuwait: Area/Block addresses, KWD, MyFatoorah, EN/AR RTL—on one Socket.io + PostGIS backbone.

• Merchant portal — Structured Kuwait orders, wallet billing, and live rider visibility.
• Admin command center — Live map, kanban, auto-dispatch, and manual recovery.
• Driver shift flow — Offers, directions, verification, cash collection, and POD.
• Fleet company portal — Scoped map, drivers, and payout windows for partners.
• Kuwait localization — Area/Block addresses, KWD, MyFatoorah, full EN/AR RTL.
• One realtime backbone — Socket.io rooms + PostGIS so every surface stays in sync.

Key Features & Product System

Four apps, one Kuwait delivery network.

Admin command center

Live map with bike/car markers, restaurant pins, and customer destinations; order kanban with cash badges and assign/reassign; auto-dispatch offers with timeout and admin alerts; vendors, fleet companies, onboarding, invoices, reports, and multi-thread chat—plus EN/AR and dark mode.

Merchant portal

• Orders: Area / Block / Street / Building intake with cash amount type and map pin.
• Wallet: MyFatoorah top-up and fee deductions in KWD.
• Team & verify: Owner / manager / employee roles and pickup code / barcode at the restaurant.

Driver app (web + native)

• Online: Availability toggles dispatch eligibility.
• Offer → navigate: Timed accept/reject, then native Google Maps directions.
• Verify → POD: Pickup code/scan unlocks customer details; cash + proof-of-delivery photo to complete.

Fleet company portal

Fleet dashboard KPIs, payout windows (today / 7 / 15 / 30 days), live map of company drivers, driver CRUD, earnings panels, and support chat with platform admin—without sharing the admin console.

Results & Impact

Replaced ad-hoc courier coordination with a single realtime operations stack for merchants, admins, drivers, and fleet partners.

Merchants gained structured Kuwait addresses, cash signaling, wallet billing, and pickup verification instead of informal handoffs.

Ops gained live PostGIS tracking, offer-based dispatch, and a kanban that surfaces failed auto-assign for manual recovery.

Drivers gained a guided shift UI with external navigation, verification gates, and cash/POD completion. Fleet companies gained a dedicated portal instead of sharing admin credentials.

Technologies & Tools Used

One backend, four product surfaces

Admin, merchant, company, and driver web apps share a React / Vite front end with Socket.io, Google Maps, and EN/AR i18n. Drivers also ship in React Native with maps and push paths.

The API is Node.js, Express, Prisma, and PostgreSQL with PostGIS. Realtime rooms keep admin, vendor, driver, company, and order clients in sync. Wallet top-ups run through MyFatoorah webhooks with per-merchant fee and invoice rules.

Technology stack

• Admin command center — Live map, kanban dispatch, vendors, fleets, invoices, chat, and reports.
• Merchant portal — Order intake, wallet, team roles, pickup verification, and support chat.
• Driver app — Web + React Native shift flow from online status through POD.
• Fleet company portal — Scoped map, driver management, and payout windows for partners.
• PostGIS live map — Spatial tracking for drivers, restaurants, and destinations.
• Socket.io dispatch — Realtime rooms for offers, presence, chat, and map updates.
• KWD wallet — Prepaid merchant balances with fee deductions and ledgers.
• MyFatoorah — Wallet top-up payments with webhook confirmation.
• EN/AR RTL — Bilingual interfaces across the web portals.
• Pickup verification — Code and barcode gates before customer details unlock.
• Proof of delivery — Photo completion step on the driver active-order flow.