HisabMate is an offline-first personal finance application for Android. It brings everyday money management into one place: bank accounts, cards, mobile wallets, cash, foreign currencies, budgets, savings goals, recurring bills and debt records.
The app is designed around three principles:
- Local-first: financial records are stored on the device using Room and SQLite.
- Currency-aware: transactions retain their original currency, with saved exchange-rate snapshots for reporting and conversion.
- Practical portability: users can export and restore their data, and generate PDF and CSV reports.
| Project detail | Value |
|---|---|
| Application ID | com.aistudio.hisabmate.fntkbd |
| Current release | v1.0.6 · versionCode 7 |
| Minimum Android | Android 7.0 · API 24 |
| Target Android | API 36 |
| Database | Room · SQLite schema v7 |
| License | MIT |
Production APK/AAB releases use a persistent upload keystore. The current v1.0.6 GitHub Release assets were rebuilt and re-signed on 2 November 2026 with the certificate fingerprint documented in Production release signing and update compatibility.
The latest published Android release
| File | Description |
|---|---|
HisabMate-v1.0.6-release.apk |
Android installer |
HisabMate-v1.0.6-release.aab |
Android App Bundle |
SHA256SUMS.txt |
SHA-256 checksums |
SIGNING-CERTIFICATE.txt |
APK signing certificate details |
Important
Signing and installation compatibility: The current v1.0.6 APK and AAB assets were rebuilt and re-signed on 2 November 2026 with the persistent upload key whose SHA-256 certificate fingerprint is D9:3D:A9:CF:4E:28:CD:90:4A:C7:95:4C:41:2B:C1:78:38:55:4A:B2:8D:7B:7C:F5:78:D0:C4:91:31:8D:43:A9. This is the signing identity intended for future GitHub releases. Copies of v1.0.6 or earlier releases downloaded before this replacement used temporary CI signing keys and cannot be updated in place by the current APK. If one of those older builds is installed, export a JSON backup, uninstall it, install the current APK, then restore the backup. Uninstalling clears local app data.
Before installing a downloaded APK, you can verify that the file matches the published SHA-256 checksum.
Windows PowerShell:
Get-FileHash .\HisabMate-v1.0.6-release.apk -Algorithm SHA256Linux / macOS:
sha256sum HisabMate-v1.0.6-release.apkCompare the resulting hash with the corresponding APK entry in SHA256SUMS.txt from the same GitHub Release. A matching hash confirms file integrity; it does not independently verify who published the file.
- Track bank accounts, cash, credit/debit cards and mobile financial service wallets.
- Organize wallets such as bKash, Nagad and Rocket alongside international accounts.
- Record transfers between accounts, including cross-currency transfers.
- Built-in support for 14 currencies.
- Store each account and transaction in its original currency.
- Configure and manage exchange rates offline.
- Use saved exchange-rate snapshots for historical transaction conversion and reporting.
- Support South Asian and international number grouping.
- Create daily, weekly, monthly, yearly and custom-period budgets.
- Monitor spending against budget limits with local alerts.
- Track savings goals, target amounts, deadlines and contributions.
- Record recurring payments and due dates.
- Track money lent and money borrowed separately.
- Record partial repayments and outstanding balances.
- Schedule local reminders for upcoming obligations.
- Receive an instant local confirmation after each successfully saved expense, income or transfer, including the transaction name, amount, category and account.
- Review transaction receipts in the in-app Notification Center; Android 13+ asks for notification permission before the first receipt is posted.
- Generate a single-page A4 PDF financial statement.
- Export transaction data to CSV.
- Create and restore JSON backups.
- Share generated documents through Android's FileProvider.
The screenshots below are grouped by workflow. Expand a section to view its screens.
Accounts, wallets and currencies
Debts, reminders and settings
| Code | Currency | Symbol | Minor-unit precision |
|---|---|---|---|
| BDT | Bangladeshi Taka | ৳ | 2 |
| USD | US Dollar | $ | 2 |
| EUR | Euro | € | 2 |
| GBP | British Pound | £ | 2 |
| INR | Indian Rupee | ₹ | 2 |
| JPY | Japanese Yen | ¥ | 0 |
| CNY | Chinese Yuan | ¥ | 2 |
| SAR | Saudi Riyal | ر.س | 2 |
| AED | UAE Dirham | د.إ | 2 |
| CAD | Canadian Dollar | CA$ | 2 |
| AUD | Australian Dollar | A$ | 2 |
| SGD | Singapore Dollar | S$ | 2 |
| MYR | Malaysian Ringgit | RM | 2 |
| KWD | Kuwaiti Dinar | د.ك | 3 |
HisabMate uses a layered Android architecture with a repository boundary, a ViewModel-driven UI state and a local Room database.
app/src/main/java/com/example/
├── data/
│ ├── local/
│ │ ├── Entities.kt
│ │ ├── HisabDao.kt
│ │ └── HisabDatabase.kt
│ └── repository/
│ └── HisabRepository.kt
├── ui/
│ ├── components/
│ ├── screens/
│ ├── theme/
│ └── viewmodel/
├── util/
└── MainActivity.kt
| Area | Technology |
|---|---|
| Language | Kotlin 2.2.10 |
| UI | Jetpack Compose · Material 3 |
| Architecture | Repository pattern · ViewModel · StateFlow |
| Local database | Room 2.7 · SQLite schema v7 |
| Asynchronous work | Kotlin Coroutines |
| Dependency processing | KSP |
| Unit/UI testing | JUnit 4 · Robolectric |
| Android SDK | Compile/Target API 36 · Minimum API 24 |
| Build tool | Gradle 9.3.1 |
HisabMate does not declare the Android INTERNET permission in its application manifest. Its finance records are stored locally in the app's private storage; the app does not require a cloud account to manage those local records.
The manifest declares these permissions for specific device features:
| Permission | Purpose |
|---|---|
POST_NOTIFICATIONS |
Display local bill and budget reminders |
RECEIVE_BOOT_COMPLETED |
Restore scheduled reminders after device restart |
VIBRATE |
Haptic feedback |
CAMERA |
Camera-based app functionality; camera hardware is optional |
Backup reminder: local storage is not a substitute for a backup. Export a JSON backup before uninstalling the app, changing devices or performing maintenance that may clear app data.
- JDK 21
- Android SDK and Android SDK Platform 36
- Gradle 9.3.1
- Git
git clone https://github.com/CodeByArnob/HisabMate.git
cd HisabMategradle :app:testDebugUnitTest
gradle :app:lintDebuggradle :app:assembleDebugThe debug APK is generated under:
app/build/outputs/apk/debug/
Configure a release keystore and the corresponding environment variables in your local build environment. The release signing configuration expects the keystore alias upload.
PowerShell:
$env:KEYSTORE_PATH = "C:\path\to\upload-keystore.jks"
$env:STORE_PASSWORD = "your-store-password"
$env:KEY_PASSWORD = "your-key-password"
gradle :app:assembleRelease :app:bundleReleaseLinux / macOS:
export KEYSTORE_PATH="/path/to/upload-keystore.jks"
export STORE_PASSWORD="your-store-password"
export KEY_PASSWORD="your-key-password"
gradle :app:assembleRelease :app:bundleReleaseNever commit keystores, signing passwords, API keys or other secrets to the repository.
The Android CI workflow runs the automated test suite, Android Lint and build verification for debug and release packages.
Contributions, bug reports and focused improvements are welcome.
- Fork the repository.
- Create a feature branch:
git checkout -b feat/your-change. - Keep changes scoped and follow the existing Kotlin and Compose conventions.
- Run tests and lint before opening a pull request.
- Describe the problem, implementation and verification steps in your pull request.
For substantial changes, open an issue first to discuss the proposed approach.
Before requesting review, confirm that your contribution:
- Explains the user-facing problem or documentation gap.
- Keeps the change focused and consistent with the existing project conventions.
- Includes screenshots or sample output when they help explain a UI or behavior change.
- Records the tests, lint checks or manual verification actually performed.
- Updates relevant documentation when commands, setup steps or user workflows change.
Do not mark a check as complete unless you have performed that verification.
HisabMate is distributed under the MIT License.
HisabMate · Built for clarity, control and local-first personal finance.











