README.md

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.

1. How much money do I have in total?

2. How much did I spend this month and what did I spend it on?

3. 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.

• GitHub URL
• Web app URL