https://github.com/mahmoudsaeedua74/fairsplit

A simple React app using useState and Context API to manage and track payment contributions for a shared bill
https://github.com/mahmoudsaeedua74/fairsplit

context context-api context-api-react contextapi html-css-javascript javascript react react-hooks reactjs usestate-hook

Last synced: 19 days ago
JSON representation

A simple React app using useState and Context API to manage and track payment contributions for a shared bill

• Host: GitHub
• URL: https://github.com/mahmoudsaeedua74/fairsplit
• Owner: mahmoudsaeedua74
• Created: 2024-12-06T03:17:35.000Z (28 days ago)
• Default Branch: main
• Last Pushed: 2024-12-06T03:19:06.000Z (28 days ago)
• Last Synced: 2024-12-06T04:23:47.123Z (28 days ago)
• Topics: context, context-api, context-api-react, contextapi, html-css-javascript, javascript, react, react-hooks, reactjs, usestate-hook
• Language: JavaScript
• Homepage: https://fair-split-xi.vercel.app
• Size: 42 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# FairSplit - Bill Payment Tracker

**FairSplit** is a simple app built as part of my practice with React. It allows users to track the payment status of a shared bill, determining who has paid, how much they've paid, and who still needs to contribute. This app helps in splitting expenses between friends or group members in a fair way.

## Key Features

- Input the total bill value and track how much each person has contributed.

- Automatically calculates how much each person owes or is owed based on their contributions.

- Provides a clear view of who needs to pay and who has already paid.

## Technologies Used

- **React**: Used for building the user interface and managing the app's components.

- **useState**: A React Hook used to manage the state within the app.

- **Context API**: Used for managing global state across the app without the need to prop-drill.

## App Workflow

1. **Enter the total bill amount**.

2. **Record your contribution**.

3. **Track the remaining amount** that your friend owes or has paid.

4. **View the final breakdown** of who owes what.

## Installation

To get started with the project, follow these steps:

1. Clone the repository to your local machine:

   ```bash

   git clone https://github.com/yourusername/FairSplit.git