https://github.com/kevinguitar/budgetplus
Budget+ is a co-spending tracker, available on Android and iOS. Built by KMP and CMP.
https://github.com/kevinguitar/budgetplus
admob compose-multiplatform firebase kotlin-multiplatform metro mobile-app
Last synced: 2 months ago
JSON representation
Budget+ is a co-spending tracker, available on Android and iOS. Built by KMP and CMP.
- Host: GitHub
- URL: https://github.com/kevinguitar/budgetplus
- Owner: kevinguitar
- License: apache-2.0
- Created: 2022-07-25T06:01:04.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2026-03-29T07:21:58.000Z (3 months ago)
- Last Synced: 2026-03-29T08:27:41.448Z (3 months ago)
- Topics: admob, compose-multiplatform, firebase, kotlin-multiplatform, metro, mobile-app
- Language: Kotlin
- Homepage: https://budgetplus.cchi.tw/get-app
- Size: 8.44 MB
- Stars: 18
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Budget+ Multiplatform App（極簡記帳）
[](https://github.com/kevinguitar/budgetplus/actions/workflows/android-ci.yml)
[](https://github.com/kevinguitar/budgetplus/actions/workflows/ios-ci.yml)
[](https://www.apache.org/licenses/LICENSE-2.0)
Budget+ is an easy-to-use co-spending tracker to track expenses together with your friends and family.
### Now available on both Android and iOS!
[](https://play.google.com/store/apps/details?id=com.kevlina.budgetplus)
[](https://apps.apple.com/app/id6759791430)
## Feature Overview
### Some cool animated features!! ✨
| Pie Chart | Color Tone Picker | Customize Color Tone |
|:--------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------:|:--------------------------------------------------------------------------------------------------------------------:|
| | | |
---
## Tech Stack
### Business Logic and Core
- [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html) for shared logic across Android and iOS
- [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/) for shared UI + MVVM Architecture
- [Coroutines](https://kotlinlang.org/docs/coroutines-overview.html) & [Flow](https://kotlinlang.org/docs/flow.html) for asynchronous operations
- [Metro](https://zacsweers.github.io/metro/latest/) for dependency injection
- [Navigation3](https://developer.android.com/guide/navigation/navigation-3) for Composable navigation
- [DataStore](https://developer.android.com/topic/libraries/architecture/datastore) for persistent data storage
- [RevenueCat](https://github.com/RevenueCat/purchases-kmp) for in-app purchases and subscriptions
- [AdMob](https://admob.google.com/home/) with Meta Audience Network mediation for ads
- [Kotlinx Serialization](https://github.com/Kotlin/kotlinx.serialization) for JSON parsing
- [Kotlinx Datetime](https://github.com/Kotlin/kotlinx-datetime) for date and time handling
- [Firebase](https://firebase.google.com/)
- [Firestore](https://firebase.google.com/docs/firestore) for real-time database
- [Authentication](https://firebase.google.com/docs/auth) for Google and Apple ID sign-in
- [Crashlytics](https://firebase.google.com/docs/crashlytics) for crash reporting
- [Analytics](https://firebase.google.com/docs/analytics), [Messaging](https://firebase.google.com/docs/cloud-messaging), and [Remote Config](https://firebase.google.com/docs/remote-config)
### Open-Source Libraries for KMP
- [Coil3](https://github.com/coil-kt/coil) for image loading with KMP support
- [Colorpicker-compose](https://github.com/skydoves/colorpicker-compose) for color picking
- [Compottie](https://github.com/alexzhirkevich/compottie) for Lottie animations in Compose Multiplatform
- [CrashKiOS](https://github.com/touchlab/CrashKiOS) for better crash reporting on iOS
- [Csv](https://github.com/sergejsha/csv) for exporting data as CSV (KMP)
- [Detekt](https://github.com/detekt/detekt) for Kotlin static code analysis
- [Firebase Kotlin SDK](https://github.com/GitLiveApp/firebase-kotlin-sdk) for KMP support
- [Kermit](https://github.com/touchlab/Kermit) for logging
- [Keval](https://github.com/notKamui/Keval) for mathematical expression evaluation
- [MockK](https://github.com/mockk/mockk) for mocking classes in unit tests
- [Moko-permissions](https://github.com/icerockdev/moko-permissions) for KMP permission handling
- [Reorderable](https://github.com/Calvin-LL/Reorderable) for reordering items in Compose
### Android Specific
- [In-App Review](https://developer.android.com/guide/playcore/in-app-review) and [In-App Update](https://developer.android.com/guide/playcore/in-app-updates) integration
- [Baseline Profile](https://developer.android.com/topic/performance/baselineprofiles/overview) for improving app startup time
---
## Supported Deeplinks
- Home screen: https://budgetplus.cchi.tw/record
- Overview: https://budgetplus.cchi.tw/overview
- Unlock premium: https://budgetplus.cchi.tw/unlockPremium
- Settings: https://budgetplus.cchi.tw/settings
- Settings with members dialog: https://budgetplus.cchi.tw/settings?showMembers=true
- Sharing customized color tones: https://budgetplus.cchi.tw/colors?hex=cff1ff%3bdaf2cb%3b84c18f%3b596980
---
## Performance Optimization (Baseline Profile)
The project uses [Baseline Profiles](https://developer.android.com/topic/performance/baselineprofiles/overview) to improve startup performance.
### Generating a Profile
To run the generator:
```bash
./gradlew :benchmark:connectedReleaseAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=BaselineProfile
```
The output can be found in: `benchmark/build/outputs/connected_android_test_additional_output/release/connected/[device]`.
Copy and rename the file to `baseline-prof.txt` and place it in the `src/main` directory of the app module.
### Running Macrobenchmarks
```bash
./gradlew :benchmark:connectedReleaseAndroidTest -P android.testInstrumentationRunnerArguments.androidx.benchmark.enabledRules=Macrobenchmark
```
---
## Backend: Firebase Cloud Functions
Database interactions and push notifications are implemented using [Firebase Cloud Functions](https://firebase.google.com/docs/functions).
The backend repository is also open-sourced: [budgetplus-cloud-functions](https://github.com/kevinguitar/budgetplus-cloud-functions)
---
License
-------
Copyright (c) 2024 Kevin Chiu
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.