Skip to main content
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
Kichele (Pesa Mirror) — Offline-First M-Pesa Personal Finance Tracker for Android Cover Banner
0 (100% Local)
Cloud Data Uploads
v0+3
APK Release
0px Blur + Mask
Balance Protection
0-Tap Overlay
Categorization UX
The 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)
M-Pesa SMS-to-SQLite Pipeline Inspector (Fuliza & Fee Extraction)
M-Pesa SMS-to-SQLite Pipeline Inspector (Fuliza & Fee Extraction)
Privacy-First Features: Floating Overlay, Masked Balances & Dual-SIM
Privacy-First Features: Floating Overlay, Masked Balances & Dual-SIM
Privacy-First Features: Floating Overlay, Masked Balances & Dual-SIM
Direct Android APK v1.0.2+3 Release, SHA-256 & Permissions
Direct Android APK v1.0.2+3 Release, SHA-256 & Permissions
Direct Android APK v1.0.2+3 Release, SHA-256 & Permissions