iPhone · Web · Open Source

BILLHIVE

Your household bills. Handled.

One person fronts every bill. Everyone else owes them money. BillHive tracks the splits, generates Zelle, Venmo & Cash App deep-links, and sends beautiful HTML email summaries — right on your iPhone or from a self-hosted server.

1
Docker container
4
Email providers
Bills & People
$0
Subscription
Process

How BillHive works

From bill entry to payment collection in four steps. No SaaS account, no subscription — use it on your iPhone or self-host it.

01
📋
Add your bills
Create recurring bills and assign lines to household members. Choose percentage splits or fixed dollar amounts. Set "covered by" relationships for complex family arrangements.
02
✏️
Enter amounts
Each month, enter the actual bill totals. BillHive instantly calculates each person's share. Enable auto-carry for fixed bills like mortgage that don't change month to month.
03
💰
See who owes what
The Summary tab shows each person's total owed with a full bill-by-bill breakdown. Your personal outlay is tracked separately. Month-over-month charts show spending history.
04
📤
Collect payment
Send personalized HTML email summaries with one tap. Zelle, Venmo, and Cash App deep-links are auto-generated with the exact amount. A monthly checklist tracks what's been sent and collected.
Features

Everything you need

Built for real households with real complexity. Flexible enough to handle any bill arrangement you can imagine.

⚖️
Smart bill splitting
Split by percentage or fixed dollar amounts per line. Set "covered by" relationships — Dad can pay on Mom's behalf while Mom shows $0 owed.
💸
Payment deep-links
Zelle, Venmo, and Cash App links auto-generated with the exact amount pre-filled. Custom Zelle URLs supported for banks with their own enrollment flows.
📧
HTML email summaries
Beautiful dark-themed bill summaries sent to each person with one click. The iOS app uses native Mail, while the server version 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.
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 — or self-host with one Docker container and a SQLite database. Either way, your data stays yours. No cloud, no accounts, no tracking.
App Preview

See it in action

The Bills tab — enter totals, see splits instantly across all household members. Every number updates live as you type.

🔒 bills.yourhome.local
February 2026
Bills 3
Summary
Send & Receive
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

The same native app, two different builds. Choose based on how you want to store your data: locally on-device, or on your self-hosted server.

BillHive
Standalone

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

  • Data stored locally on-device — nothing leaves your phone
  • No server URL, no Docker, no setup required
  • Sends emails via iOS Mail (your existing mail account)
  • Works completely offline
  • All five tabs — Bills, Summary, Send & Receive, Trends, Settings
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.

  • Connects directly to your BillHive server via URL
  • Data syncs between web app and iPhone in real time
  • Sends rich HTML emails via your server's relay (Mailgun, SendGrid, SMTP)
  • Requires BillHive server to be running and reachable
  • All five tabs — Bills, Summary, Send & Receive, Trends, Settings
Both versions include
Live split calculation All 5 tabs Zelle, Venmo & Cash App deep-links Month-over-month trends Bill preserve / auto-fill Coverage tracking 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.

Do I need a server to use the iOS app?

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

Where is my data stored?

On the standalone iOS app, your data stays on your device in a local JSON file. On the self-hosted version, it's stored in a SQLite database on your server. Nothing is sent to any 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.