Skip to content

Repository files navigation

💰 Flatmates Expense Tracker

What is this app?

Flatmates Expense Tracker is a mobile app that helps you and your friends, roommates, or family members keep track of shared expenses and who owes whom money. Think of it as your personal accountant for group spending!

The Problem It Solves

Ever been in these situations?

  • 🍕 You paid for pizza, but your roommate forgot to pay you back
  • 🏠 You split rent with 3 people and can't remember who paid what
  • ✈️ You went on a trip with friends and everyone paid for different things
  • 🛒 You bought groceries for the house but need to split the cost

This app keeps track of all these expenses automatically and tells you exactly who owes whom and how much!


How Does It Work?

🎯 Simple Concept

  1. Create a Group - Add your roommates, friends, or family members
  2. Add Expenses - Whenever someone pays for something shared, add it to the app
  3. Split Automatically - The app calculates who owes what
  4. Settle Up - When someone pays you back, record it and the app updates the balances

📱 Main Features

1. Groups

  • Create different groups (e.g., "Apartment Roommates", "Vacation Friends", "Family")
  • Add members to each group
  • Each group has its own expense tracking

2. Expenses

  • Add an Expense: Record who paid, how much, and what it was for
  • Split Options:
    • Split equally among everyone
    • Split by custom amounts (e.g., one person ate more)
    • Split by percentages
  • Attach Receipts: Take a photo of the receipt so you remember what it was for
  • Categories: Tag expenses (Food, Rent, Utilities, Entertainment, etc.)

3. Personal Finance

  • Track your own personal expenses (not shared with anyone)
  • See where your money is going
  • Manage your personal budget

4. Smart Balances

The app automatically calculates:

  • Who owes you money (shown in green ✅)
  • Who you owe money to (shown in red ❌)
  • Net balance for each person

Example:

You paid $60 for dinner with 2 friends
→ Each person owes you $20
→ App shows: "John owes you $20" and "Sarah owes you $20"

5. Settlement Tracking

  • When someone pays you back, record it as a "Settlement"
  • The app automatically updates everyone's balances
  • See history of all payments

6. Notifications

  • Get notified when someone adds an expense that involves you
  • Get reminders about pending payments
  • Stay updated on group activities

7. Offline Mode

  • Works even without internet!
  • Records expenses offline
  • Syncs automatically when you're back online

8. Chat & Messages

  • Discuss expenses with group members
  • Send payment reminders
  • Keep all money conversations in one place

9. Payment Methods

  • Save your payment details (UPI, Bank Account, PayPal, etc.)
  • Share payment info with group members for easy settlements

🚀 Real-World Example

Scenario: You share an apartment with 2 roommates

Month of January:

  1. Jan 5: You paid $900 for rent

    • Split 3 ways = $300 each
    • App shows: "Alice owes you $300" and "Bob owes you $300"
  2. Jan 10: Alice bought groceries for $60

    • Split 3 ways = $20 each
    • App updates: "Alice owes you $280" (300 - 20)
  3. Jan 15: Bob paid the electricity bill for $90

    • Split 3 ways = $30 each
    • App updates: "Bob owes you $270" (300 - 30)
  4. Jan 20: Alice paid you back $280

    • Record settlement
    • App updates: "Alice owes you $0" ✅
  5. Jan 31: View summary

    • Bob still owes you $270
    • You owe Alice $0
    • Total you're owed: $270

🎨 Key Screens

📊 Dashboard

Your home screen showing:

  • Total amount you're owed
  • Total amount you owe
  • Recent expenses
  • Quick actions

👥 Groups

  • See all your groups
  • View balances for each group
  • Add new groups

💸 Expenses

  • List of all expenses
  • Filter by group, date, or category
  • Add new expenses quickly

👤 Profile

  • Your account settings
  • Payment methods
  • Notification preferences

🔔 Notifications

  • Activity updates
  • Payment reminders
  • New expense alerts

🔐 Security & Privacy

  • Secure Login: Your data is protected with email/password authentication
  • Cloud Backup: All data is safely stored in the cloud (Supabase)
  • Private Groups: Only group members can see group expenses
  • Data Sync: Your data syncs across all your devices

📲 How to Get Started

  1. Sign Up: Create an account with your email
  2. Create Your First Group: Add your roommates or friends
  3. Add an Expense: Record your first shared expense
  4. Invite Members: Send invitations to group members
  5. Start Tracking: The app handles the rest!

🎯 Who Is This For?

Roommates sharing rent and utilities
Friends going on trips together
Couples managing shared expenses
Families tracking household costs
Groups organizing events or parties
Anyone who splits bills with others


💡 Why Use This App?

Benefits

  • No More Awkward Conversations: The app tells you exactly who owes what
  • Save Time: No more manual calculations or spreadsheets
  • Avoid Conflicts: Clear, transparent record of all expenses
  • Never Forget: All expenses are recorded with dates and receipts
  • Fair Splitting: Ensures everyone pays their fair share
  • Peace of Mind: Know your money situation at a glance

🛠️ Technical Details (For Developers)

  • Platform: React Native (works on iOS and Android)
  • Backend: Supabase (Database + Authentication)
  • Offline Support: Local storage with automatic sync
  • Notifications: Push notifications for updates
  • Image Storage: Cloud storage for receipt photos

📞 Need Help?

If you have questions or run into issues:

  1. Check the /Guide folder for detailed documentation
  2. Review the feature guides for specific functionality
  3. Contact the development team

🎉 Start Tracking Your Expenses Today!

No more confusion about who owes what. Download the app and take control of your shared expenses!


Version: 1.0.0
Last Updated: January 2026

About

Flatmates Expense Tracker is a mobile app that helps you and your friends, roommates, or family members keep track of shared expenses and who owes whom money. Think of it as your personal accountant for group spending!

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages