Eat-n-Split is a web application built with React that helps users split bills among friends. The app allows users to add friends, input the total bill value, specify their expenses, and view the amount owed by each friend. Additionally, users can select who is paying the bill.
-Introduction
-Features
-Getting Started
-Prerequisites
-Installation
-Usage
-Contributing
-License
1.Users can Add friends and track expenses for each friend.
2.User can Input the total bill value and your individual expense to pay.
3.A Select input of who is paying the bill to calculate accurate amount.
3.Users can See how much each friend owes you or how much you owe them.
Node.js (https://nodejs.org) installed on your local machine.
Git (https://git-scm.com) installed for version control (optional).
1.Clone the repository from GitHub:
git clone https://github.com/emmanuel687/eat-n-split.git
Alternatively, you can download the repository as a ZIP file and extract it.
2.Navigate to the project directory:
cd eat-n-split
Install the required dependencies by running this command:-
npm install
3.Run the development server:
npm start
This will start the development server, and the application will be accessible at http://localhost:3000 by default.
Use the application in your browser:
-Add friends by providing their names and respective expenses.
-Input the total bill value and your expenses in the form provided.
-The application will automatically calculate the amount each friend owes you or how much you owe them.
-Select the person who is paying the bill to adjust the final amount accordingly.
-
StateManagement in React.
-
Controlled Elements in React.
-
Prop Drilling and State Lifting in React.
-
Working with Immutable Array in React.
-
Selecting Items.
-
Form inputs.
-
Conditional Rendering
If you wish to contribute to the project, feel free to fork the repository and submit a pull request. We welcome any contributions, including bug fixes, new features, and improvements.
Feel free to contact me koechemmanuel2002@gmail.com
The project is licensed under the MIT License. Feel free to use, modify, and distribute the code as per the terms of the license.