Project Overview
A full-stack personal finance application that helps you track income, bills, and debts with intelligent payoff calculations and financial projections. Built with a React frontend and FastAPI Python backend, fully containerized with Docker for easy self-hosting - including native TrueNAS SCALE support.
Key Features
- Dashboard - Visual overview of your financial health with charts and summary metrics
- Income Management - Track income sources with multiple frequencies (weekly, monthly, yearly, etc.)
- Bills Tracking - Categorize bills by type, set due dates, link to bank accounts. Supports shared bills with contributor splitting
- Debt Management - Intelligent payoff calculators with promotional period tracking, minimum payment calculations, and deadline warnings
- Financial Projections - Project your financial future based on current income, spending, and debt repayment plans
- Backup & Export - Full import/export functionality for data portability
- TrueNAS SCALE Native - Can be installed as a native TrueNAS app via custom app catalog
Architecture
The frontend is a React SPA that communicates with a FastAPI backend over REST. Data is stored in SQLite with automatic migrations. The entire stack is containerized with Docker and published to GitHub Container Registry. Multi-architecture builds ensure it runs on both x86_64 and ARM64 hardware.
Deployment
Designed for self-hosting with multiple deployment options: standard Docker Compose, TrueNAS SCALE native app, or manual deployment. Includes GitHub Actions CI/CD for automatic builds and optional auto-deployment to a TrueNAS server via SSH.