{"id":35205272,"url":"https://github.com/blue-mix/cashio","last_synced_at":"2026-04-16T15:02:11.678Z","repository":{"id":330702503,"uuid":"1123649808","full_name":"blue-mix/Cashio","owner":"blue-mix","description":"A modern, privacy-first personal finance tracker built with Jetpack Compose.","archived":false,"fork":false,"pushed_at":"2025-12-27T11:23:05.000Z","size":1696,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-12-29T03:39:42.311Z","etag":null,"topics":["android-app","expense-tracker","jetpack-compose","koin-kotlin","kotlin","notification-parsing","sms-parser"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blue-mix.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-27T10:19:38.000Z","updated_at":"2025-12-27T11:45:03.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blue-mix/Cashio","commit_stats":null,"previous_names":["blue-mix/cashio"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/blue-mix/Cashio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue-mix%2FCashio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue-mix%2FCashio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue-mix%2FCashio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue-mix%2FCashio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blue-mix","download_url":"https://codeload.github.com/blue-mix/Cashio/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blue-mix%2FCashio/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31891038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T11:36:10.202Z","status":"ssl_error","status_checked_at":"2026-04-16T11:36:09.652Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android-app","expense-tracker","jetpack-compose","koin-kotlin","kotlin","notification-parsing","sms-parser"],"created_at":"2025-12-29T13:39:39.946Z","updated_at":"2026-04-16T15:02:11.673Z","avatar_url":"https://github.com/blue-mix.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logo.png\" width=\"120\" alt=\"Cashio Logo\"/\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eCashio\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A modern, privacy-first personal finance tracker built with Jetpack Compose.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg alt=\"Kotlin\" src=\"https://img.shields.io/badge/Kotlin-2D2D2D?logo=kotlin\" /\u003e\n  \u003cimg alt=\"Compose\" src=\"https://img.shields.io/badge/Jetpack%20Compose-2D2D2D?logo=android\" /\u003e\n  \u003cimg alt=\"Material3\" src=\"https://img.shields.io/badge/Material%203-2D2D2D\" /\u003e\n  \u003cimg alt=\"Architecture\" src=\"https://img.shields.io/badge/Clean%20Architecture-2D2D2D\" /\u003e\n  \u003cimg alt=\"License\" src=\"https://img.shields.io/badge/License-MIT-2D2D2D\" /\u003e\n\u003c/p\u003e\n\n---\n\n## Smart Expense \u0026 Income Tracker for Android\n\nCashio 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.\n\n---\n\n## App Screens\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/screenshots/dashboard.png\" width=\"220\"/\u003e\n  \u003cimg src=\"assets/screenshots/calendar.png\" width=\"220\"/\u003e\n  \u003cimg src=\"assets/screenshots/addexpense.png\" width=\"220\"/\u003e\n  \u003cimg src=\"assets/screenshots/settings.png\" width=\"220\"/\u003e\n  \u003cimg src=\"assets/screenshots/analytics.png\" width=\"220\"/\u003e\n\u003c/p\u003e\n\n---\n\n## Product Philosophy\n\nCashio was built to address a common weakness in many expense trackers: showing numbers without helping users understand their spending.\n\nCore design principles:\n* Calendar-first exploration\n* Visual spending intensity via heatmaps\n* Fast, low-friction data entry\n* Local-first and privacy-respecting by default\n\n---\n\n## Key Features\n\n### Smart Transaction Tracking\n* Add expenses \u0026 income with categories, notes, date \u0026 time\n* Edit transactions seamlessly\n* Clear validation and error handling\n\n### Calendar-Driven History\n* Monthly calendar heatmap showing spending intensity\n* Tap any date to instantly filter transactions\n* Day-grouped expandable transaction cards\n\n### Analytics \u0026 Insights\n* Monthly spend overview\n* Category-wise breakdown\n* Net income vs expense indicators\n\n### Polished UX \u0026 Motion\n* Compose animations for hierarchy and feedback\n* Haptic feedback for meaningful actions\n* Material 3 styling with semantic colors\n\n### Privacy-First\n* Local-first data handling\n* No ads, no tracking SDKs\n* Designed with Play Store policy compliance in mind\n\n---\n\n## Architecture Overview\n\nCashio follows Clean Architecture + MVVM with strict separation of concerns.\n\n```text\ndata/\n ├── local/\n ├── notification/\n ├── repository/\n └── sms/\ndomain/\n ├── model/\n ├── repository/\n └── usecase/\n     ├── base/\n     ├── category/\n     ├── expense/\n     ├── keyword/\n     └── preferences/\npresentation/\n ├── add/\n ├── analytics/\n ├── categories/\n ├── common/\n ├── history/\n ├── home/\n ├── keyword/\n ├── onboarding/\n ├── settings/\n └── transaction/\nui/\n ├── components/\n ├── defaults/\n ├── navigation/\n └── theme/\n```\n\n### Architectural Principles\n* Single source of truth via immutable UI state\n* Unidirectional data flow\n* Business logic isolated in UseCases\n* UI is fully state-driven\n\n---\n\n## Engineering Highlights\n\n### State Management\n* No UI-side sorting or filtering\n* ViewModels own all transformation logic\n* Predictable, testable state flows\n\n### Calendar Heatmap\n* Dynamic percentile-based intensity\n* Automatically adapts to individual spending habits\n* Avoids hardcoded thresholds that break across users\n\n### Performance\n* Pre-sorted day groups computed once\n* Lazy rendering only where data size demands it\n* Zero recomposition loops from derived UI logic\n\n---\n\n## Status\n\nFeature-complete core flows; polishing analytics and performance; preparing for Play Store compliance.\n\n---\n\n## Testing Strategy\n\n* ViewModel logic is isolated and testable\n* UI driven by deterministic state\n* Defensive error handling for all data flows\n\n---\n\n## Installation\n\n```bash\ngit clone https://github.com/your-username/cashio.git\n```\n\nOpen in Android Studio Hedgehog+, sync Gradle, and run on an emulator or device.\n\n---\n\n## Contributing\n\nThis project is currently maintained by a single developer. Thoughtful discussions, suggestions, and PRs are welcome.\n\n---\n\n## Vision\n\nCashio aims to be a fast, beautiful, and trustworthy personal finance companion, built with the same rigor and care as professional fintech products.\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblue-mix%2Fcashio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblue-mix%2Fcashio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblue-mix%2Fcashio/lists"}