# passionchips/vise architecture

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

- Interactive diagram: https://gitdiagram.com/passionchips/vise
- Repository: https://github.com/passionchips/vise

## Overview

VISE is an offline-first monthly budgeting app: users set up preferences and budgets, record or import transactions, then review summaries, warnings, reports, and spending predictions. The React Native screens call a typed client, which forwards requests through the Expo native bridge to Rust; Rust validates and coordinates repository and calculation work over local SQLite. The README documents this layer flow. Some route and feature implementations were not sampled, so their internal connections are shown only where documented; optional integrations are not inferred.

Main entry points: [`vise-app/src/services/viseCore.ts`](https://github.com/passionchips/vise/blob/main/vise-app/src/services/viseCore.ts) (Typed API client), [`vise-app/app/(tabs)/transactions.tsx`](https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/transactions.tsx) (Transactions), [`vise-app/rust-core/src/repository`](https://github.com/passionchips/vise/tree/main/vise-app/rust-core/src/repository) (Data repositories), [`vise-app/rust-core/src/service.rs`](https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/service.rs) (Validation and use cases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["App experience"]
  node_onboarding["Onboarding"]
  node_dashboard["Dashboard<br/>[index.tsx]"]
  node_transactions["Transactions<br/>[transactions.tsx]"]
  node_transaction_form["Transaction form"]
  node_budgets["Budgets<br/>[budgets.tsx]"]
  node_budget_form["Budget form<br/>[budget-form.tsx]"]
  node_reports["Reports<br/>[reports.tsx]"]
  node_settings["Settings<br/>[settings.tsx]"]
end

subgraph group_client["Client and bridge"]
  node_client_api["Typed API client<br/>[viseCore.ts]"]
  node_query_store["Query and refresh<br/>[store.ts]"]
  node_native_bridge["Native bridge"]
end

subgraph group_domain["Rust domain"]
  node_importer["CSV import<br/>[import_csv.rs]"]
  node_api["JSON dispatch<br/>[api.rs]"]
  node_service["Validation and use cases<br/>[service.rs]"]
  node_calculations["Budget analytics"]
end

subgraph group_storage["Local persistence"]
  node_repositories["Data repositories"]
  node_models_schema["Models and schema<br/>[schema.rs]"]
  node_connection["SQLite connection<br/>[connection.rs]"]
  node_sqlite[("Device SQLite")]
end

node_user(("Budget user"))

node_user -->|"sets up"| node_onboarding
node_user -->|"reviews finances"| node_dashboard
node_user -->|"manages entries"| node_transactions
node_user -->|"sets limits"| node_budgets
node_user -->|"views reports"| node_reports
node_user -->|"manages settings"| node_settings
node_transactions -->|"opens form"| node_transaction_form
node_budgets -->|"opens form"| node_budget_form
node_dashboard -->|"loads data"| node_query_store
node_transactions -->|"loads data"| node_query_store
node_transactions -->|"requests changes"| node_client_api
node_transaction_form -->|"submits transaction"| node_client_api
node_budget_form -->|"saves budget"| node_client_api
node_settings -->|"reads and saves"| node_client_api
node_onboarding -->|"saves setup"| node_client_api
node_reports -->|"requests reports"| node_client_api
node_client_api -->|"forwards calls"| node_native_bridge
node_client_api -->|"invalidates after writes"| node_query_store
node_native_bridge -->|"dispatches request"| node_api
node_api -->|"calls use cases"| node_service
node_service -->|"loads and saves"| node_repositories
node_service -->|"computes results"| node_calculations
node_repositories -->|"queries mapped rows"| node_models_schema
node_repositories -->|"uses connection"| node_connection
node_connection -->|"opens and migrates"| node_sqlite
node_importer -.->|"imports transactions"| node_repositories

click node_onboarding "https://github.com/passionchips/vise/tree/main/vise-app/src/features/onboarding"
click node_dashboard "https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/index.tsx"
click node_transactions "https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/transactions.tsx"
click node_transaction_form "https://github.com/passionchips/vise/blob/main/vise-app/app/add-transaction.tsx"
click node_budgets "https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/budgets.tsx"
click node_budget_form "https://github.com/passionchips/vise/blob/main/vise-app/app/budget-form.tsx"
click node_reports "https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/reports.tsx"
click node_settings "https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/settings.tsx"
click node_importer "https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/parser/import_csv.rs"
click node_client_api "https://github.com/passionchips/vise/blob/main/vise-app/src/services/viseCore.ts"
click node_query_store "https://github.com/passionchips/vise/blob/main/vise-app/src/data/store.ts"
click node_native_bridge "https://github.com/passionchips/vise/tree/main/vise-app/modules/vise-core"
click node_api "https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/api.rs"
click node_service "https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/service.rs"
click node_calculations "https://github.com/passionchips/vise/tree/main/vise-app/rust-core/src/calculations"
click node_repositories "https://github.com/passionchips/vise/tree/main/vise-app/rust-core/src/repository"
click node_models_schema "https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/db/schema.rs"
click node_connection "https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/db/connection.rs"

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_onboarding,node_dashboard,node_transactions,node_transaction_form,node_budgets,node_budget_form,node_reports,node_settings,node_user toneBlue
class node_client_api,node_query_store,node_native_bridge toneAmber
class node_importer,node_api,node_service,node_calculations toneMint
class node_repositories,node_models_schema,node_connection,node_sqlite toneRose
```

## Components

### App experience

- [Onboarding](https://github.com/passionchips/vise/tree/main/vise-app/src/features/onboarding): `vise-app/src/features/onboarding`
- [Dashboard](https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/index.tsx): `vise-app/app/(tabs)/index.tsx`
- [Transactions](https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/transactions.tsx): `vise-app/app/(tabs)/transactions.tsx`
- [Transaction form](https://github.com/passionchips/vise/blob/main/vise-app/app/add-transaction.tsx): `vise-app/app/add-transaction.tsx`
- [Budgets](https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/budgets.tsx): `vise-app/app/(tabs)/budgets.tsx`
- [Budget form](https://github.com/passionchips/vise/blob/main/vise-app/app/budget-form.tsx): `vise-app/app/budget-form.tsx`
- [Reports](https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/reports.tsx): `vise-app/app/(tabs)/reports.tsx`
- [Settings](https://github.com/passionchips/vise/blob/main/vise-app/app/(tabs)/settings.tsx): `vise-app/app/(tabs)/settings.tsx`

### Client and bridge

- [Typed API client](https://github.com/passionchips/vise/blob/main/vise-app/src/services/viseCore.ts): `vise-app/src/services/viseCore.ts`
- [Query and refresh](https://github.com/passionchips/vise/blob/main/vise-app/src/data/store.ts): `vise-app/src/data/store.ts`
- [Native bridge](https://github.com/passionchips/vise/tree/main/vise-app/modules/vise-core): `vise-app/modules/vise-core`

### Rust domain

- [CSV import](https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/parser/import_csv.rs): `vise-app/rust-core/src/parser/import_csv.rs`
- [JSON dispatch](https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/api.rs): `vise-app/rust-core/src/api.rs`
- [Validation and use cases](https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/service.rs): `vise-app/rust-core/src/service.rs`
- [Budget analytics](https://github.com/passionchips/vise/tree/main/vise-app/rust-core/src/calculations): `vise-app/rust-core/src/calculations`

### Local persistence

- [Data repositories](https://github.com/passionchips/vise/tree/main/vise-app/rust-core/src/repository): `vise-app/rust-core/src/repository`
- [Models and schema](https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/db/schema.rs): `vise-app/rust-core/src/db/schema.rs`
- [SQLite connection](https://github.com/passionchips/vise/blob/main/vise-app/rust-core/src/db/connection.rs): `vise-app/rust-core/src/db/connection.rs`
- **Device SQLite**

### Other components

- **Budget user**

## Connections

- Budget user → Onboarding: sets up
- Budget user → Dashboard: reviews finances
- Budget user → Transactions: manages entries
- Budget user → Budgets: sets limits
- Budget user → Reports: views reports
- Budget user → Settings: manages settings
- Transactions → Transaction form: opens form (evidence: `vise-app/app/(tabs)/transactions.tsx`)
- Budgets → Budget form: opens form
- Dashboard → Query and refresh: loads data (evidence: `vise-app/app/(tabs)/index.tsx`)
- Transactions → Query and refresh: loads data (evidence: `vise-app/app/(tabs)/transactions.tsx`)
- Transactions → Typed API client: requests changes (evidence: `vise-app/app/(tabs)/transactions.tsx`)
- Transaction form → Typed API client: submits transaction (evidence: `vise-app/app/add-transaction.tsx`)
- Budget form → Typed API client: saves budget (evidence: `vise-app/app/budget-form.tsx`)
- Settings → Typed API client: reads and saves (evidence: `vise-app/app/(tabs)/settings.tsx`)
- Onboarding → Typed API client: saves setup
- Reports → Typed API client: requests reports
- Typed API client → Native bridge: forwards calls (evidence: `vise-app/src/services/viseCore.ts`)
- Typed API client → Query and refresh: invalidates after writes (evidence: `vise-app/src/services/viseCore.ts`)
- Native bridge → JSON dispatch: dispatches request
- JSON dispatch → Validation and use cases: calls use cases
- Validation and use cases → Data repositories: loads and saves (evidence: `vise-app/rust-core/src/service.rs`)
- Validation and use cases → Budget analytics: computes results (evidence: `vise-app/rust-core/src/service.rs`)
- Data repositories → Models and schema: queries mapped rows (evidence: `vise-app/rust-core/src/repository/transaction_repository.rs`)
- Data repositories → SQLite connection: uses connection (evidence: `vise-app/rust-core/src/repository/transaction_repository.rs`)
- SQLite connection → Device SQLite: opens and migrates (evidence: `vise-app/rust-core/src/db/connection.rs`)
- CSV import → Data repositories: imports transactions
