Important

🚨 Notice: Project No Longer Maintained 🚨

As of Nov 5th, 2024, this project is no longer maintained by the original developers. No further updates, bug fixes, or support will be provided.

Pull Requests and Issues: We will not be reviewing or merging pull requests, nor responding to issues or discussions.
Forking and Future Development: In accordance with the GPL-3.0 License, you are encouraged to fork this repository to continue development independently. You are free to modify, distribute, and release your own versions under the same license.
Disclaimer of Liability:
"As-Is" Basis: This software is provided on an "as-is" basis without any warranties or conditions of any kind, either express or implied.
No Liability: The original maintainers shall not be liable for any claims, damages, or other liabilities arising from the use, modification, or distribution of this software.
User Responsibility: Users and developers who choose to use or fork this project assume all risks and responsibilities associated with its use and further development.

For more information, please refer to the LICENSE file.

Ivy Wallet: money manager

Ivy Wallet is a free and open source money management android app. It's written using 100% Kotlin and Jetpack Compose. It's designed to help you keep track of your personal finances with ease.

Think of Ivy Wallet as a manual expense tracker that tries to replace the good old spreadsheet for managing your finances.

Do you know? Ask yourself.

How much money do I have in total?
How much did I spend this month and what did I spend it on?
How much can I spend and still meet my financial goals?

A money management app can help you answer these questions.

Ivy Wallet may lack some of the features you're looking for, but it truly shines in its user interface and experience, as well as its simplicity and customization options. This was recognized in the "Top/Best Android App in 2021/2022 charts" by the YouTube tech community.

Join our private Telegram Community.

To support our free open source project, please give it a star. ⭐ This means a lot to us. Thank you so much!

Project Requirements

Java 17+
The latest stable Android Studio (for easy install use JetBrains Toolbox)

Initialize the project

1. Fork and clone the repo

Instructions in CONTRIBUTING.md.

Need help?

Join our Telegram community and drop a message in the "Development" topic.

Learning Materials

Ivy Wallet is a great place to code and learn. That's why we also link to great learning materials (books, articles, videos), check them out in docs/resources 📚.

Make sure to check out our short Developer Guidelines 🏗️ to learn more about the technical side of the Ivy Wallet.

Tech Stack

Core

100% Kotlin
100% Jetpack Compose
Material3 design (UI components)
Kotlin Coroutines (structured concurrency)
Kotlin Flow (reactive data stream)
Hilt (DI)
ArrowKt (functional programming)

Testing

JUnit4 (test framework, compatible with Android)
Kotest (unit test assertions)
Paparazzi (screenshot testing)

Local Persistence

DataStore (key-value storage)
Room DB (SQLite ORM)

Networking

Ktor client (HTTP client)
Kotlinx Serialization (JSON serialization)

Build & CI

Gradle KTS (Kotlin DSL)
Gradle convention plugins (build logic)
Gradle version catalogs (dependencies versions)
GitHub Actions (CI/CD)
Fastlane (uploads the app to the Google Play Store)

Other

Firebase Crashlytics (stability monitoring)
Timber (logging)
Detekt (linter)
Ktlint (linter)
Slack's compose-lints (linter)

Contribute

Want to contribute? See CONTRIBUTING.md

Contributors Wall:

Note: It may take up to 24 hours for the contrib.rocks plugin to update.

P.S. You'll also be recognized in a special "Contributors" section. We salute you! 👏

Creative Contributors

Folks that helped Ivy Wallet in a non-dev creative ways that can't be captured on GitHub.

Creative Contributors Wall:

Stefan Ilijev
Co-founder and designer of Ivy Wallet. Created the Ivy design system.

Aditya

Shymom

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 by Pratik Kabade

This community-developed project allows users to conveniently access Ivy Wallet through their web browsers, ensuring a smooth experience across multiple platforms.

bojackhorseman0309 / ivy-wallet