Skip to content

Mohit-Bagri/split-kar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 

Repository files navigation

💰 SPLITकर

Settle smart. Split sharp.

Live Demo

Next.js React TypeScript Tailwind shadcn/ui Zustand pdf-lib License


✨ What is SPLITकर?

SPLITकर is a modern, full-stack expense splitting and settlement calculator that helps groups track shared expenses and calculates optimal settlements to minimize the number of transactions needed.

No more awkward "you owe me" conversations—just upload, split and settle!


🚀 Features

Feature Description
📁 Multiple Input Methods CSV upload with drag-and-drop, natural language text parsing or manual entry
⚖️ Flexible Split Options Equal, percentage-based, fixed amount or share-based splits
🧠 Smart Settlement Algorithm Optimized to minimize transactions, handles rounding automatically
📄 Professional Reports PDF export with transaction summary and step-by-step settlements
🎨 Beautiful UI Dark theme with smooth animations and responsive design
🔒 Privacy First All calculations happen locally—no data leaves your browser

📦 Installation

Prerequisites

  • Node.js 18 or higher
  • npm or yarn

Quick Start

# Clone the repository
git clone https://github.com/Mohit-Bagri/split-kar.git
cd split-kar/my-app

# Install dependencies
npm install

# Start the development server
npm run dev

Open http://localhost:3000 in your browser.


📖 Usage

📝 CSV Upload

Upload expenses via CSV file with drag-and-drop:

paid_by,amount,description
Alice,500,Dinner
Bob,300,Movie tickets
Charlie,150,Drinks

With split details:

paid_by,amount,description,split_type,participants
Alice,500,Dinner,equal,"Alice,Bob,Charlie"
Bob,300,Movie tickets,percentage,"Alice:50,Bob:30,Charlie:20"

💬 Natural Language

Describe expenses in plain English:

Alice paid 500 for dinner for Alice, Bob and Charlie.
Bob paid 300 for movie tickets for everyone.

🧮 Settlement Calculation

Click "Calculate Settlement" to see:

  • Who owes money
  • Who should receive money
  • Minimum transactions needed to settle all debts

🧪 Testing

npm test

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.


Made in 🇮🇳 with ❤️ by Mohit Bagri

About

A modern expense splitting and settlement calculator. Upload CSV, type naturally or enter manually - get optimized settlements instantly.

Topics

Resources

License

Stars

Watchers

Forks

Contributors