midwayne/popbill

PopBill

PopBill is a Flutter application designed to help users manage and track both group and individual expenses. It allows users to create and view individual and group expenses, monitor individual contributions, and analyse shared costs.

Features

• Record both group and individual expenses with details such as title, total amount, and items.
• Create and manage groups with unique names.
• Add group members with personalised nicknames.
• Assign users who paid the bill for each expense.
• Track individual shares for each item within a group expense.
• View detailed reports, including total shares for each user and expense date.

Screenshots

Include screenshots or GIFs showcasing the main features of your app. You can create a separate folder for images and reference them in your README.

Getting Started

To run this project locally, follow these steps:

1. Clone the repository:

   git clone https://github.com/Midwayne/popbill.git

2. Navigate to the project repository

   cd popbill

3. Install dependencies

   flutter pub get

4. Create a firebase project and set up API keys in firebase_options.dart

5. Run the app

   flutter run

Contributing

Contributions are welcome! If you have any suggestions or find a bug, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.