How ethan-kisiel/aera works
Aera is a desktop ledger application: users enter, search, review, and report on financial entries. The renderer coordinates entry and ledger views, sends ledger operations through the typed Electron bridge, and the main process dispatches them to the native C++ ledger backed by SQLite. The UI also supports importing legacy JSON entries and producing expense reports. The graph preserves these documented/product branches; unsampled renderer and native details are represented only where the tree or README supports their role.
Main entry points: renderer.ts Aera app · index.ts Electron main · shared-types.ts Shared entry types · ledger-view.ts Ledger view
Components 20
Ledger interface
- Aera app
src/renderer/src/renderer.ts - Entry editor
src/renderer/src/views/entry-input-ribbon.ts - Autocomplete input
src/renderer/src/components/autocomplete-input.ts - Ledger view
src/renderer/src/views/ledger-view.ts - Search input
src/renderer/src/components/search-bar.ts - Entry table
src/renderer/src/components/simple-table.ts - Year selector
src/renderer/src/components/year-selector.ts - Expense report
src/renderer/src/views/report-view.ts - App modal
src/renderer/src/components/app-modal.ts
Desktop integration
- Electron main
src/main/index.ts - IPC preload
src/preload/index.ts - Import menu
src/main/menu/menu-bar-template.ts - JSON import
src/main/menu/load-entries.ts
Ledger engine
- Native addon API
src/native/addon.cc - Ledger operations
src/native/src/ledger/ledger.cc - Ledger repository
src/native/src/ledger/ledger_repository.cc - SQLite database
src/native/src/core/database.hh
Shared contracts
- Shared entry types
src/types/shared-types.ts
Other components
- Ledger user
- Electron runtime
Connections 24
- Ledger user → Aera app: uses
README.md - Aera app → Entry editor: renders
src/renderer/src/renderer.ts - Aera app → Ledger view: renders
src/renderer/src/renderer.ts - Aera app → Expense report: renders
src/renderer/src/renderer.ts - Aera app → App modal: renders
src/renderer/src/renderer.ts - Entry editor → Autocomplete input: renders
src/renderer/src/views/entry-input-ribbon.ts - Ledger view → Search input: renders
src/renderer/src/views/ledger-view.ts - Ledger view → Entry table: renders
src/renderer/src/views/ledger-view.ts - Ledger view → Year selector: renders
src/renderer/src/views/ledger-view.ts - Aera app → IPC preload: invokes ledger API
src/renderer/src/renderer.ts - IPC preload → Electron main: sends IPC
- Electron main → Native addon API: dispatches ledger calls
src/main/index.ts - Native addon API → Ledger operations: delegates
src/native/addon.cc - Ledger operations → Ledger repository: uses repository
src/native/src/ledger/ledger.cc - Ledger repository → SQLite database: uses storage
src/native/src/ledger/ledger_repository.cc - Import menu → JSON import: loads entries
src/main/index.ts - Electron main → Import menu: configures menu
src/main/index.ts - Electron main → JSON import: parses and imports
src/main/index.ts - Electron runtime → Electron main: hosts process
README.md - Shared entry types → Aera app: types entries
src/renderer/src/renderer.ts - Shared entry types → Entry editor: types entries
src/renderer/src/views/entry-input-ribbon.ts - Shared entry types → Ledger view: types entries
src/renderer/src/views/ledger-view.ts - Shared entry types → Expense report: types entries
src/renderer/src/views/report-view.ts - Shared entry types → Electron main: types IPC
src/main/index.ts