How actualbudget/actual works
Actual is a local-first personal finance and envelope-budgeting application. Users manage accounts, transactions, budgets and rules in a desktop or other client; the shared loot-core provides application behavior, while the sync server enables changes to move between devices. The repository also includes bank-connection integrations and cloud-file handling. The README documents the package split and local-first sync, and excerpts show selected client, core and server calls. Several important modules are indexed but unsampled, so their internal connections are omitted rather than inferred.
Main entry points: src/app.ts Sync server · accounts/app.ts Account operations · cloud-storage.ts Cloud file handling · index.ts Desktop shell
Components 30
Clients
- Desktop shell
packages/desktop-electron/index.ts - Backend loader
packages/desktop-electron/server.ts - Rules manager
packages/desktop-client/src/components/ManageRules.tsx - Account tree drag-drop
packages/desktop-client/src/components/sidebar/redesign/useAccountTreeDragAndDrop.tsx - Transactions table
packages/desktop-client/src/components/table.tsx - Virtual list
packages/desktop-client/src/components/FixedSizeList.tsx - Query manager
packages/desktop-client/src/components/formula/QueryManager.tsx
Finance Core
- Account operations
packages/loot-core/src/server/accounts/app.ts - Account sync
packages/loot-core/src/server/accounts/sync.ts - Budget operations
packages/loot-core/src/server/budget/app.ts - Schedule operations
packages/loot-core/src/server/schedules/app.ts - Schedule finder
packages/loot-core/src/server/schedules/find-schedules.ts - Reports
packages/loot-core/src/server/reports/app.ts - Dashboard
packages/loot-core/src/server/dashboard/app.ts - Authentication
packages/loot-core/src/server/auth/app.ts
Local Data
- Budget files
packages/loot-core/src/server/budgetfiles/app.ts - Cloud file handling
packages/loot-core/src/server/cloud-storage.ts - Legacy SQLite engine
packages/loot-core/src/platform/server/sqlite/engine.sqljs.legacy.ts - WASM SQLite engine
packages/loot-core/src/platform/server/sqlite/engine.wasm.ts
Sync Services
- Sync server
packages/sync-server/src/app.ts - Sync routes
packages/sync-server/src/app-sync.ts - Sync file service
packages/sync-server/src/app-sync/services/files-service.ts
Bank Integrations
- GoCardless integration
packages/sync-server/src/app-gocardless/app-gocardless.ts - GoCardless service
packages/sync-server/src/app-gocardless/services/gocardless-service.ts - Enable Banking
packages/sync-server/src/app-enablebanking/app-enablebanking.ts - Akahu integration
packages/sync-server/src/app-akahu/app-akahu.ts - Pluggy integration
packages/sync-server/src/app-pluggyai/app-pluggyai.js - SimpleFIN integration
packages/sync-server/src/app-simplefin/app-simplefin.js
Other components
- Budget user
- Banking provider
Connections 19
- Budget user → Desktop shell: uses
- Desktop shell → Backend loader: starts backend
packages/desktop-electron/index.ts - Backend loader → Account operations: loads core bundle
packages/desktop-electron/server.ts - Rules manager → Account operations: requests rule data
packages/desktop-client/src/components/ManageRules.tsx - Account tree drag-drop → Account operations: updates account layout
- Transactions table → Virtual list: renders rows
packages/desktop-client/src/components/table.tsx - Account operations → Account sync: syncs account
packages/loot-core/src/server/accounts/app.ts - Schedule operations → Schedule finder: finds schedules
packages/loot-core/src/server/schedules/app.ts - Cloud file handling → Sync server: uploads files
packages/loot-core/src/server/cloud-storage.ts - Cloud file handling → Sync server: lists files
packages/loot-core/src/server/cloud-storage.ts - Cloud file handling → Sync server: downloads files
packages/loot-core/src/server/cloud-storage.ts - Sync server → Sync routes: registers routes
packages/sync-server/src/app.ts - Sync server → GoCardless integration: registers integration
packages/sync-server/src/app.ts - Sync server → Enable Banking: registers integration
packages/sync-server/src/app.ts - Sync server → Akahu integration: registers integration
packages/sync-server/src/app.ts - Sync server → Pluggy integration: registers integration
packages/sync-server/src/app.ts - Sync server → SimpleFIN integration: registers integration
packages/sync-server/src/app.ts - GoCardless service → Banking provider: contacts provider
- Account operations → Banking provider: connects accounts