WanderFund

A cross-platform mobile application to manage annual travel budgets, wishlists, and trip expenses.

Tech Stack

• Framework: Flutter
• State Management: GetX
• Backend: Supabase (PostgreSQL)
• UI: Material Design 3

Project Structure

lib/
├── core/           # Constants, utilities
├── data/           # Data models and repositories
│   ├── models/     # Trip, Expense, AnnualBudget
│   └── repositories/
├── logic/          # Controllers (GetX)
└── ui/             # Screens and widgets
    ├── screens/
    └── widgets/

Getting Started

Prerequisites

• Flutter 3.38.5 or higher
• Supabase account (for backend)

Setup

1. Install dependencies:

   ./_tools/flutter/bin/flutter pub get

2. Configure Supabase:

   • Create a Supabase project at https://supabase.com
   • Run the SQL schema in schema.sql (to be created)
   • Update lib/main.dart with your Supabase URL and anon key

3. Run the app:

   ./_tools/flutter/bin/flutter run

Features

Implemented

• ✅ Data models (Trip, Expense, AnnualBudget)
• ✅ Budget Repository with calculation engine
• ✅ Dashboard screen with budget overview
• ✅ Progress visualization
• ✅ Upcoming trips display

Coming Soon

• Trip management (CRUD)
• Expense logging
• Wishlist activation
• Trip detail views

Database Schema

See the project specification for the complete PostgreSQL schema.

License

Private project - All rights reserved.