# PokerSplit

> Free poker settlement calculator for home games. Players join a shared game session using a 6-character code, track buy-ins in real time, and receive a minimal set of payment instructions at the end. No app download required — works on any mobile or desktop browser.

PokerSplit solves the common problem of settling poker debts after a home game. The algorithm minimizes the total number of transfers needed to make everyone whole, regardless of how many players participated or how many times each player bought in.

## Core features

- **Settlement calculator** — enter how much each player finished with; PokerSplit calculates the minimum payment graph
- **Live game sharing** — share a unique 6-character game code or QR code so all players can follow along in real time
- **Buy-in tracking** — add or remove buy-ins per player during the game; the pot auto-balances
- **Game history** — signed-in users can view all their past games and net results
- **Leaderboard** — ranks players by total net winnings or win rate across all games
- **Player pool** — save your regular players so you can add them to new games without retyping names
- **No account required** — the dealer creates a game and shares the code; guests join with no sign-in

## Pages

- [Home / App](https://pokersplit.org/): The main calculator. Handles game setup, live tracking, settlement, and results all in a single-page flow.
- [Resources](https://pokersplit.org/resources): Poker hand rankings cheat sheet, home game setup guide, chip values reference, and a poker glossary.
- [Privacy Policy](https://pokersplit.org/privacy): What data is collected (Google account info via OAuth, game history), how it is stored (Supabase), and user rights.
- [Terms of Use](https://pokersplit.org/terms): Eligibility, acceptable use, disclaimer of liability.

## How the settlement algorithm works

After all players enter their final chip counts, PokerSplit:

1. Computes each player's net (cash-out minus total buy-ins)
2. Splits players into two lists: those who are owed money (winners) and those who owe money (losers)
3. Greedily matches the largest loser to the largest winner, records a payment, and repeats until balanced

This produces at most N-1 payments for N players — typically fewer than a naive peer-to-peer approach.

## Technology

- Vanilla JavaScript ES modules, no framework
- Vite build tool, deployed on Vercel
- Supabase (PostgreSQL + Auth) for game state, user accounts, and game history
- Google OAuth for sign-in
- Real-time game updates via Supabase subscriptions