BudgetBuddy Frontend

Overview

BudgetBuddy Frontend is a modern mobile/web app built with Flutter. It provides a beautiful, interactive interface for users to manage their finances, set savings goals, learn financial concepts, and interact with an AI-powered chatbot.

Features

• User authentication (Firebase)
• Dashboard with balance and goal tracking
• Add, update, and delete savings goals
• Educational lessons and stories
• AI chatbot for financial questions
• Responsive design for mobile and web
• Dark mode and notification settings

Project Structure

budgetbuddy/
  lib/
    main.dart            # App entrypoint
    screens/             # UI screens (home, onboarding, lessons, etc.)
    providers/           # State management (Provider)
    widgets/             # Reusable UI components
    constants/           # App-wide constants
    colorscheme.dart     # Theming
    ...
  pubspec.yaml           # Flutter dependencies

Setup Instructions

1. Clone the repository:

   git clone <repo-url>
   cd HackathonFrontend/budgetbuddy

2. Install Flutter dependencies:

   flutter pub get

3. Set up environment variables:
   • Configure Firebase using firebase_options.dart (auto-generated by FlutterFire CLI).
   • Add any API base URLs or keys to lib/constants/app_constants.dart.

Running the App

• Mobile (iOS/Android):

  flutter run

• Web:

  flutter run -d chrome

Main Dependencies

• Flutter
• Provider (state management)
• Dio (networking)
• Firebase Auth/Core
• cupertino_icons

Development Notes

• Use Provider for all app state.
• API endpoints are configured in lib/constants/app_constants.dart.
• The app is designed for both mobile and web platforms.
• For custom theming, edit lib/colorscheme.dart.
• To add new features, create a new screen in lib/screens/ and connect it via navigation.

---

For questions or contributions, please open an issue or pull request.