SPLT is a mobile-first web app for splitting bills within a group. Share a link, add expenses, and let SPLT calculate who owes what — no sign-up, no friction.

• No login required — share a group link with friends and start splitting immediately
• Mobile-first design — clean, minimalistic UI built for phones
• Flexible splitting — split by equal shares, custom amounts, or custom parts
• Debt summarization — automatically calculates net debts across all transactions
• Payment methods — members can store preferred payment details (e.g. bank, IBAN) so others know how to pay them back
• Dark / light mode — follows system preference

• Node.js 18+
• PocketBase binary (download here)

1. Clone the repo

   git clone https://github.com/guid3d/splt.git
   cd splt

2. Install dependencies

   npm install

3. Add PocketBase binary

   Download the PocketBase executable for your OS and place it at db/pocketbase.

4. Start both servers

   ./dev.sh

   Service	URL
   Next.js	http://localhost:3000
   PocketBase	http://127.0.0.1:8090
   Admin UI	http://127.0.0.1:8090/_/

   Press Ctrl+C to stop both. Alternatively, run them separately:

   npm run dev          # Next.js
   ./db/pocketbase serve  # PocketBase

5. Import the database schema

   • Open the PocketBase Admin UI and create an admin account.
   • Go to Settings → Import collections.
   • Load db/pb_schema.json.

6. Open the app at http://localhost:3000

Set the PocketBase URL in your environment:

NEXT_PUBLIC_POCKETBASE_URL=https://your-instance.pockethost.io

• Advanced bill splitting modes
• Loading indicators on async actions
• Passcode-protected groups
• Currency selection
• Per-person expense summary page
• IBAN masking
• Error handling when data fails to load

• i18n / localization
• Optional authentication
• Bill photo upload with auto-extraction
• Email notifications
• Dockerfile for self-hosting
• Bank name lookup from IBAN

• Create and edit transactions
• Split by equal shares, parts, or fixed amounts
• Participant contrast colors on selection
• Preferred payment method per participant
• Single-command dev setup (dev.sh)

PRs welcome. Open an issue first for significant changes.

MIT