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
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
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
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=stripe→No code changes — set the provider in your .env and deploy.
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)
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
