Architecting A 58k+ LOC Beauty Marketplace With Real-Time Bookings & Pan-African Mobile Money
How Abdul Rafay engineered GlanzGo as a Software Engineer at Mercury Sols — a dual-engine salon & wellness ecosystem spanning consumer discovery, a 6-tab provider enterprise CRM, Safaricom M-Pesa STK Push mobile payments, and a future-proof multi-country tenancy blueprint for cross-border African expansion across Kenya, Uganda, Nigeria, and South Africa.
GlanzGo is a Mercury Sols client project. Abdul Rafay built it there as a Software Engineer; it is not a RafayLabs client.
Live in Nairobi & Kenyan Metro Areas • Preparing Pan-African Rollout
The Scale Behind GlanzGo
58k+ LOC ARCHITECTURE
279 Handcrafted Source FilesEnterprise mobile codebase built on bare React Native 0.86, React 19, TypeScript, and Redux Toolkit with modular screen-level style isolation.
DUAL-ENGINE PLATFORM
Client App + Provider SuiteClient booking portal & a 6-tab Service Provider enterprise operating system (calendar, CRM, analytics, branches) unified in one mobile binary.
SUB-3S M-PESA STK PUSH
Frictionless Mobile MoneyDirect-to-phone PIN prompt via Safaricom Daraja API with automated webhook validation, idempotent transaction ledger, and instant booking confirmation.
PAN-AFRICAN MULTI-COUNTRY
GPS Isolation & PortabilitySingle portable user account with physical GPS market tenancy and driver-based payment architecture for Kenya, Uganda, Nigeria, and South Africa.
Solving Fragmentation in Emerging Market Service Commerce
In high-velocity emerging economies like Kenya, the salon and wellness industry generates millions of dollars in transactions annually. Yet, over 90% of bookings operated over fragmented WhatsApp chats, manual paper notebooks, and erratic phone calls.
This created massive business leakage: customers experienced agonizing wait times and frequent appointment overlap, while salon owners faced devastating no-show rates (often exceeding 25%) and zero telemetry into their daily revenue, stylist commissions, or customer re-engagement.
Generic Western booking software (like Fresha or Mindbody) failed fundamentally in this market because they lacked native mobile money integration (Safaricom M-Pesa), assumed desktop computers in salon back-offices, and could not operate seamlessly under unstable 3G/4G connectivity on mid-range Android hardware.
The mandate: Engineer a dual-sided, mobile-first marketplace that works natively on smartphones for both clients and salons, integrates automated M-Pesa STK Push payments, and features a modular architecture capable of launching across Uganda, Nigeria, and South Africa with zero core code rewrites.
- •Manual pen-and-paper appointment books leading to double-booked chairs
- •Cash & manual M-Pesa paybill matching prone to reconciliation theft
- •Zero tracking of client retention, styling notes, or formula history
- Real-time dynamic slot calendar with automated stylist availability
- Automated M-Pesa STK Push direct to customer phone with webhook sync
- Provider CRM with visit history, formula notes, and lapsed client alerts
Dual-Sided Marketplace Dynamics
Rather than building two disconnected apps, GlanzGo was engineered as a unified bare React Native 0.86 codebase with role-gated navigation routing (appnavigator.tsx) supporting Clients, Service Providers, and Multi-Branch Sub-Providers.
Discovery & Seamless Booking
- Geocoded Radius Search:LocationIQ and Google Maps integration allows users to discover salons by live GPS radius, neighborhood filters, and verified photo galleries.
- Multi-Service Cart & Slot Engine:Clients select multiple services (e.g., Braids + Manicure), automatically calculating cumulative service time and filtering available stylist slots.
- Pusher Realtime Messaging:Bi-directional chat between client and salon for consultation photos, custom requests, and real-time appointment updates.
- GlanzPoints Loyalty & Referrals:Automated points engine awarding discounts upon completed bookings and peer referrals, driving organic viral acquisition.
6-Tab Enterprise Salon Suite
Live operational dashboard displaying today's appointments, upcoming clients, revenue run-rate, and quick action toggles for opening/closing hours.
Interactive calendar with drag-and-drop schedule adjustments, status state machine (Pending → Confirmed → Completed → No-Show), and check-in workflows.
Granular service catalogs with tiered duration (30m, 60m, 90m), custom stylist variant pricing, promotional packages, and staff skill tags.
Dedicated customer ledger with past visit history, personal styling notes, formula records, and automated alerts for lapsed clients needing re-engagement.
Data-driven reporting on top-performing stylists, revenue by service category, peak booking hours, and acquisition source telemetry.
Franchise-grade sub-service provider hierarchy allowing business owners to provision branch accounts, set stylist commissions, and audit staff shifts.
Pan-African Multi-Country Architecture
While launched in Kenya, GlanzGo's architectural DNA was engineered from day one for Pan-African expansion. The system decouples user identity from geographic boundaries, using GPS-isolated market tenancy and pluggable payment drivers.
100% Account Portability
A single user account functions across every market. A client traveling from Nairobi to Kampala or Lagos retains their login, profile, and booking history without creating a second account.
Physical GPS Market Tenancy
Active market is driven strictly by the user's real device coordinates, preventing artificial price arbitrage between countries while automatically switching currencies and localized catalogs upon border transit.
Driver-Based Payment Abstraction
Payment gateways adhere to a unified interface contract (PaymentGatewayInterface). Adding a new African territory requires provisioning a driver config rather than refactoring mobile UI code.
| Target Market | Currency & Code | Payment Driver | Architectural Implementation |
|---|---|---|---|
| 🇰🇪Kenya (Live Production) | KES (Kenyan Shilling) | Safaricom M-Pesa STK Push | Integrated via Daraja REST API with encrypted credentials, instant PIN prompt on device, and webhook settlement callback. |
| 🇺🇬Uganda (Expansion Ready) | UGX (Ugandan Shilling) | MTN Mobile Money & Airtel Money | Localized telecom USSD push triggers, tiered carrier fees, and standalone national subscription pricing per establishment. |
| 🇳🇬Nigeria (Expansion Ready) | NGN (Nigerian Naira) | Paystack & Flutterwave Gateway | Supports debit/credit cards, bank USSD codes, virtual bank transfer accounts, and localized 7.5% VAT calculation. |
| 🇿🇦South Africa (Expansion Ready) | ZAR (South African Rand) | Ozow Instant EFT & Card Gateways | Direct bank integration via Instant EFT, 3D-Secure card tokenization, and multi-location franchise management. |
The GlanzGo Engine Blueprint
Because GlanzGo was architected with decoupled modular foundations—two-sided role gating, dynamic calendar slot generation, localized mobile money drivers, and multi-branch CRM—this exact engineering DNA powers four high-value marketplace sectors:
TELEHEALTH & CLINIC APPOINTMENTS
Practo / Zocdoc BlueprintPatients search clinics and doctors by specialty, filter by insurance and location, and book confirmed consultation slots. The provider app gives doctors a clinical schedule, patient health telemetry, and prescription records.
HOME SERVICES & HANDYMAN MARKETPLACE
Urban Company / TaskRabbit BlueprintCustomers select home repair, cleaning, or beauty services at their doorstep. Independent contractors receive dispatch alerts, navigate via in-app maps, and collect digital mobile money payments upon job completion.
FITNESS & PERSONAL TRAINER NETWORK
Mindbody / ClassPass BlueprintGyms and freelance personal trainers list session schedules, group classes, and tier packages. Members book slots with digital credits or subscriptions, while instructors track attendance and client progress notes.
B2B EQUIPMENT & CO-WORKING RENTALS
Peerspace / Yard Club BlueprintCompanies browse and reserve professional studio spaces, commercial kitchen equipment, or construction tools by the hour or day, backed by verified deposits and automated invoicing.