Michael Samuel Naeem
InsightlySpend app icon

Android app · Finance

InsightlySpend

Personal finance and spending insight tool for tracking money habits with clarity.

Get it on Google Play ↗ Source on GitHub ↗

Key takeaways

  • InsightlySpend is a free Android app in the Finance category: personal finance and spending insight tool for tracking money habits with clarity.
  • Download it free from the Google Play Store (package com.michael.insightlyspend).

A local-first personal finance app for Android. Data is stored in Room; lists and summaries use observed queries so changes propagate across tabs when you add, remove, or duplicate transactions.

The bottom navigation has six sections: Home, Ledger, Insights, Budget, Vault (receipts), and Settings.

GIF cycles through main tabs; regenerate after UI changes with python3 scripts/generate_readme_gif.py (requires Pillow).

Architecture

The codebase follows a layered structure under app/src/main/java/com/michael/insightlyspend/:

Layer Role
Presentation (presentation/) Jetpack Compose screens, ViewModels (StateFlow / coroutines), navigation (Navigation Compose).
Domain (domain/) Use cases, repository interfaces, and domain models shared by UI and data.
Data (data/) Room (DAOs, entities, DB), repository implementations, mappers, DataStore preferences, WorkManager workers, ML/adapters for Insights.

Dependency injection uses Hilt (@AndroidEntryPoint, @HiltViewModel, modules under di/). Background work (e.g. recurring posting) uses WorkManager with Hilt worker integration.

Navigation: single-activity, MainShell hosts a bottom NavHost with typed routes (AppRoutes) and optional deep links (insightlyspend://nav/...) for tooling (e.g. Play Store screenshots).

Startup: MainActivity applies locale/theme; optional BiometricGate wraps the main shell when lock is enabled.

Libraries

Primary dependencies (see gradle/libs.versions.toml and app/build.gradle.kts):

Area Libraries
UI Jetpack Compose (BOM), Material 3, Activity Compose, material-icons-extended
Architecture Lifecycle (runtime, ViewModel, Compose integration), Kotlin Coroutines (Android)
Navigation Navigation Compose, Hilt Navigation Compose
DI Dagger Hilt (with KSP for Hilt compiler)
Persistence Room (runtime, KTX, KSP compiler)
Preferences Datastore Preferences
Background WorkManager (+ Hilt Work)
Security / UX Biometric
ML (Insights) LiteRT (litert, litert-api) for optional on-device inference
Interop AppCompat, Fragment KTX (where needed for delegates / legacy APIs)

Testing: JUnit, AndroidX JUnit, Espresso, Compose UI Test.

Home (Dashboard)

Purpose: High-level snapshot of your finances and a shortcut to add a transaction.

UI element What it does
Overview card Total balance — sum of all wallet (account) balances. Income / Spend — this month’s total income vs total expenses.
Budget progress (if you have category budgets) Linear bar — spend vs total monthly budget cap. “Spent X of Y” — numeric comparison.
Daily spending (7 days) Line chart of expense totals per day for the last seven calendar days.
Recent transactions Up to five latest rows (category, note, amount). Tapping the FAB is the main way to add more; the list updates when the database changes.
Floating action button (+) Opens Quick add (see below).

Quick add (bottom sheet)

Opened from the Home FAB. Creates a new transaction in Room and updates account balance.

Field / control What it does
Amount Transaction amount (decimal).
Category Picker of all categories; label follows your app language (English/Arabic names when set).
Wallet Account to book the transaction against (affects total balance).
Income If on, the line is treated as income; if off, as spending.
Cash payment If on, payment method is cash; if off, card.
Recurring template Marks the row for recurring/repeat logic where supported.
Debt / lending Standard / I owe / Owed to me — how the amount relates to debt tracking.
Note Optional text (searchable from the ledger).
Choose from gallery / Take photo Gallery opens the system photo picker (images only). Take photo launches the device camera and saves into app cache via FileProvider; the URI is stored on the transaction so it appears under Vault. Remove image clears the selection before save.
Save Inserts the transaction (with optional receipt URI) and closes the sheet.

Ledger

Purpose: Full searchable list of transactions with filters and swipe actions.

UI element What it does
Search notes Filters rows whose note contains the text (case-insensitive).
Cash only When selected, only cash payment-method transactions.
This month Restricts to start of current month → end of current month (and can stack with cash filter).
Clear filters Removes date range and payment filters (search is separate).
Day group headers “Today”, “Yesterday”, or a calendar date; rows are grouped by day.
Each card Category icon, category name (localized), note, time, and signed amount (green + income, red − spend).
Swipe end → start Delete that transaction (updates balance).
Swipe start → end Duplicate — creates a new row with the same details and current time; original row stays.

The ledger is driven by a Room Flow, so it stays in sync with the database.

Insights (Analytics)

Purpose: On-device analytics: forecast, month comparison, category mix, and simple anomaly hints.

Section What it does
Title Screen heading.
Predictive forecast Estimated month-end spend, optional confidence range; method name may reflect linear regression and/or a bundled ML model.
Month comparison This month vs last month spend, and percent change when available.
Category breakdown Pie and bar charts of share of spending by category (for the reporting window the engine uses).
Anomaly hints Short bullet lines with a z-score-style stat for unusual days/categories, when the report includes any.

This screen is built from a computed report; pull-to-refresh or reopening the tab refreshes it (it is not the same live Flow pipeline as Home, unless you extend it).

Budget

Purpose: See per-category monthly budgets that you have set, with spend vs limit; add or manage those categories from here.

UI element What it does
Title + hint Explains that alerts can fire around high usage.
Loading / error States while data loads or if something fails.
Each category card Name (localized), Remaining, Spent X of Y, progress bar. Can highlight when past a threshold.
Edit (pencil) Opens a sheet: English/Arabic names (per language rules), monthly budget for that category; Save updates Room.
Delete (bin) Only if more than one category exists in the app. Confirms that transactions move to another category and recurring rules for that category are removed.
FAB (+) New budget category — bilingual names, monthly budget amount, creates the category with a limit so it appears here.

Only categories that have a monthly budget limit appear as rows on this tab.

Vault (Receipts)

Purpose: Grid of transactions that have an attachment image (receipt photo). Attach images when creating a transaction via Home → Quick add → Choose from gallery or Take photo; those rows show up here automatically.

UI element What it does
Title + hint Describes storing image URIs on transactions in the database.
Each tile Thumbnail of the image (or Attachment placeholder if the URI cannot be loaded), category, optional note.

Settings

Purpose: Categories and recurring rules, app preferences, security, and exports.

Categories

UI element What it does
Section title “Categories” — manage all categories.
Add category Opens sheet with English and Arabic names (required/optional rules follow interface language).
Each row Category label; edit opens the same bilingual editor; delete (if not the last category) merges transactions and clears recurring rules for that category (with confirmation).

Recurring transactions

UI element What it does
Add rule Opens editor for a monthly recurring rule.
Each rule card Shows category, amount, day of month, wallet, optional note; edit / delete.
Rule editor fields Amount, category, wallet, day (1–28), income, cash vs card, debt mode, note, Save. Saving enqueues a one-time background job so a charge can post soon if today’s calendar day matches the rule’s day (once per month). Daily periodic work also runs as a backup. Posted rows appear on Home and Ledger like any other transaction (Room flows).

Rest of Settings

UI element What it does
Currency Chips (USD, EUR, GBP, AED, SAR, EGP, JPY, INR, …) — display/formatting for amounts.
Language System, English, or Arabic — UI strings and category/name picking behavior.
Theme System, Light, or Dark.
Biometric lock When enabled, unlocking uses device biometrics before showing the app (see startup gate).
Export CSV / Export PDF Generates files and opens the Android share sheet so you can save or send backups/summaries.

Startup & theme

Data flow (single source of truth)

For questions about building or extending the project, refer to build.gradle files and the package layout under app/src/main/java/com/michael/insightlyspend/.

Frequently asked questions

What is InsightlySpend?

InsightlySpend is a free Android app by Michael Samuel Naeem in the Finance category. Personal finance and spending insight tool for tracking money habits with clarity.

How much does InsightlySpend cost?

InsightlySpend is free to download on the Google Play Store, with no subscription required to get started.

Where can I download InsightlySpend?

You can install InsightlySpend from the Google Play Store, and the source code is available on GitHub.

Hiring a senior Android / Flutter engineer?

I architect and ship production mobile software — Kotlin, Jetpack Compose, Flutter — for robotics, EV infrastructure, fintech, and real-time systems. Open to remote roles in Europe and the US.

Get in touch →

All Android app names

Complete index of Michael Samuel Naeem Android apps on Google Play and GitHub, including utility, privacy, productivity, developer, media, finance, and device tools. Search engines can discover each exact product name, package, marketplace listing, and source page from this index.