Millanto/cashbridge

Offline-first fintech wallet & bookkeeping platform for African market traders 🇬🇭 # 🏦 CashBridge Sandbox Portal > **Production-Ready Offline-First Wallet & Bookkeeping App for African Informal Markets** > > CashBridge bridges Ghanaian market women, informal traders, and mobile money agents with stable payment rails (MTN MoMo, Paystack) and local-first data indexing, surviving any internet disruption gracefully. --- ## 🏗️ Core Architecture Overview CashBridge is structured intentionally into two completely independent projects to preserve separation of concerns, allow clean horizontal autoscaling, and target distinct deployment runtimes: ``` ┌──────────────────────────────────────────────┐ │ CASHBRIDGE CLIENT DESKTOP / PWA │ │ (React 19 + Zustand state + IndexedDB local)│ └──────────────────────┬───────────────────────┘ │ [Pushes Queued Local Transactions] [Retrieves Real-time Mobile Balance] │ ▼ ┌──────────────────────────────────────────────┐ │ EXPRESS.JS BACKEND RUNTIME │ │ (Secured by Helmet, Rate-Limit & JWT) │ └──────────────────────┬───────────────────────┘ │ ┌──────────────────────┴──────────────────────┐ ▼ ▼ ┌──────────────────────────────────┐ ┌──────────────────────────────────┐ │ SUPABASE POSTGRES DB │ │ THIRD-PARTY PAYMENT INGRESS │ │ (RLS protection, triggers) │ │ (MTN MoMo Sandbox, Paystack) │ └──────────────────────────────────┘ └──────────────────────────────────┘ ``` --- ## 📂 Separated Directory Layouts ### 🟢 1. CashBridge Frontend (`cashbridge-frontend`) A lightweight, mobile-first PWA serving interface components instantly. ``` cashbridge-frontend/ ├── public/ │ ├── sw.js # PWA Service Worker caching core assets & shell │ └── manifest.json # Webapp installation parameters for mobile screens ├── src/ │ ├── db/ │ │ └── localDb.ts # IndexedDB wrapper for local transaction queues │ ├── hooks/ │ │ └── useOfflineSync.ts # Network stat …