Solo•Live Showcase & APK Release (v1.0.2+3)•2026 – Present
Kichele (Pesa Mirror) — Offline-First M-Pesa Personal Finance Tracker for Android
Privacy-preserving Android finance tracker intercepting M-Pesa SMS in real time via native Kotlin, featuring a 1-tap floating categorization overlay and 100% on-device SQLite.

Kichele (Pesa Mirror) — Offline-First M-Pesa Personal Finance Tracker for Android Cover Banner
0 (100% Local)
Cloud Data Uploadsv0+3
APK Release0px Blur + Mask
Balance Protection0-Tap Overlay
Categorization UXThe Challenge
Problem & Context
Kenyan M-Pesa users accumulate hundreds of unstructured SMS receipts with buried transaction fees, multi-SIM confusion, and sensitive account balances exposed on lock screens—while refusing to upload financial data to third-party clouds.
An offline-first, privacy-preserving M-Pesa personal finance ledger for Android (Flutter 3 + Native Kotlin + SQLite) paired with a Next.js 15 product showcase and Django 5 release API.
Architecture & Delivery
Key Architectural Highlights
Engineered a native Android Kotlin BroadcastReceiver and foreground SmsListenerService with an offline PendingSmsStore queue to intercept M-Pesa SMS in real time even when the Flutter engine is closed.
Built a system-wide FloatingOverlayService (WindowManager) card that pops up immediately upon transaction arrival with a recency-sorted, flow-aware 1-tap category pill strip writing straight to native SQLite.
Implemented privacy-first balance protection: masked balances (Ksh••••••) by default, tap-to-reveal with auto-hide on app switch, and a 14px BackdropFilter frosted-glass SMS inspector.
Added Dual-SIM subscription auto-discovery and internal self-transfer isolation (neither flow bucket) plus Fuliza overdraft separation and Money Lost to Fees analytics.
Shipped a matching Next.js 15 showcase website with an interactive simulated phone demo and a Django 5 release metadata API serving signed APK updates via Nginx zero-copy streaming.
Deep Dive
Engineering Challenges & Solutions
THE HARD PROBLEM
Standard Flutter Dart listeners stop executing when Android kills the background engine, dropping incoming M-Pesa notifications and preventing instant categorization.
THE ARCHITECTURAL SOLUTION
Dropped down into native Kotlin to build a BroadcastReceiver, foreground service, PendingSmsStore disk queue, and WindowManager floating overlay that commits categories directly to sqflite.
Technology Stack
Tools & Technologies Used
Android & Mobile
Flutter 3DartNative KotlinWindowManager Overlaysqflite
Showcase Web
Next.js 15React 19TypeScriptInteractive Phone Demo
Release Backend
Django 5DRFPostgreSQL 16SHA-256 Checksum API
Cloud Hosting
Oracle Cloud ARM64Nginx sendfile (2 MB/s limit)PM2Systemd
Interface Gallery
Visual Walkthrough & Captures

M-Pesa SMS-to-SQLite Pipeline Inspector (Fuliza & Fee Extraction)

Privacy-First Features: Floating Overlay, Masked Balances & Dual-SIM

Direct Android APK v1.0.2+3 Release, SHA-256 & Permissions