Complete source code · ready to deploy

A complete ride-hailing platform — yours to own.

Masarat is a production-grade, trilingual (Arabic / French / English) VTC platform: two mobile apps, an admin dashboard and a Node.js API. Fully documented, tested, and built to deploy in any market.

Built for Mauritania · adaptable to any market via swappable providers

110K+
Lines of code
135
API endpoints
18K
Lines of tests
5
Payment gateways
3
Built-in languages
In the box

Everything you need to launch

Six deliverables, one coherent codebase — apps, backend, design system and docs.

Passenger App

iOS & Android, built with Expo / React Native.

  • Booking, live tracking & ETA
  • Fare estimate, negotiation & bids
  • In-app chat, wallet & promos
  • Safety: SOS, trip share, ratings

Driver App

A dedicated app for drivers, Expo / React Native.

  • Ride requests & fare bidding
  • Earnings & in-app wallet
  • Online/offline & navigation
  • Trip history & performance stats

Admin Dashboard

Web back-office, React + Vite.

  • Live dispatch & ride management
  • Driver onboarding & verification
  • Moderation, promos & settings
  • Wallet recharges & analytics

Backend API

Node.js, Express & MongoDB.

  • 135 REST endpoints
  • Real-time via Socket.IO + Redis
  • JWT auth, roles & rate limiting
  • Clean Architecture, fully typed

Shared Design System

The @masarat/ui package.

  • Design tokens & theming
  • Reusable primitives
  • RTL-ready out of the box
  • Shared across every app

Documentation

Onboard in hours, not weeks.

  • Architecture guide
  • OpenAPI / Swagger + Postman
  • Provider integration guides
  • Security & key-rotation checklist
Capabilities

What the platform does

Battle-tested features across riders, drivers, safety, operations and infrastructure.

For Riders

  • Instant & scheduled booking
  • Live GPS tracking & ETA
  • Fare estimate, negotiation & bids
  • In-app chat with driver
  • Wallet, promo codes & receipts
  • Two-way ratings & favorites
  • Saved pickup points
  • Lost & found

For Drivers

  • Incoming ride requests
  • Bid on fares
  • Earnings & in-app wallet
  • Online / offline toggle
  • Turn-by-turn navigation
  • Trip history & stats

Safety

  • SOS panic button
  • Trusted contacts
  • Live trip sharing
  • Public tracking link
  • Real-time GPS audit

Admin & Ops

  • Live dispatch console
  • Driver verification
  • Ride & user management
  • Ratings & block moderation
  • Promo campaigns
  • Wallet recharges & transactions
  • App settings & analytics

Platform & Infra

  • Real-time Socket.IO events
  • Trilingual AR / FR / EN with full RTL
  • Swappable providers via env vars
  • JWT auth + rate limiting
  • Clean Architecture
  • 18K lines of automated tests
Vendor-agnostic

Swap any provider with one env variable

Every third-party service sits behind an abstraction — change vendors without touching code.

Payments

  • Stripe
  • Flutterwave
  • Bankily B-PAY
  • Masrvi / Click
  • Manual

SMS / OTP

  • Twilio
  • WhatsApp (Meta)
  • Rimvas
  • Console

Maps

  • Google Maps
  • Mapbox

Storage

  • Cloudinary
  • Amazon S3

Push notifications

  • Firebase FCM
  • Console

PAYMENT_PROVIDER=stripeNo code changes — set the provider in your .env and deploy.

Honest scope

What's included — and what's not

No surprises. Here is exactly what you get, and what you bring.

Included in the package

  • Full source code — all apps, admin & backend (110K+ LOC)
  • 18K LOC automated test suite
  • Complete docs: architecture, OpenAPI, Postman
  • Provider abstractions (SMS, maps, storage, push, payments)
  • Trilingual Arabic / French / English with full RTL
  • Clean, commented, production-grade codebase

Not included — you supply

  • Third-party API keys (maps, SMS, payments)
  • Firebase project & config files
  • Apple Developer & Google Play accounts
  • App bundle IDs & Expo EAS project
  • Server hosting & MongoDB provisioning
  • Ongoing maintenance & support (optional)
Under the hood

A modern, familiar stack

Mainstream, well-supported technologies your team already knows.

Mobile

  • React Native
  • Expo
  • Expo Router
  • Zustand
  • React Query
  • i18next

Backend

  • Node.js
  • Express
  • MongoDB
  • Mongoose
  • Socket.IO
  • Redis
  • JWT

Web / Admin

  • React
  • Vite
  • TypeScript
  • Tailwind CSS

Quality

  • Jest
  • MongoDB Memory Server
  • OpenAPI 3.0
  • Postman

Interested?

Get in touch for a live demo, a code walkthrough, or pricing.

contact@masarat.app