https://github.com/blue-mix/cashio
A modern, privacy-first personal finance tracker built with Jetpack Compose.
https://github.com/blue-mix/cashio
android-app expense-tracker jetpack-compose koin-kotlin kotlin notification-parsing sms-parser
Last synced: 3 months ago
JSON representation
A modern, privacy-first personal finance tracker built with Jetpack Compose.
- Host: GitHub
- URL: https://github.com/blue-mix/cashio
- Owner: blue-mix
- License: gpl-3.0
- Created: 2025-12-27T10:19:38.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-27T11:23:05.000Z (6 months ago)
- Last Synced: 2025-12-29T03:39:42.311Z (6 months ago)
- Topics: android-app, expense-tracker, jetpack-compose, koin-kotlin, kotlin, notification-parsing, sms-parser
- Language: Kotlin
- Homepage:
- Size: 1.62 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
---
Cashio
A modern, privacy-first personal finance tracker built with Jetpack Compose.
---
## Smart Expense & Income Tracker for Android
Cashio is a production-grade personal finance app built with Jetpack Compose and clean architecture principles. It focuses on clarity, speed, and thoughtful UX, enabling users to track expenses and income with calendar-based insights, meaningful visuals, and smooth interactions.
---
## App Screens
---
## Product Philosophy
Cashio was built to address a common weakness in many expense trackers: showing numbers without helping users understand their spending.
Core design principles:
* Calendar-first exploration
* Visual spending intensity via heatmaps
* Fast, low-friction data entry
* Local-first and privacy-respecting by default
---
## Key Features
### Smart Transaction Tracking
* Add expenses & income with categories, notes, date & time
* Edit transactions seamlessly
* Clear validation and error handling
### Calendar-Driven History
* Monthly calendar heatmap showing spending intensity
* Tap any date to instantly filter transactions
* Day-grouped expandable transaction cards
### Analytics & Insights
* Monthly spend overview
* Category-wise breakdown
* Net income vs expense indicators
### Polished UX & Motion
* Compose animations for hierarchy and feedback
* Haptic feedback for meaningful actions
* Material 3 styling with semantic colors
### Privacy-First
* Local-first data handling
* No ads, no tracking SDKs
* Designed with Play Store policy compliance in mind
---
## Architecture Overview
Cashio follows Clean Architecture + MVVM with strict separation of concerns.
```text
data/
├── local/
├── notification/
├── repository/
└── sms/
domain/
├── model/
├── repository/
└── usecase/
├── base/
├── category/
├── expense/
├── keyword/
└── preferences/
presentation/
├── add/
├── analytics/
├── categories/
├── common/
├── history/
├── home/
├── keyword/
├── onboarding/
├── settings/
└── transaction/
ui/
├── components/
├── defaults/
├── navigation/
└── theme/
```
### Architectural Principles
* Single source of truth via immutable UI state
* Unidirectional data flow
* Business logic isolated in UseCases
* UI is fully state-driven
---
## Engineering Highlights
### State Management
* No UI-side sorting or filtering
* ViewModels own all transformation logic
* Predictable, testable state flows
### Calendar Heatmap
* Dynamic percentile-based intensity
* Automatically adapts to individual spending habits
* Avoids hardcoded thresholds that break across users
### Performance
* Pre-sorted day groups computed once
* Lazy rendering only where data size demands it
* Zero recomposition loops from derived UI logic
---
## Status
Feature-complete core flows; polishing analytics and performance; preparing for Play Store compliance.
---
## Testing Strategy
* ViewModel logic is isolated and testable
* UI driven by deterministic state
* Defensive error handling for all data flows
---
## Installation
```bash
git clone https://github.com/your-username/cashio.git
```
Open in Android Studio Hedgehog+, sync Gradle, and run on an emulator or device.
---
## Contributing
This project is currently maintained by a single developer. Thoughtful discussions, suggestions, and PRs are welcome.
---
## Vision
Cashio aims to be a fast, beautiful, and trustworthy personal finance companion, built with the same rigor and care as professional fintech products.
---