SokoNort

Https://SokoNort.wep.app
A full-stack marketplace and delivery platform built for Adjumani District, Uganda — live on the web, in pre-launch ahead of public rollout.
Architecture: React 18 + Vite SPA, PWA with offline-first design and service worker caching. MVVM pattern using custom hooks as ViewModels (e.g. useCheckoutViewModel). Firebase (Auth, Firestore, Cloud Functions, Hosting) backend with Node.js/Express, plus Cloudflare Workers and R2 (S3-compatible) for image storage.
Auth & security: Firebase Auth (Phone/OTP, Email/Password, Anonymous) with JWT verification and role-based access control across 4 tiers (Customer, Vendor, Commercial Partner, Admin), backed by 260+ lines of Firestore security rules. App Check with reCAPTCHA v3. Token-bucket rate limiting on sensitive endpoints.
Payments: Multi-provider Mobile Money integration (MTN MoMo, Airtel Money, Relworx, Flutterwave, Beyonic, Yo! Payments) via USSD push, with webhook-based payment confirmation and reconciliation, plus cash-on-delivery.
AI integration: In-app customer care agent via an LLM gateway (Gemini, OpenRouter) using a circuit-breaker pattern that falls back to a local rule-based engine during API disruptions.
Notifications: Dual-channel order updates — push notifications (in-app, real-time) and SMS via Africa’s Talking (reaches customers without the app installed).
Tailwind CSS, mobile-first, dark/light theming, optimistic UI updates on cart and order state.