How jameskokoska/cashew works
Cashew is a cross-platform personal-finance app built with Flutter, Drift SQL, and Firebase. The main user workflow is to manage accounts and currencies, record and categorize transactions, organize spending into budgets and goals, then review results through summaries and graphs. The README also documents search and filtering, reminders, authentication, backup, and cross-device sync. Main application source was not sampled, so feature-level links below reflect README-documented behavior; the SQL WebAssembly files are included as indexed core modules, but their connection to app storage is unverified.
Main entry points: main.dart Cashew app · addTransactionPage.dart Transactions · homePage.dart Home dashboard · syncClient.dart Cross-device sync
Components 19
Finance workflows
- Transactions
budget/lib/pages/addTransactionPage.dart - Search and filters
budget/lib/pages/transactionsSearchPage.dart - Categories
budget/lib/pages/addCategoryPage.dart - Accounts and wallets
budget/lib/pages/accountsPage.dart - Currencies
budget/lib/pages/exchangeRatesPage.dart - Budgets
budget/lib/pages/addBudgetPage.dart - Goals
budget/lib/pages/addObjectivePage.dart
Financial insights
- Home dashboard
budget/lib/pages/homePage/homePage.dart - Spending graphs
budget/lib/pages/homePage/homePageLineGraph.dart
App platform
- Cashew app
budget/lib/main.dart - Reminders
budget/lib/struct/initializeNotifications.dart - Biometric lock
budget/lib/struct/initializeBiometrics.dart - Google login
budget/lib/struct/firebaseAuthGlobal.dart
Data and sync
- Local database
budget/lib/database/tables.dart - Cross-device sync
budget/lib/struct/syncClient.dart - Google Drive
- SQL WebAssembly
budget/web/sql-wasm.js - SQL worker
budget/web/worker.sql-wasm.js
Other components
- User
Connections 17
- User → Cashew app: uses
README.md - Cashew app → Transactions: manages
README.md - Cashew app → Budgets: manages
README.md - Cashew app → Accounts and wallets: manages
README.md - Cashew app → Goals: tracks
README.md - Cashew app → Search and filters: searches
README.md - Transactions → Categories: categorizes
README.md - Cashew app → Currencies: converts
README.md - Cashew app → Home dashboard: presents
README.md - Home dashboard → Spending graphs: visualizes
README.md - Cashew app → Reminders: reminds
README.md - Cashew app → Biometric lock: secures
README.md - Cashew app → Google login: authenticates
README.md - Cashew app → Local database: stores data
README.md - Cashew app → Cross-device sync: synchronizes
README.md - Cross-device sync → Google Drive: backs up
README.md - SQL worker → SQL WebAssembly: executes SQL
budget/web/worker.sql-wasm.js