{"id":26261869,"url":"https://github.com/hifza-khalid/expenselocator","last_synced_at":"2026-03-03T20:33:24.121Z","repository":{"id":281636330,"uuid":"945885772","full_name":"Hifza-Khalid/ExpenseLocator","owner":"Hifza-Khalid","description":"💰 Expense Locator (EL) is a Flutter-based expense management app that helps users track expenses, split costs, and manage financial records efficiently. It offers expense entry, list visualization, and flexible cost-sharing models for a seamless financial tracking experience. 🚀","archived":false,"fork":false,"pushed_at":"2025-03-10T10:01:42.000Z","size":4,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-16T03:54:49.766Z","etag":null,"topics":["budgeting","cost-sharing-ui","dart","expense-management","expense-tracker","finance-application","financial-planning","flutter","mobile-app","personal-finance","split-expenses"],"latest_commit_sha":null,"homepage":"https://github.com/Hifza-Khalid/ExpenseLocator","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Hifza-Khalid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-10T09:29:14.000Z","updated_at":"2025-04-13T09:48:21.000Z","dependencies_parsed_at":"2025-03-10T11:21:44.836Z","dependency_job_id":"c0428a14-a298-49a1-92aa-afba9d10f498","html_url":"https://github.com/Hifza-Khalid/ExpenseLocator","commit_stats":null,"previous_names":["hifza-khalid/expenselocator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Hifza-Khalid/ExpenseLocator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hifza-Khalid%2FExpenseLocator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hifza-Khalid%2FExpenseLocator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hifza-Khalid%2FExpenseLocator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hifza-Khalid%2FExpenseLocator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Hifza-Khalid","download_url":"https://codeload.github.com/Hifza-Khalid/ExpenseLocator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Hifza-Khalid%2FExpenseLocator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279003549,"owners_count":26083595,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["budgeting","cost-sharing-ui","dart","expense-management","expense-tracker","finance-application","financial-planning","flutter","mobile-app","personal-finance","split-expenses"],"created_at":"2025-03-14T00:16:25.014Z","updated_at":"2025-10-10T10:33:22.073Z","avatar_url":"https://github.com/Hifza-Khalid.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 💰 Expense Locator (EL) - Flutter App\n\nExpense Locator (EL) is a smart **financial management** app built with Flutter. It helps users **track expenses, split costs with friends, and visualize financial data efficiently.** Whether you're managing daily spending or splitting costs, EL ensures **seamless and structured financial tracking.**\n\n---\n\n## 🚀 Features \u0026 Functionalities\n\n### 1️⃣ **🖥 Splash Screen \u0026 Home Screen**\n✅ Displays the **Expense Locator logo** for **5 seconds** before transitioning to the home screen.  \n✅ The **Home Screen** greets the user dynamically:  \n   **\"Hello [Name], Welcome to Expense Locator!\"**  \n✅ Provides structured navigation to:\n   - ➕ **Add Expenses**\n   - 📜 **View Expense History**\n   - 👥 **Split Expenses**\n\n---\n\n### 2️⃣ **📝 Expense Entry \u0026 Data Validation**\n💡 Users can **add an expense** with the following details:\n- 📌 **Title** (TextField with rounded corners)\n- 🏷 **Category** (Dropdown: Food, Transport, Bills, Shopping, etc.)\n- 💲 **Amount** (Numeric keyboard for easy input)\n- 📆 **Date \u0026 Time** (Modern date picker)\n- 👥 **Expense Sharing** (Checkbox for splitting preferences)\n  \n✅ Upon clicking the **curved \"Save Expense\" button**, the system:\n- ✅ **Validates** input fields.\n- ✅ Displays a **confirmation toast message**.\n- ✅ Transfers data for **real-time processing**.\n\n---\n\n### 3️⃣ **📜 Expense List \u0026 Data Visualization**\n📊 Organizes and displays **expense records** efficiently using **ListView \u0026 CardView**.  \nEach entry includes:\n- **📌 Expense Title**\n- **🏷 Category**\n- **💰 Amount Spent**\n- **📅 Date \u0026 Time**\n- **👥 Split Details** (if applicable)  \n\n**✨ Enhances:**  \n✔ **Financial tracking**  \n✔ **Decision-making**  \n✔ **User experience**\n\n---\n\n### 4️⃣ **🔢 Expense Splitting \u0026 Computation Models**\nThe app supports **two cost-sharing models** for easy **financial management**:\n\n#### **🔹 Equal Split Model**\n📌 **Formula:**  \nEach User Pays = `Total Expense / 2`  \n💡 **Example:** If the total expense is **PKR 100**, each user contributes **PKR 50**.\n\n#### **🔹 Custom Percentage Split Model**\n📌 **Formula:**  \n- **User A Share** = `(User A Percentage / 100) * Total Expense`  \n- **User B Share** = `(User B Percentage / 100) * Total Expense`  \n\n💡 **Example:**  \nIf **User A contributes 70%** and **User B contributes 30%** of a **PKR 100** expense:  \n✔ **User A pays:** **PKR 70**  \n✔ **User B pays:** **PKR 30**  \n\n**✨ Supports:**  \n✔ **Fair cost distribution**  \n✔ **Flexible expense-sharing**  \n✔ **Adaptive financial planning**\n\n---\n\n## 🖥 **App Screens \u0026 Navigation**\n### 📌 **Page 1: Add New Expense**\n✅ **AppBar:** Title + Settings Icon  \n✅ **Toggle Button:** Switch between **Expense** \u0026 **Income**  \n✅ **Expense Form:**\n- 📆 **Date Selector**\n- 📜 **Dropdown (Category Selection)**\n- 🔢 **Numeric Amount Input**\n- ➕ **Expense Split Containers**  \n✅ **Buttons:** ❌ **Cancel** | ✅ **Save**  \n✅ **Bottom Navigation:** 🛎 Notifications | 💰 Income | 🏠 Home | 📋 More  \n\n### 📌 **Page 2: Expense List**\n✅ **AppBar:** Receipt Title + Settings Icon  \n✅ **Search Bar** 🔍  \n✅ **ListTile for Expense Entries** (Dynamically populated)  \n✅ **Row with Action Buttons**  \n✅ **Bottom Navigation:** 🛎 Notifications | 💰 Income | 🏠 Home | 📋 More  \n\n---\n\n## 📂 **Project File Structure**\n```\nExpenseLocator/\n│── android/\n│── ios/\n│── lib/\n│   │── models/\n│   │   ├── expense_model.dart\n│   │   ├── split_expense_model.dart\n│   │   ├── category_model.dart\n│   │── screens/\n│   │   ├── splash_screen.dart\n│   │   ├── home_screen.dart\n│   │   ├── add_expense_screen.dart\n│   │   ├── expense_list_screen.dart\n│   │   ├── split_expense_screen.dart\n│   │── widgets/\n│   │   ├── expense_card.dart\n│   │   ├── expense_form.dart\n│   │── utils/\n│   │   ├── constants.dart\n│   │   ├── helpers.dart\n│── assets/\n│── pubspec.yaml\n│── README.md\n```\n\n---\n\n## 🛠️ **Installation Guide**\n### 🔹 **Prerequisites**\n- ✅ Flutter SDK Installed\n- ✅ Dart Installed\n- ✅ Android Studio / VS Code\n- ✅ Emulator or Physical Device\n\n### 🔹 **Steps to Run the App**\n1️⃣ Clone the repository:\n   ```sh\n   git clone https://github.com/Hifza-Khalid/ExpenseLocator.git\n   cd ExpenseLocator\n   ```\n2️⃣ Install dependencies:\n   ```sh\n   flutter pub get\n   ```\n3️⃣ Run the app:\n   ```sh\n   flutter run\n   ```\n\n---\n\n## 📌 **Usage Instructions**\n- ➕ **Add Expenses** to track your spending.\n- 📜 **View \u0026 Manage** past expenses.\n- 👥 **Split Costs** efficiently using **Equal or Custom Split Model**.\n- 📊 **Visualize Expenses** for better financial tracking.\n\n---\n\n## 👥 **Contribution Guidelines**\nWe welcome contributions to improve **Expense Locator**! 🚀\n\n1️⃣ **Fork the Repository**  \n2️⃣ **Create a Feature Branch**  \n3️⃣ **Make Necessary Changes \u0026 Commit**  \n4️⃣ **Push Changes \u0026 Open a Pull Request**  \n\n📌 **Guidelines:**\n- Follow **clean coding** practices.\n- Write **meaningful commit messages**.\n- Keep UI/UX **intuitive \u0026 user-friendly**.\n\n---\n\n## 📄 **License**\nThis project is licensed under the **MIT License**.\n\n---\n\n## 📞 **Contact \u0026 Support**\nFor any queries or support, feel free to reach out:  \n📧 **Email:** hifzaofpk@.com  \n🌐 **LinkedIn:** [Your Profile](https://linkedin.com/in/yourprofile)  \n📌 **GitHub Repository:** [Expense Locator](https://github.com/Hifza-Khalid/ExpenseLocator)  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhifza-khalid%2Fexpenselocator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhifza-khalid%2Fexpenselocator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhifza-khalid%2Fexpenselocator/lists"}