Eat and Split is a clean, interactive React app designed to help users fairly and quickly split shared bills with a friend. Whether you’re dining out, traveling, or just sharing everyday expenses, this app helps track who owes what with a few simple inputs.
The inspiration behind this project was to build something practical and immediately useful while deepening my understanding of modern React concepts. I wanted to challenge myself with building a responsive UI and managing shared state between components effectively.
I built Eat and Split to solidify my React knowledge beyond the basics. It was important to work on a project that mimicked real-world logic and user interactions—such as form validation, controlled components, and conditional rendering—while keeping the code modular and clean.
Splitting a bill can often be a confusing or awkward process. This app removes the hassle by clearly calculating who owes whom based on user input:
- Who paid
- How much was the total bill
- Each person’s share
It ensures that overpayments are not allowed and keeps the UX friendly and transparent.
Through this project, I learned how to:
- Manage form inputs using controlled components
- Lift state up to share data across components
- Perform input validation and dynamic calculations
- Design reusable components
- Handle conditional UI logic
- Apply best practices for file structure, readability, and reusability
It was also a great exercise in UI/UX thinking—creating a layout that is easy to use and communicates its purpose clearly to the user.
- Clone the repository:
git clone https://github.com/ikaera/eat_and_split.git
- Navigate into the project directory:
cd eat_and_split - Install the dependencies:
npm install
- Start the development server:
npm start
Split expenses between yourself and a friend:
- Enter the total bill value
- Enter how much you paid
- Select who paid the bill
- Submit the form to calculate who owes what
This project was created by help of:
The Ultimate React Course 2025: React, Next.js, Redux & More
- Master modern React from beginner to advanced! Next.js, Context API, React Query, Redux, Tailwind, advanced patterns
- Created by [Jonas Schmedtmann]
This project is licensed under the MIT License.
See the License Text section below for full details.
MIT License
Copyright (c) 2025 Irakli Eradze
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
- Dynamic calculation of expenses
- Clean, minimal UI
- React best practices (controlled components, lifted state)
If you'd like to contribute:
- Fork the repo
- Create a new branch (
git checkout -b feature-xyz) - Commit your changes (
git commit -m 'Add feature xyz') - Push to the branch (
git push origin feature-xyz) - Open a pull request
Currently no tests are included, but testing can be added using:
- React Testing Library
- Jest
Stay tuned for future testing features!
This project was bootstrapped with Create React App.
In the project directory, you can run:
Runs the app in the development mode.
Open http://localhost:3000 to view it in your browser.
The page will reload when you make changes.
You may also see any lint errors in the console.
Launches the test runner in the interactive watch mode.
See the section about running tests for more information.
Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
See the section about deployment for more information.
Note: this is a one-way operation. Once you eject, you can't go back!
If you aren't satisfied with the build tool and configuration choices, you can eject at any time. This command will remove the single build dependency from your project.
Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except eject will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.
You don't have to ever use eject. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.
You can learn more in the Create React App documentation.
To learn React, check out the React documentation.
This section has moved here: https://facebook.github.io/create-react-app/docs/code-splitting
This section has moved here: https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size
This section has moved here: https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app
This section has moved here: https://facebook.github.io/create-react-app/docs/advanced-configuration
This section has moved here: https://facebook.github.io/create-react-app/docs/deployment
This section has moved here: https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify