Personal LedgerKeeper Suite
High-precision double-entry accounting application in Flutter featuring balanced multi-line vouchers, budget enforcement, and offline-first cloud sync.
Project Overview & Architecture
LedgerKeeper Suite is an architectural financial accounting application built with the Flutter framework and backed by Supabase PostgreSQL. Designed for professionals, independent practitioners, and small business owners who require strict ledger integrity, LedgerKeeper Suite replaces casual single-entry expense trackers with a mathematically rigorous double-entry bookkeeping model.
At the foundation of LedgerKeeper Suite is the principle of balanced voucher posting: every transaction must validate that the total sum of debits strictly equals the total sum of credits before it can be committed to the database. The application provides an interactive multi-line voucher entry interface (voucher_entry_screen.dart) that accommodates complex transactions involving multiple debit and credit allocations—such as split business expenses, asset acquisitions financed through liabilities, or multi-account transfers.
The system organizes all accounts into a standard Chart of Accounts structure categorized across Assets, Liabilities, Equity, Income, and Expenses. From this ledger foundation, LedgerKeeper Suite generates real-time accounting statements without requiring manual batch reconciliations:
- Trial Balance: Verifies global debit/credit parity across all open ledger codes.
- Profit & Loss Statement: Aggregates recognized revenues against operational expenses to determine accurate net margin across defined reporting intervals.
- Asset & Liability Balance Sheet: Provides a consolidated snapshot of net worth and financial standing.
- Budget Enforcement Engine: Allows users to establish monthly expenditure thresholds per category, rendering real-time visual alerts and progress indicators whenever an expense group approaches or exceeds its allocated quota.
Hybrid Architecture and Data Resilience: LedgerKeeper Suite features a resilient dual-mode data architecture. Out of the box, the application operates in an offline fallback mode using fast in-memory structures and local persistence via shared_preferences. When multi-device synchronization is required, users enter their Supabase database credentials within the Settings interface. The application then synchronizes transaction vouchers, budget entities, and chart accounts against a dedicated PostgreSQL database using the supabase_flutter client, governed by secure database policies defined in supabase_setup.sql. The suite also integrates native PDF document generation and printing support (pdf and printing packages), enabling users to compile and print formal ledger extracts and statement sheets directly from mobile or desktop devices.