Nudge

Capture bank and UPI activity, review it quickly, and understand where your money went without sending financial messages to a server.

Nudge is a personal expense manager built around one idea: routine transaction logging should require almost no effort. The Android app can read bank SMS messages and payment-app notifications, parse transaction details on the device, reject duplicates, learn from review decisions, and place the result into a focused transaction timeline.

Nudge is an Android-first product. This repository contains the mobile application, its shared Kotlin parsing module, and the static public landing page in web/. The website is isolated from Gradle and has no access to app data; Nudge has no web dashboard, account service, or financial-data relay.

Highlights Area What Nudge provides Automatic capture Real-time bank SMS and notification-listener ingestion for debit, credit, refund, card, wallet, and UPI alerts Local parsing Layered financial-event classification, bundled bank/payment templates, heuristic fallbacks, merchant normalization, and confidence scoring Smart review Confirm, correct, categorize, or reject uncertain captures; local rules remember merchant corrections and repeated rejection patterns Duplicate protection Source IDs, message fingerprints, time/amount matching, and learned identities prevent rescanned messages from creating the same transaction again Manual entry Haptic keypad, swipeable historical date selection, notes, repeat schedules, expense/income/refund types, category grid, account grid, and merchant Shared expenses Local friend list, equal/exact/percentage splits, flexible payer selection, outstanding balances, and one-tap settlement Recurring entries Weekly, monthly, or yearly local schedules materialized on the next app launch without a cloud account Transaction timeline Month navigation, search, type/shared/smart filters, editable entries, source-message access, and swipe-to-delete with undo Analytics Monthly expense mix, category shares, and daily money-in/money-out rhythm Accounts Cash, savings, credit card, debit card, UPI, and wallet accounts in an animated stacked carousel Card scanning On-device ML Kit recognition; the captured image is discarded and only limited card metadata is retained Smart import Local CSV/TXT/PDF/image parsing for bank statements and common expense-app exports, share-sheet text/image intake, Latin + Devanagari OCR fallback, review-before-save, and duplicate suppression Receipt intelligence Multi-page CameraX/gallery capture, Latin + Devanagari on-device OCR, Indian receipt-table parsing, product quantity/rate/value extraction, GST and printed-total reconciliation, and one-expense or itemized saving Categories Built-in and custom categories with editable colors, 200 searchable icons, and user-defined emoji glyphs Local profile Display name and profile image stored inside app-private storage Data ownership Versioned JSON export/import including friends, splits, and recurring schedules; retention controls; complete local-data deletion Widgets Compact, snapshot, and expanded home-screen widgets with responsive layouts Polish Dark/light themes, JetBrains Mono typography, Lucide-style icons, semantic haptics, and Compose micro-interactions Reminders Optional daily expense check-ins with rotating copy and Android notification-permission handling Guided start A first-run seven-step coach-mark tour over the real Transactions and Analytics screens Distribution Separate Google Play and GitHub builds: Play-managed delivery for the store and signed APK updates for GitHub users Support An optional creator-tip screen; 100% goes to the creator and it unlocks no app content or benefit

License

MIT