SelfHive: Bill Splitting

SelfHive is the iOS companion for your self-hosted BillHive server. It handles three kinds of splitting: household bills, restaurant checks, and group trips. All data syncs to your own server.

Requires a running BillHive server (one Docker container). Deploy with:
docker run -d -p 8080:8080 -v billhive-data:/data ghcr.io/martyportatoes/billflow:latest

BILLS MODE
Track recurring household bills month after month. Split by percentage or fixed dollar amounts, set "covered by" relationships, and auto-carry amounts that don't change. The monthly checklist syncs between web and iOS.

CHECKS MODE
Split a restaurant check in seconds. Scan the receipt with on-device OCR to auto-populate line items, tax, and tip. Generate a no-account share link hosted on your server. Friends open it in any browser and claim their items.

TRIPS MODE
Create a trip, add members, and log multi-payer expenses with receipt photos. When the trip ends, debt simplification minimizes transfers. Export PDF or CSV summaries.

COLLECT WHAT YOU'RE OWED
Zelle, Venmo, and Cash App deep-links with the exact amount pre-filled across all three modes. Send rich HTML emails via your server's mail relay (Mailgun, SendGrid, Resend, or SMTP).

KEY FEATURES
- Three modes: Bills, Checks, and Trips
- Syncs with your BillHive web app in real time
- On-device receipt OCR (nothing uploaded to the cloud)
- No-account share links hosted on your server
- Zelle, Venmo, and Cash App payment deep-links
- Rich HTML email summaries via server relay
- Debt simplification for trips
- Multi-payer and multi-currency expense support
- Month-over-month trend charts
- Dark theme with amber accent

Your data lives on your server. Nothing is sent to any third-party service. Open-source at github.com/MartyPortatoes/BillHive.