iPhone · Web · Open Source

BILLHIVE

Bills. Checks. Trips. Handled.

Three modes, one app. Split household bills monthly, divvy up restaurant checks with receipt OCR, and track trip expenses with multi-currency and debt simplification. Zelle, Venmo & Cash App deep-links built in — on your iPhone or from a self-hosted server.

Get the iOS App Self-Host View on GitHub
3
Modes — Bills · Checks · Trips
1
Docker container
∞
Bills, Checks & Trips
$0
Subscription — ever
Process

How BillHive works

From splitting to collecting — four steps for any scenario. No SaaS account, no subscription — use it on your iPhone or self-host it.

01
Pick your mode
Long-press the Mode tab to switch between Bills, Checks, and Trips. Each mode has its own focused experience — recurring household bills, one-off restaurant checks, or multi-day trip expenses.
02
Enter the details
Add bills with percentage or fixed splits. Scan a receipt with OCR to auto-populate check items. Log trip expenses with multi-payer support. BillHive calculates every share instantly.
03
See who owes what
Summary and settle-up views show each person's balance at a glance. Debt simplification minimizes the number of transfers needed. Month-over-month charts track spending history.
04
Collect payment
Send personalized HTML email summaries or share a link — friends claim their own items with no account required. Zelle, Venmo, and Cash App deep-links are pre-filled with the exact amount.
Features

Everything you need

Three modes, one app. Built for real households, real dinners, and real trips — with the flexibility to handle any arrangement you can imagine.

Smart bill splitting
Split recurring bills by percentage or fixed dollar amounts per line. Set "covered by" relationships — Dad can pay on Mom's behalf while Mom shows $0 owed.
Receipt OCR
Snap a photo of any restaurant receipt. On-device Vision AI extracts line items, tax, and tip — ready for your friends to claim their items.
Trip expense tracking
Create trips with members, log multi-payer expenses across categories, attach receipts, and let the debt simplification algorithm settle up with minimal transfers.
Payment deep-links
Zelle, Venmo, and Cash App links auto-generated with the exact amount pre-filled across all three modes. One tap to request or send payment.
No-account share links
Share a check or trip invite via link — friends claim their own items or join a trip with no app install or account required. The host sees claims in real time.
HTML email summaries
Beautiful dark-themed summaries sent to each person with one click. The iOS app uses native Mail, while the server supports Mailgun, SendGrid, Resend, and SMTP.
Trend charts
Track spending month-over-month with line charts, donut breakdowns, and stacked bar charts. Two views: Per Person and By Bill. Powered by Chart.js and Swift Charts.
Monthly checklist
Auto-generated checklist tracks what's been emailed, paid, and collected each month. Items are built dynamically from your configured people and bills.
Your data, your way
Store everything locally on your iPhone, sync via iCloud, or self-host with one Docker container and a SQLite database. No cloud lock-in, no accounts, no tracking.
App Preview

See it in action

Bills mode — enter totals, see splits instantly across all household members. Every number updates live as you type. Switch to Checks or Trips mode for restaurant and travel splitting.

🔒 bills.yourhome.local
February 2026
Bills 3
Summary
Pay & Collect
Trends
Settings
🏠
Mortgage
% split · auto-carry
$2,450.00
50% mine
▲
🏠
Mortgage
Person
%
Amount
Me
50%
$1,225.00
Wife
50%
$1,225.00
📱
Verizon
fixed split · 4 lines
$320.00
4 people
▼
⚡
Electric
% split · 3 lines
$185.00
30% mine
▼
Wife
$1,287
Mortgage · Electric · Verizon
Dad
$387
Electric · Verizon (covers Mom)
Mom
$0
Covered by Dad · Verizon
iOS Companion

BillHive on your iPhone — two ways

Three modes — Bills, Checks, and Trips — in one native app. Choose your build based on how you want to store your data: locally on-device with iCloud sync, or on your self-hosted server.

BillHive
Standalone

Fully self-contained — no server required. Your data lives on your iPhone with iCloud sync. Great for personal use or anyone who prefers to skip the server setup.

  • Three modes — Bills, Checks, and Trips — switch with a long-press
  • Data stored locally with iCloud sync across devices
  • Receipt OCR, no-account share links via iCloud, PNG export
  • Sends emails via iOS Mail (your existing mail account)
  • Works completely offline — no server, no Docker, no setup
Download on the App Store
SelfHive
Server Connected

A companion to your self-hosted BillHive server. Your data lives on your server and syncs with the web app — the iOS app is just another window into it.

  • Three modes — Bills, Checks, and Trips — all synced to your server
  • Data syncs between web app and iPhone in real time
  • No-account share links hosted on your server — friends claim items via browser
  • Sends rich HTML emails via your server's relay (Mailgun, SendGrid, SMTP)
  • Receipt OCR, trip settlements, multi-payer expenses, and CSV/PDF export
Download on the App Store
Both versions include
3 modes — Bills · Checks · Trips Zelle, Venmo & Cash App deep-links Receipt OCR scan No-account share links Debt simplification Month-over-month trends Bill preserve / auto-fill CSV & PDF export Import & export
Self-Host

Deploy in minutes

BillHive ships as a single Docker image. No external database, no Redis, no cloud services. One command and you're running.

1

Pull and run the container

The image is published to GitHub Container Registry. A named volume persists your SQLite database across restarts.

2

Open in your browser

Navigate to http://localhost:8080. The app loads instantly — no login, no setup wizard.

3

Add people, add bills, done

Add household members in Settings. Name, icon, and color each bill directly on the Bills tab — then start entering monthly amounts immediately.

Multi-user? Deploy behind Authelia or Authentik. BillHive reads the Remote-User header and automatically scopes all data per user — safe for a shared household server.
Docker Run
latest
# Pull and run BillHive
docker run -d \
  --name billhive \
  -p 8080:8080 \
  -v billhive-data:/data \
  ghcr.io/martyportatoes/billflow:latest
docker-compose.yml
services:
  billhive:
    image: ghcr.io/martyportatoes/billflow:latest
    ports: ["8080:8080"]
    volumes: [billhive-data:/data]
    restart: unless-stopped
Node.js 20 SQLite WAL Express 4 Vanilla JS Alpine Linux ~50MB image
Support

Need help?

BillHive is free, open-source software maintained by one developer. Here's how to get help or report issues.

Email Support

For questions, feedback, or account issues with the iOS app, send an email and you'll hear back within a few days.

billhive-support@mattp.me

Report a Bug

Found something broken? Open a GitHub Issue on the relevant repository. Include your device, OS version, and steps to reproduce.

FAQ

Is BillHive really free?

Yes. BillHive is open-source under the MIT license. There are no subscriptions, in-app purchases, or ads — ever.

What are the three modes?

Bills handles recurring household expenses month-to-month. Checks splits restaurant bills with receipt OCR and share links. Trips tracks travel expenses with multi-payer support and debt simplification. Long-press the Mode tab to switch.

Do I need a server to use the iOS app?

No. The standalone BillHive app stores all data locally on your iPhone with iCloud sync. Only the SelfHive variant requires a self-hosted server.

Where is my data stored?

On the standalone iOS app, your data syncs via iCloud Documents across your devices. On the self-hosted version, it's stored in a SQLite database on your server. Nothing is sent to any third-party cloud service.

How do I move data between devices?

Use the Import/Export feature in Settings. Export creates a JSON backup you can transfer to another device or server instance.