Skip to content

Repository files navigation

Financial Navigation App 🚀

Overview

The Financial Navigation App is a personal finance and budgeting application designed to make money management engaging and rewarding. Instead of simply tracking expenses, the app turns financial growth into a journey, helping users build healthy financial habits while progressing through different financial milestones.

Whether you're just starting your financial journey or working toward long-term wealth creation, the app provides the tools you need to track spending, set goals, and monitor your progress in a fun and interactive way.


Features

🌟 Interactive Financial Journey

Follow your financial growth on a visually engaging S-curve journey map built with Jetpack Compose. Progress through different stages, from Financial Novice to Generational Wealth Builder, as you improve your financial habits.

🎮 Gamified XP System

Managing your finances becomes more rewarding with an experience points (XP) system. Earn XP by maintaining positive financial behaviors, reaching goals and staying consistent with your budgeting efforts.

💰 Budget Management

Create and manage personalized budget goals to keep your spending under control and stay focused on your financial objectives.

📝 Expense Tracking

Quickly record daily expenses and categorize them to gain a clearer understanding of your spending patterns.

📊 Financial Insights & Reports

View charts and financial summaries that help you identify trends, monitor progress and make informed financial decisions.

☁️ Cloud Synchronization

Your financial progress and XP are securely synchronized using Firebase Cloud Firestore, allowing your data to remain up to date across sessions.

🧭 Easy Navigation

The app features a modern user interface with a Material Design 3 Bottom Navigation Bar and Navigation Drawer, making it simple to access budgets, expenses, reports, profile settings and more.


Technology Stack

Development

  • Language: Kotlin
  • Platform: Android

User Interface

  • Jetpack Compose for modern and interactive UI components
  • XML Layouts for traditional Android screens
  • Material Design 3 for a clean and consistent user experience

Data & Storage

  • Firebase Cloud Firestore for cloud data synchronization
  • SQLite Database (via DatabaseHelper) for local data storage
  • SharedPreferences for session and user preference management

Libraries & Tools

  • MPAndroidChart for financial charts and data visualization
  • Firebase BOM for Firebase dependency management
  • Material Icons Extended for enhanced UI icon support

Getting Started

Prerequisites

Before running the project, ensure you have the following installed:

  • Android Studio Ladybug (or newer)
  • Android SDK 24+ (Android 7.0 Nougat or higher)
  • A configured Firebase project
  • An Android device or emulator

Installation

  1. Clone the repository:
git clone https://github.com/your-username/financial-navigation-app.git
  1. Open the project in Android Studio.

  2. Connect the project to your Firebase account:

    • Create a Firebase project.
    • Add an Android application to the project.
    • Download the google-services.json file.
    • Place the file inside the app module directory.
  3. Sync Gradle dependencies.

  4. Build and run the application on an Android device or emulator.


Future Improvements

Some planned enhancements include:

  • User authentication with Firebase Authentication
  • Dark mode support
  • Recurring expense tracking
  • Savings goal recommendations
  • Achievement badges and rewards
  • Data export functionality (PDF/Excel)

Contributing

Contributions, suggestions and improvements are welcome. Feel free to fork the repository, create a feature branch, and submit a pull request.


License

This project is intended for educational and personal portfolio purposes. Please refer to the repository license for usage details.


Author

  • Masole Keabetswe - Project Manager
  • Matlhaga Amogelang - Lead Dev
  • Mathe Lesego - Sacretary

About

PennyWise is a professional-grade Android application designed to help users take full contril of their financial lives.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages