About¶
BillTracker is for households and individuals who want a focused bill-planning tool while keeping financial data on infrastructure they control.
Highlights¶
- Monthly tracker buckets for bills due on the
1st-14thand15th-31st - Recurring billing cycles, monthly overrides, notes, skip state, and payment history
- SimpleFIN transaction sync, CSV and XLSX imports, matching, and subscription suggestions
- Debt snowball and avalanche projections with APR and amortization support
- Calendar, summary, analytics, account health, release notes, and profile tools
- Admin-managed users, OIDC authentication, SMTP reminders, backups, and cleanup
Technology¶
| Layer | Implementation |
|---|---|
| Frontend | React 19, Vite, Tailwind CSS, shadcn/ui-style local primitives, TanStack Query |
| Backend | Node.js 22, Express |
| Storage | SQLite through better-sqlite3 |
| Authentication | Local username/password (bcrypt), TOTP / WebAuthn 2FA, optional Authentik-compatible OIDC, optional single-user mode |
| Animations | framer-motion (page, dialog, and tracker reorder transitions) |
| Packaging | Multi-stage Docker image with a non-root runtime user |
Next steps¶
- See the live interface in Tour the Interface.
- Read the security model in Security.
- Install with Docker in Install with Docker.