Bill Split

An AI-powered bill splitting application that makes splitting bills and shared expenses effortlessly. Upload a receipt image or paste receipt text, and let AI automatically extract items.

Features

• AI-Powered Receipt Parsing - Uses Google Gemini AI to automatically extract items and prices from receipt images or text
• Multi-Currency Support - Supports 100+ countries with automatic tax rate calculation
• Flexible People Management - Add/remove people and assign items to multiple people
• Manual Editing - Edit item names, prices, tax, and tip amounts
• Smart Split Calculation - Automatically calculates individual shares including tax and tip
• Responsive Design - Works seamlessly on desktop and mobile devices

Tech Stack

• Full-Stack: TanStack Start (React Server Components)
• AI Integration: Google Gemini 2.5 Pro

Getting Started

Prerequisites

• Node.js 18+ or Bun
• Google Gemini API key (Get one here)

Installation

1. Clone the repository:

git clone https://github.com/mktcz/bill-split.git
cd bill-split

2. Install dependencies:

npm install
# or
bun install

3. Set up environment variables:

# Create a .env file in the root directory
echo "GEMINI_API_KEY=your_api_key_here" > .env

4. Start the development server:

npm run dev
# or
bun run dev

The application will be available at http://localhost:3000

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

• Built with TanStack Start
• UI components from shadcn/ui
• AI powered by Google Gemini