How siyabongadlamini/actual works
Actual is a local-first personal-finance and envelope-budgeting application. A user works in the desktop client or another supported app to manage budget data; loot-core provides the cross-platform application behavior and SQLite storage, while cloud storage and the sync server support moving changes between devices. The tree and README establish these broad product boundaries, and excerpts show selected implementation links. Many feature modules and server integrations are indexed but unsampled, so only documented or directly evidenced relationships are drawn.
Main entry points: src/app.ts Sync server · engine.wasm.ts WASM SQLite engine · ManageRules.tsx Budget UI · accounts/app.ts Account management
Components 21
User clients
- Desktop shell
packages/desktop-electron/index.ts - Budget UI
packages/desktop-client/src/components/ManageRules.tsx - Rules management
packages/desktop-client/src/components/ManageRules.tsx - Query manager
packages/desktop-client/src/components/formula/QueryManager.tsx - Storage settings
packages/desktop-client/src/components/settings/StorageBackendToggle.tsx - Account navigation
packages/desktop-client/src/components/sidebar/redesign/useAccountTreeDragAndDrop.tsx
Budget core
- Account management
packages/loot-core/src/server/accounts/app.ts - Budget management
packages/loot-core/src/server/budget/app.ts - Schedules
packages/loot-core/src/server/schedules/app.ts - Dashboard
packages/loot-core/src/server/dashboard/app.ts - Query model
packages/loot-core/src/shared/query.ts - Cloud file storage
packages/loot-core/src/server/cloud-storage.ts
Local persistence
- 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
Cloud sync
- Sync server
packages/sync-server/src/app.ts - Server entry
packages/sync-server/app.ts - Bank connections
packages/sync-server/src/app-gocardless/services/gocardless-service.ts
Developer interfaces
- Public API
packages/api/methods.ts - API query builder
packages/api/app/query.ts - Command-line client
packages/cli/src/index.ts
Other components
- Budget user
Connections 18
- Budget user → Budget UI: manages budget
- Desktop shell → Budget UI: hosts UI
- Budget UI → Rules management: opens rules
packages/desktop-client/src/components/ManageRules.tsx - Rules management → Account management: requests rules
packages/desktop-client/src/components/ManageRules.tsx - Storage settings → WASM SQLite engine: selects backend
packages/desktop-client/src/components/settings/StorageBackendToggle.tsx - Storage settings → Legacy SQLite engine: selects backend
packages/desktop-client/src/components/settings/StorageBackendToggle.tsx - Query manager → Query model: configures queries
- Account navigation → Account management: reorders accounts
- Account management → WASM SQLite engine: persists data
- Budget management → WASM SQLite engine: persists data
- Schedules → WASM SQLite engine: persists data
- Dashboard → Query model: uses queries
- Cloud file storage → Sync server: uploads files
packages/loot-core/src/server/cloud-storage.ts - Cloud file storage → Sync server: lists files
packages/loot-core/src/server/cloud-storage.ts - Server entry → Sync server: starts server
packages/sync-server/app.ts - Sync server → Bank connections: routes requests
packages/sync-server/src/app.ts - Public API → API query builder: builds queries
packages/api/methods.ts - Command-line client → Public API: uses API