https://github.com/shivammodi05/flatmates-bill-webapp
A webApp that allows 2 flatmates to split Flat Bills according to the number of days spent in the Flat.
https://github.com/shivammodi05/flatmates-bill-webapp
css flask html5 python3
Last synced: 5 months ago
JSON representation
A webApp that allows 2 flatmates to split Flat Bills according to the number of days spent in the Flat.
- Host: GitHub
- URL: https://github.com/shivammodi05/flatmates-bill-webapp
- Owner: shivammodi05
- License: mit
- Created: 2025-03-22T06:54:09.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-22T07:12:17.000Z (over 1 year ago)
- Last Synced: 2025-03-22T08:20:27.471Z (over 1 year ago)
- Topics: css, flask, html5, python3
- Language: Python
- Homepage:
- Size: 86.9 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Flatmates' Bill
This web application helps to split a bill between two flatmates. It calculates the share of each flatmate based on the number of days they stayed in the house during the billing period.
## Features
- Calculate the share of each flatmate in the bill.
- Simple and intuitive web interface.
## Requirements
- Python
- Flask
- pip
## Installation
1. Clone the repository:
```bash
git clone https://github.com/shivammodi05/Flatmates-Bill-WebApp
cd Flatmates-Bill-WebApp
```
2. Create a virtual environment:
```bash
python -m venv .venv
```
3. Activate the virtual environment:
- On Windows:
```bash
.venv\Scripts\activate
```
- On macOS/Linux:
```bash
source .venv/bin/activate
```
4. Install the required packages:
```bash
pip install -r requirements.txt
```
## Usage
1. Run the Flask application:
```bash
flask run
```
2. Open your web browser and go to `http://127.0.0.1:5000/`.
3. Use the web interface to enter the bill details and calculate the share for each flatmate.
## Project Structure
- `flatmates_bill/flat.py`: Contains the `Bill` and `Flatmate` classes.
- `templates/index.html`: The main HTML template for the web interface.
- `static/main.css`: The CSS file for styling the web interface.
- `.gitignore`: Specifies files and directories to be ignored by git.
## License
This project is licensed under the MIT License.