https://github.com/shadinkappachali/bill-share
A simple React app to manage shared expenses with friends. Add friends, select a friend, and split bills while keeping track of balances. Built using functional components, React hooks (useState), and basic state management logic.
https://github.com/shadinkappachali/bill-share
django elixir expense-tracker expenses javascript mongodb nodejs react storybook stress-free-planning styled-components tracker transactions vue
Last synced: 3 months ago
JSON representation
A simple React app to manage shared expenses with friends. Add friends, select a friend, and split bills while keeping track of balances. Built using functional components, React hooks (useState), and basic state management logic.
- Host: GitHub
- URL: https://github.com/shadinkappachali/bill-share
- Owner: Shadinkappachali
- Created: 2025-05-15T09:35:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-22T18:36:34.000Z (about 1 year ago)
- Last Synced: 2025-05-30T11:51:25.510Z (about 1 year ago)
- Topics: django, elixir, expense-tracker, expenses, javascript, mongodb, nodejs, react, storybook, stress-free-planning, styled-components, tracker, transactions, vue
- Language: JavaScript
- Size: 176 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bill Share 🧾💰
   
Welcome to **Bill Share**, a simple React application designed to help you manage shared expenses with friends. This app allows you to add friends, select a friend, and split bills while keeping track of balances.
## Table of Contents
1. [Features](#features)
2. [Technologies Used](#technologies-used)
3. [Installation](#installation)
4. [Usage](#usage)
5. [Contributing](#contributing)
6. [License](#license)
7. [Contact](#contact)
8. [Releases](#releases)
## Features 🌟
- **Add Friends**: Easily add friends to your list.
- **Split Bills**: Select a friend and split expenses with ease.
- **Track Balances**: Keep track of how much each friend owes or is owed.
- **User-Friendly Interface**: A clean and simple UI that enhances the user experience.
## Technologies Used 🛠️
This project is built using the following technologies:
- **React**: A JavaScript library for building user interfaces.
- **Functional Components**: Using functional components for a cleaner codebase.
- **React Hooks**: Specifically, the `useState` hook for state management.
- **JavaScript**: The core language for building the app.
- **Basic State Management Logic**: Simple logic to manage state without the complexity of external libraries.
## Installation 🚀
To get started with **Bill Share**, follow these steps:
1. Clone the repository:
```bash
git clone https://github.com/Shadinkappachali/bill-share.git
```
2. Navigate to the project directory:
```bash
cd bill-share
```
3. Install the dependencies:
```bash
npm install
```
4. Start the application:
```bash
npm start
```
## Usage 🖥️
Once the application is running, you can:
1. **Add Friends**: Click on the "Add Friend" button and enter the friend's name.
2. **Select a Friend**: Choose a friend from the list to manage expenses.
3. **Split Bills**: Enter the amount and click on "Split Bill" to divide the cost among friends.
4. **View Balances**: Check the balance for each friend to see who owes what.
## Contributing 🤝
We welcome contributions! If you would like to contribute to **Bill Share**, please follow these steps:
1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature/YourFeature
```
3. Make your changes and commit them:
```bash
git commit -m "Add your message here"
```
4. Push to the branch:
```bash
git push origin feature/YourFeature
```
5. Create a pull request.
## License 📄
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Contact 📧
For any questions or suggestions, feel free to reach out:
- **Author**: Shadinkappachali
- **Email**: shadinkappachali@example.com
## Releases 📦
To download the latest version of **Bill Share**, visit the [Releases section](https://github.com/Shadinkappachali/bill-share/releases). You can download and execute the files available there.
For updates and new features, check back often in the Releases section or follow the repository.
---
Feel free to explore the code, make changes, and enjoy managing your shared expenses with friends! Happy sharing!