Skip to content

This is a bill splitter application which helps you split the expenses between different people after having a group meeting.

Notifications You must be signed in to change notification settings

Unknownflow/bill-splitter

Repository files navigation

🧾 Bill Splitter

A web application to easily split bills among multiple people.

🛠️ Tech Stack

  • Frontend: React + TypeScript + Vite
  • UI Library: Material UI (MUI)
  • Containerization: Docker, Docker Compose

🚀 Local Development

To run the project locally without Docker:

1. Clone the repository

git clone https://github.com/Unknownflow/bill-splitter.git
cd bill-splitter

2. Install dependencies

npm install

3. Start the development server

npm run dev

The app will start on http://localhost:5173

🐳 Running with Docker

📦 Build and Start the App (Recommended)

Use Docker Compose to build and run the application:

This will:

docker-compose up --build

🐋 Run Using Prebuilt Docker Image

If the image is already built, you can run it directly:

docker run -p 5173:5173 bill-splitter

About

This is a bill splitter application which helps you split the expenses between different people after having a group meeting.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published