[](https://github.com/Ivy-Apps/ivy-wallet/releases)
[](https://github.com/Ivy-Apps/ivy-wallet/actions/workflows/apk.yml)
[](https://t.me/+ETavgioAvWg4NThk)
[](https://www.gnu.org/licenses/gpl-3.0)
[](https://github.com/Ivy-Apps/ivy-wallet/blob/main/CONTRIBUTING.md)
[](https://github.com/Ivy-Apps/ivy-wallet/stargazers)
[](https://github.com/Ivy-Apps/ivy-wallet/fork)
# [Ivy Wallet: money manager](https://play.google.com/store/apps/details?id=com.ivy.wallet)
| | | | |
| :---: | :----: | :---: | :---: |
|  |  |  | 
|  |  | | 
Ivy Wallet is a free and open-source **money manager android app**. It's written using **100% Kotlin and Jetpack Compose**. It's designed to help you track your personal finance with ease.
Imagine Ivy Wallet as a manual expense tracker that tries to replace the good old spreadsheet for managing your finance.
**Do you know? Ask yourself.**
1) How much money do I have in total?
2) How much did I spend this month and where?
3) How much money can I spend and still reach my financial goals?
A money manager app can help you answer these questions.
Ivy Wallet lacks features but its biggest advantage is its UI/UX, simplicity, and customization. This was recognized in the ["Top/Best Android App in 2021/2022 charts"](https://youtube.com/playlist?list=PLguJN0waG1-eSzKMuFMIULrR3MlqJ3cAE) by the YouTube tech community.
> Join our **[private Telegram Community](https://t.me/+ETavgioAvWg4NThk)**.
> To support our free open-source project please give it a star. ⭐
> That means a lot for us. Thank you! [](https://github.com/Ivy-Apps/ivy-wallet/stargazers)
## Project Requirements
- Java 17+
- The **latest stable** Android Studio (for easy install use [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app/))
### Initialize the project
**1. Fork and clone the repo**
Instructions in [CONTRIBUTING.md](./CONTRIBUTING.md).
### Need help?
Join our Telegram community and drop a message in the "Development" topic.
[](https://t.me/+ETavgioAvWg4NThk)
## Learning Materials
Ivy Wallet is a great place to code and learn. That's why we're also linking great learning materials (books, articles, videos), check them in **[docs/resources 📚](docs/resources/)**.
Make sure to also check our short **[Architecture Guidelines 🏗️](docs/Architecture.md)** to learn more about the Ivy Wallet's tech side.
[](https://github.com/Ivy-Apps/ivy-wallet/blob/main/CONTRIBUTING.md)
## Tech Stack
### Core
- 100% [Kotlin](https://kotlinlang.org/)
- 100% [Jetpack Compose](https://developer.android.com/jetpack/compose)
- [Material3 design](https://m3.material.io/) (UI components)
- [Kotlin Coroutines](https://kotlinlang.org/docs/coroutines-overview.html) (structured concurrency)
- [Kotlin Flow](https://kotlinlang.org/docs/flow.html) (reactive datastream)
- [Hilt](https://dagger.dev/hilt/) (DI)
- [ArrowKt](https://arrow-kt.io/) (functional programming)
- [Kotest](https://kotest.io/) (unit testing)
### Local Persistence
- [DataStore](https://developer.android.com/topic/libraries/architecture/datastore) (key-value storage)
- [Room DB](https://developer.android.com/training/data-storage/room) (SQLite ORM)
### Networking
- [Ktor Client](https://ktor.io/docs/getting-started-ktor-client.html) (REST client)
- [Kotlinx Serialization](https://github.com/Kotlin/kotlinx.serialization) (JSON serialization)
### Build & CI
- [Gradle KTS](https://docs.gradle.org/current/userguide/kotlin_dsl.html) (Kotlin DSL)
- [Gradle convention plugins](https://docs.gradle.org/current/samples/sample_convention_plugins.html) (build logic)
- [Gradle version catalogs](https://developer.android.com/build/migrate-to-catalogs) (dependencies versions)
- [Fastlane](https://fastlane.tools/) (uploads the app to the Google PlayStore)
- [Github Actions](https://github.com/Ivy-Apps/ivy-wallet/actions) (CI/CD)
### Other
- [Firebase Crashlytics](https://firebase.google.com/products/crashlytics) (stability monitoring)
- [Timber](https://github.com/JakeWharton/timber) (logging)
- [Detekt](https://github.com/detekt/detekt) (linter)
- [Ktlint](https://github.com/pinterest/ktlint) (linter)
- [Slack's compose-lints](https://slackhq.github.io/compose-lints/) (linter)
## Contribute
**Want to contribute?** See **[CONTRIBUTING.md](/CONTRIBUTING.md)** [](https://github.com/Ivy-Apps/ivy-wallet/fork)
### Contributors Wall:
_Note: It may take up to 24h for the [contrib.rocks](https://contrib.rocks/preview?repo=Ivy-Apps%2Fivy-wallet) plugin to update because it's refreshed once a day._
**P.S.** You'll also be recognized in Ivy Wallet's "Contributors" screen that can be found in the android app. We salute you! 👏
## Creative Contributors
Folks that helped Ivy Wallet in a non-dev creative way that can't be captured in GitHub.
### Creative Contributors Wall:
## Community Projects
> ⚠️ Disclaimer: The community projects listed are independently developed and not affiliated with Ivy Apps Ltd. Consequently, we cannot vouch for their functionality, security or intentions. Your engagement with these projects is solely at your own discretion and risk. Ivy Apps Ltd explicitly disclaims any warranties, express or implied, and shall not be held liable for any damages or losses resulting from the use of these community-developed projects.
### [ivy-wallet-web](https://github.com/pratikkabade/ivy-wallet-web) by [Pratik Kabade](https://github.com/pratikkabade)
This project, developed by the community, enables users to conveniently access **Ivy Wallet** through their **web browsers**, ensuring a smooth experience across various platforms.
- [GitHub URL](https://github.com/pratikkabade/ivy-wallet-web)
- [Web app URL](https://ivy-wallet-web.vercel.app/)
![Aditya [ADX]](https://avatars.githubusercontent.com/u/86833171?v=4)
![Shymom [SSI]](https://avatars.githubusercontent.com/u/130169485?v=4)