Skip to content

This project is a web-based interactive bill breakdown calculator built with Next.js, React, and Tailwind CSS. It allows users to input expenses for multiple participants and calculates how to split the bill fairly, providing visualizations and payment instructions.

License

Notifications You must be signed in to change notification settings

samson10504/Interactive-Bill-Breakdown-Calculator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bill Breakdown Calculator

Bill Breakdown Calculator Demo

An interactive web application built with Next.js that helps groups easily split bills and calculate who owes what.

Features

  • Add Multiple Participants: Easily input names and amounts paid by each person.
  • Visual Breakdown: See a clear pie chart representation of payments.
  • Detailed Calculations: Get a breakdown of who owes what and who should be paid back.
  • Payment Instructions: Receive step-by-step instructions for settling the bill.
  • Responsive Design: Works seamlessly on desktop and mobile devices.

Screenshots

Home Screen

Home Screen

Payment Distribution Chart

Payment Distribution

Breakdown Summary

Breakdown Summary

Payment Instructions

Payment Instructions

Prerequisites

Before you begin, ensure you have met the following requirements:

  • Node.js (v14 or later)
  • npm (v6 or later)

Installation

To install the Interactive Bill Breakdown Calculator, follow these steps:

  1. Clone the repository:

    git clone https://github.com/samson10504/Interactive-Bill-Breakdown-Calculator.git
  2. Navigate to the project directory:

    cd Interactive-Bill-Breakdown-Calculator/
    cd bill-breakdown-calculator
  3. Install the dependencies:

    npm install

Usage

To run the Interactive Bill Breakdown Calculator, use the following command:

npm run dev

Then, open your web browser and navigate to http://localhost:3000.

Tech Stack

  • Next.js - React framework for production
  • React - JavaScript library for building user interfaces
  • Recharts - Charting library built on React components
  • Tailwind CSS - Utility-first CSS framework
  • Shadcn UI - Re-usable components built with Radix UI and Tailwind CSS

Contributing

Contributions to the Interactive Bill Breakdown Calculator are welcome. To contribute:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/AmazingFeature).
  3. Make your changes.
  4. Commit your changes (git commit -m 'Add some AmazingFeature').
  5. Push to the branch (git push origin feature/AmazingFeature).
  6. Open a pull request.

License

This project is open source and available under the MIT License.

Deployment

This app can be easily deployed on Vercel, the platform created by the makers of Next.js.

Deploy with Vercel

About

This project is a web-based interactive bill breakdown calculator built with Next.js, React, and Tailwind CSS. It allows users to input expenses for multiple participants and calculates how to split the bill fairly, providing visualizations and payment instructions.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published