# ethan-kisiel/aera architecture

> Architecture diagram of the GitHub repository ethan-kisiel/aera, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ethan-kisiel/aera
- Repository: https://github.com/ethan-kisiel/aera

## Overview

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: [`src/renderer/src/renderer.ts`](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/renderer.ts) (Aera app), [`src/main/index.ts`](https://github.com/ethan-kisiel/aera/blob/main/src/main/index.ts) (Electron main), [`src/types/shared-types.ts`](https://github.com/ethan-kisiel/aera/blob/main/src/types/shared-types.ts) (Shared entry types), [`src/renderer/src/views/ledger-view.ts`](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/ledger-view.ts) (Ledger view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Ledger interface"]
  node_app["Aera app<br/>[renderer.ts]"]
  node_entry["Entry editor"]
  node_autocomplete["Autocomplete input"]
  node_ledger["Ledger view<br/>[ledger-view.ts]"]
  node_search["Search input<br/>[search-bar.ts]"]
  node_table["Entry table<br/>[simple-table.ts]"]
  node_year["Year selector<br/>[year-selector.ts]"]
  node_report["Expense report<br/>[report-view.ts]"]
  node_modal["App modal<br/>[app-modal.ts]"]
end

subgraph group_desktop["Desktop integration"]
  node_main["Electron main<br/>[index.ts]"]
  node_preload["IPC preload<br/>[index.ts]"]
  node_importmenu["Import menu"]
  node_importfile["JSON import<br/>[load-entries.ts]"]
end

subgraph group_native["Ledger engine"]
  node_nativeapi["Native addon API<br/>[addon.cc]"]
  node_ledgercore["Ledger operations<br/>[ledger.cc]"]
  node_repository["Ledger repository"]
  node_database[("SQLite database<br/>[database.hh]")]
end

subgraph group_shared["Shared contracts"]
  node_contracts["Shared entry types<br/>[shared-types.ts]"]
end

node_user(("Ledger user"))
node_electron["Electron runtime"]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_entry
node_app -->|"renders"| node_ledger
node_app -->|"renders"| node_report
node_app -->|"renders"| node_modal
node_entry -->|"renders"| node_autocomplete
node_ledger -->|"renders"| node_search
node_ledger -->|"renders"| node_table
node_ledger -->|"renders"| node_year
node_app -->|"invokes ledger API"| node_preload
node_preload -.->|"sends IPC"| node_main
node_main -->|"dispatches ledger calls"| node_nativeapi
node_nativeapi -->|"delegates"| node_ledgercore
node_ledgercore -->|"uses repository"| node_repository
node_repository -->|"uses storage"| node_database
node_importmenu -->|"loads entries"| node_importfile
node_main -->|"configures menu"| node_importmenu
node_main -->|"parses and imports"| node_importfile
node_electron -->|"hosts process"| node_main
node_contracts -->|"types entries"| node_app
node_contracts -->|"types entries"| node_entry
node_contracts -->|"types entries"| node_ledger
node_contracts -->|"types entries"| node_report
node_contracts -->|"types IPC"| node_main

click node_app "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/renderer.ts"
click node_entry "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/entry-input-ribbon.ts"
click node_autocomplete "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/autocomplete-input.ts"
click node_ledger "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/ledger-view.ts"
click node_search "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/search-bar.ts"
click node_table "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/simple-table.ts"
click node_year "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/year-selector.ts"
click node_report "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/report-view.ts"
click node_modal "https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/app-modal.ts"
click node_main "https://github.com/ethan-kisiel/aera/blob/main/src/main/index.ts"
click node_preload "https://github.com/ethan-kisiel/aera/blob/main/src/preload/index.ts"
click node_importmenu "https://github.com/ethan-kisiel/aera/blob/main/src/main/menu/menu-bar-template.ts"
click node_importfile "https://github.com/ethan-kisiel/aera/blob/main/src/main/menu/load-entries.ts"
click node_nativeapi "https://github.com/ethan-kisiel/aera/blob/main/src/native/addon.cc"
click node_ledgercore "https://github.com/ethan-kisiel/aera/blob/main/src/native/src/ledger/ledger.cc"
click node_repository "https://github.com/ethan-kisiel/aera/blob/main/src/native/src/ledger/ledger_repository.cc"
click node_database "https://github.com/ethan-kisiel/aera/blob/main/src/native/src/core/database.hh"
click node_contracts "https://github.com/ethan-kisiel/aera/blob/main/src/types/shared-types.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_entry,node_autocomplete,node_ledger,node_search,node_table,node_year,node_report,node_modal,node_user toneBlue
class node_main,node_preload,node_importmenu,node_importfile toneAmber
class node_nativeapi,node_ledgercore,node_repository,node_database toneMint
class node_contracts toneRose
class node_electron toneIndigo
```

## Components

### Ledger interface

- [Aera app](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/renderer.ts): `src/renderer/src/renderer.ts`
- [Entry editor](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/entry-input-ribbon.ts): `src/renderer/src/views/entry-input-ribbon.ts`
- [Autocomplete input](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/autocomplete-input.ts): `src/renderer/src/components/autocomplete-input.ts`
- [Ledger view](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/ledger-view.ts): `src/renderer/src/views/ledger-view.ts`
- [Search input](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/search-bar.ts): `src/renderer/src/components/search-bar.ts`
- [Entry table](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/simple-table.ts): `src/renderer/src/components/simple-table.ts`
- [Year selector](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/year-selector.ts): `src/renderer/src/components/year-selector.ts`
- [Expense report](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/views/report-view.ts): `src/renderer/src/views/report-view.ts`
- [App modal](https://github.com/ethan-kisiel/aera/blob/main/src/renderer/src/components/app-modal.ts): `src/renderer/src/components/app-modal.ts`

### Desktop integration

- [Electron main](https://github.com/ethan-kisiel/aera/blob/main/src/main/index.ts): `src/main/index.ts`
- [IPC preload](https://github.com/ethan-kisiel/aera/blob/main/src/preload/index.ts): `src/preload/index.ts`
- [Import menu](https://github.com/ethan-kisiel/aera/blob/main/src/main/menu/menu-bar-template.ts): `src/main/menu/menu-bar-template.ts`
- [JSON import](https://github.com/ethan-kisiel/aera/blob/main/src/main/menu/load-entries.ts): `src/main/menu/load-entries.ts`

### Ledger engine

- [Native addon API](https://github.com/ethan-kisiel/aera/blob/main/src/native/addon.cc): `src/native/addon.cc`
- [Ledger operations](https://github.com/ethan-kisiel/aera/blob/main/src/native/src/ledger/ledger.cc): `src/native/src/ledger/ledger.cc`
- [Ledger repository](https://github.com/ethan-kisiel/aera/blob/main/src/native/src/ledger/ledger_repository.cc): `src/native/src/ledger/ledger_repository.cc`
- [SQLite database](https://github.com/ethan-kisiel/aera/blob/main/src/native/src/core/database.hh): `src/native/src/core/database.hh`

### Shared contracts

- [Shared entry types](https://github.com/ethan-kisiel/aera/blob/main/src/types/shared-types.ts): `src/types/shared-types.ts`

### Other components

- **Ledger user**
- **Electron runtime**

## Connections

- Ledger user → Aera app: uses (evidence: `README.md`)
- Aera app → Entry editor: renders (evidence: `src/renderer/src/renderer.ts`)
- Aera app → Ledger view: renders (evidence: `src/renderer/src/renderer.ts`)
- Aera app → Expense report: renders (evidence: `src/renderer/src/renderer.ts`)
- Aera app → App modal: renders (evidence: `src/renderer/src/renderer.ts`)
- Entry editor → Autocomplete input: renders (evidence: `src/renderer/src/views/entry-input-ribbon.ts`)
- Ledger view → Search input: renders (evidence: `src/renderer/src/views/ledger-view.ts`)
- Ledger view → Entry table: renders (evidence: `src/renderer/src/views/ledger-view.ts`)
- Ledger view → Year selector: renders (evidence: `src/renderer/src/views/ledger-view.ts`)
- Aera app → IPC preload: invokes ledger API (evidence: `src/renderer/src/renderer.ts`)
- IPC preload → Electron main: sends IPC
- Electron main → Native addon API: dispatches ledger calls (evidence: `src/main/index.ts`)
- Native addon API → Ledger operations: delegates (evidence: `src/native/addon.cc`)
- Ledger operations → Ledger repository: uses repository (evidence: `src/native/src/ledger/ledger.cc`)
- Ledger repository → SQLite database: uses storage (evidence: `src/native/src/ledger/ledger_repository.cc`)
- Import menu → JSON import: loads entries (evidence: `src/main/index.ts`)
- Electron main → Import menu: configures menu (evidence: `src/main/index.ts`)
- Electron main → JSON import: parses and imports (evidence: `src/main/index.ts`)
- Electron runtime → Electron main: hosts process (evidence: `README.md`)
- Shared entry types → Aera app: types entries (evidence: `src/renderer/src/renderer.ts`)
- Shared entry types → Entry editor: types entries (evidence: `src/renderer/src/views/entry-input-ribbon.ts`)
- Shared entry types → Ledger view: types entries (evidence: `src/renderer/src/views/ledger-view.ts`)
- Shared entry types → Expense report: types entries (evidence: `src/renderer/src/views/report-view.ts`)
- Shared entry types → Electron main: types IPC (evidence: `src/main/index.ts`)
