BudgetApp

A native Android budgeting application built using Kotlin, Jetpack Compose, and Material Design 3.

Designed to provide efficient personal financial management, the application allows users to track financial inflows and outflows, manage subscriptions, monitor savings, and log investments through a clean, adaptive interface.

Features

Comprehensive Financial Dashboard

• Real-time balance calculations including total inflow, outflow, and net balance.
• Graphical progress indicators showing the monthly savings rate.
• Categorized breakdown of expenses using clean progress indicators.

Income Management

• Support for logging and editing multiple distinct income sources and corresponding amounts.

Expense Tracking

• Dropdown category filter to switch between expense lists.
• Unified tracking for:
  • Fixed Expenses (Rent, utilities, bills)
  • Subscriptions (Recurring memberships, services)
  • Groceries (Everyday food purchases)
  • Entertainment (Leisure, games, dining out)

Savings and Investments

• Dedicated panels to manage savings and investment balances.
• Slider-based adjustments for quick financial updates.

Localization and Preferences

• Multi-language support (English and French), dynamically toggled.
• English configured as the default language.
• Free text input for currency symbols, supporting any global symbol or ISO code.

Data Portability (JSON Import/Export)

• Single-click export of application state to clipboard or share sheet as a JSON string.
• Import capability to instantly restore application state from a JSON backup.

---

Technical Architecture and Stack

• Language: Kotlin 1.9.22
• UI Framework: Jetpack Compose (Material 3)
• State Management: Single Activity architecture with central state persistence.
• Data Persistence: SharedPreferences and Gson serialization.
• Build System: Gradle Version Catalog (libs.versions.toml) for dependency alignment.
• Assets: Adaptive vector launcher icon.

---

Getting Started

Prerequisites

• Android Studio Koala or newer.
• Android SDK (API Level 26 or higher).
• JDK 17.

Option 1: Build and Run via Android Studio

1. Clone the repository:

   git clone https://github.com/ArthurAugis/budgetapp

2. Open Android Studio, select Open, and navigate to the project directory.
3. Allow Gradle to sync and build the project.
4. Run the application on an emulator or a connected physical device.

Option 2: Build APK via Command Line

Using the Gradle Wrapper, compile the debug APK by running:

./gradlew assembleDebug

The compiled APK will be generated at the following path:
app/build/outputs/apk/debug/app-debug.apk