Wlet - Finance Tracker App

Wlet is a modern, minimalist finance tracking application built with Jetpack Compose. It helps users track their income and expenses with a clean interface, intuitive swipe navigation, and real-time balance updates.

✨ Features

• Interactive Dashboard & Analytics: Visualize expenses using dynamic Bubble Clusters to instantly see how funds are allocated across categories.
• Home Screen Widget (NEW): A 2x2 Glance-based widget that displays your total spending for today and provides a quick "Add" button that launches the entry panel directly.
• Multi-Currency Support: Switch between IDR, USD, EUR, JPY, and GBP. Includes a built-in safety reset to maintain data consistency when switching currencies.
• Multi-Language Support: Seamlessly switch between Bahasa Indonesia and English within the app settings.
• Modern UI Components: All interactions, including transaction entry and settings, are handled via intuitive Modal Bottom Sheets.
• Daily Transaction Grouping: View your transactions organized by date in clean, gradient-styled cards.
• Swipe Navigation: Seamlessly transition between Home, Dashboard, and Settings with horizontal swipe gestures.
• Category Management: Add or remove spending categories directly from the settings menu.
• IDR Optimization: Specifically designed with "Rp" formatting and no unnecessary decimals for Indonesian users.
• Monospaced Visuals: Uses Roboto Mono for a professional financial aesthetic and custom-designed iconography.

🛠️ Tech Stack

• UI: Jetpack Compose (Material 3)
• Widget: Jetpack Glance (App Widgets)
• Architecture: MVVM (Model-View-ViewModel) + Repository Pattern
• Database: Room Persistence Library
• Navigation: Horizontal Pager + Navigation Compose
• Dependency Management: Gradle Version Catalog (libs.versions.toml)
• Code Generation: KSP (Kotlin Symbol Processing)

🚀 Getting Started

Installation via GitHub Release

1. Go to the Releases page.
2. Download the latest .apk file.
3. Open the APK on your Android device (ensure "Install from Unknown Sources" is enabled).
4. Launch Wlet and start tracking!

Building from Source

1. Clone the repository:

   git clone https://github.com/imkisi/wlet.git

2. Open the project in Android Studio Ladybug (or newer).
3. Sync project with Gradle files.
4. Run the app on an emulator or physical device (API 24+).

📸 Screenshots

📂 Project Structure

• data/: Room database, entities, and SettingsManager for preferences.
• repository/: Single source of truth for data operations.
• ui/:
  • home/: Monthly transaction list and balance cards.
  • dashboard/: Bubble cluster visualization and spending recaps.
  • settings/: App preferences, language, and currency controls.
  • widget/: Glance-based Home Screen widget implementation.
  • theme/: Material 3 theme, Roboto Mono typography, and global gradients.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Built with ❤️ using Jetpack Compose and Glance.