HerPro Marketplace Platform
The backend for a Nigerian marketplace and food-delivery app: customers, vendors and riders, Paystack payments, KYC, wallets and push notifications. Node and TypeScript on MongoDB.
HerPro is a marketplace app for food delivery and product commerce. Customers shop, restaurant and product vendors manage their businesses, and riders handle deliveries — all on one platform.
I worked on the backend with a small team, responsible for the order pipeline, payments, real-time tracking, and the operational tooling that keeps things running in production.
The API serves four distinct user types, each with their own auth flows, dashboards, and workflows:
- Customers — browsing, cart, checkout, order tracking, reviews
- Restaurant vendors — menus, operating hours, order acceptance
- Product vendors — inventory, variants, fulfillment
- Riders — dispatch, live location, earnings
A single order can touch all four roles, so most of the backend complexity is in keeping everything consistent as an order moves from cart to delivery to settlement.
Orders are paid through an external payment provider. When a transaction is confirmed, the platform automatically splits the payout between the vendor, the rider, and the platform. Refunds, failed transactions, and edge cases are all handled through a ledger system that keeps a reliable history of every money movement.
Riders broadcast their location over WebSockets. Customers see live delivery tracking. Vendors get instant notifications when orders come in. The system handles reconnections and dropped connections gracefully so no one loses their active session.
The part of the codebase I'm proudest of is the operational tooling — scheduled cleanup jobs, order recovery scripts, refund automation, and diagnostic tools that catch inconsistencies before users notice them. None of it is glamorous, but it's what keeps a live platform trustworthy.
- TypeScript + Node.js + Express
- MongoDB + Mongoose
- Socket.IO for real-time updates
- Kafka for event-driven transaction processing
- AWS S3 for media storage
- Zod for validation, Jest for tests