README.md

Ivy Wallet: money manager

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" by the YouTube tech community.

Join our private Telegram Community.

To support our free open-source project please give it a star. ⭐ That means a lot for us. Thank you!

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.

2. Make the initialization script executable:

chmod +x scripts/init.sh

3. Initialize the project:

./scripts/init.sh

Need help?

Jour 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're also linking great learning materials (books, articles, videos), check them in docs/resources 📚.

Make sure to also check our short Architecture Guidelines 🏗️ to learn more about the Ivy Wallet's tech side.

Tech Stack

Core

• 100% Kotlin
• 100% Jetpack Compose
• Material3 design (UI components)
• Kotlin Coroutines (structured concurrency)
• Kotlin Flow (reactive datastream)
• Hilt (DI)
• ArrowKt (functional programming)
• Kotest (unit testing)

Local Persistence

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

Networking

• Ktor Client (REST client)
• Kotlinx Serialization (JSON serialization)

Build & CI

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

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 24h for the contrib.rocks 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:

Stefan Ilijev
Ivy Wallet's co-founder and designer. Created the Ivy Wallet design.

Aditya

Shymom