Skip to main content

Mimshack Logistics

1. Overview​

Mimshack Logistics is a technology-driven logistics orchestration platform designed to provide fast, reliable, and scalable delivery solutions. It unifies Consumer (P2P), Enterprise (B2B), and 3PL Driver networks into a single "Headless API" driven ecosystem, supporting on-demand, scheduled, bulk, and multi-destination workflows.

2. Mission & Market​

  • Mission: To democratize access to efficient logistics for individuals and businesses across Africa through innovation and operational excellence.
  • Market: Last-mile delivery (Nigeria), Retail distribution, E-commerce fulfillment, and Enterprise supply chain management.

3. Services Offered​

  • On-Demand Delivery: Instant bike/vehicle dispatch for time-sensitive items.
  • Scheduled Deliveries: Plan pickups and drop-offs for future dates/times.
  • Bulk & Multi-Drop: Efficient routing for multiple packages in a single trip (CSV-based).
  • Haulage & Warehousing: Heavy cargo movement and temporary storage solutions.
  • Business API Integrations: Empowering third-party platforms to plug directly into our logistics network.

4. Target Customers​

  • E-commerce & Retail: Online vendors and physical stores requiring reliable last-mile delivery.
  • SMEs: Pharmacies, food vendors, and small manufacturers.
  • Corporate Organizations: Internal document movement and high-volume logistics.
  • Individuals: P2P delivery of keys, documents, gifts, and personal items.

5. Tech Stack​

  • Backend: Laravel 12 (REST API + Webhooks).
  • Web: Next.js 15 (Enterprise Dashboard & Public Site).
  • Mobile: React Native (Expo SDK 54) using a Tamagui monorepo for shared UI.
  • Database: PostgreSQL (Core) & MySQL (Legacy/Analytics).
  • Realtime: Pusher (Live location/updates).
  • Infrastructure: VPS hosting with Docker containerization.

6. App Features​

  • Order Creation: Support for single, bulk, and scheduled orders.
  • Multi-Destination Routing: Intelligent pathing for efficient multi-drop deliveries.
  • Live Tracking: Real-time location updates via WebSockets and Google Maps.
  • Wallet & Payments: Cashless system for top-ups, transfers, and instant settlement.
  • Analytics: Detailed delivery and financial reporting for businesses.
  • Proof of Delivery (PoD): Digital confirmation via OTP or signature.

7. API Integrations & Platforms​

  • Platforms: Unified Mobile App (User/Driver), Business Web Dashboard, Admin Portal.
  • Maps: Google Maps Platform (Geocoding, Places, Matrix API).
  • Notifications: Firebase Cloud Messaging (FCM) for push alerts.
  • Communication: Termii/Twilio for SMS OTPs and in-app chat/calling.

8. Operations Flow​

  1. Creation: User or business creates a delivery request via app, web, or API.
  2. Assignment: System assigns a driver automatically (Nearest Neighbor) or via Admin manual override.
  3. Acceptance: Driver accepts the order and navigates to the pickup location.
  4. Transit: Driver validates the package; user tracks the progress in real-time.
  5. Completion: Driver delivers package, validates PoD, and payment is settled/transferred to the driver wallet.

9. Support & Escalation​

  • L1 (In-App Support): Chat support for general inquiries and tracking help.
  • L2 (Ops Intervention): Manual overrides for driver assignment and refund processing.
  • L3 (Engineering): Handling API failures, payment gateway issues, or app bugs.

10. Roadmap​

  • Q1: Launch Public API for external developers and API key management.
  • Q2: AI-assisted route optimization and Enterprise SLA dashboards.
  • Q3: Partner marketplace and Cross-border delivery capabilities.

11. Known Issues​

  • Maps Latency: Occasional polling delays in low-network areas.
  • Push Notifications: Delays on specific Android OEMs due to battery optimization.
  • Inventory Sync: Real-time driver availability may lag by a few seconds during peak hours.

12. KPIs & Metrics​

  • Delivery Success Rate: Target > 98%.
  • Avg. Pickup Time: Target < 12 minutes.
  • Driver Retention: Target > 85% Monthly.
  • API Uptime: 99.9% availability.