# rolpppp/salin-v2 architecture

> Architecture diagram of the GitHub repository rolpppp/salin-v2, 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/rolpppp/salin-v2
- Repository: https://github.com/rolpppp/salin-v2

## Overview

Salin is a local-first personal budgeting app focused on showing what remains after budgets and obligations. Its principal documented workflow is that a user enters or pastes transaction text, AI extracts transactions for review, and the user saves them. The README also describes accounts, budgets, recurring payments, splits, debts, insights, and personalization. Dart implementation files were not sampled, so paths identify the relevant feature directories and unverified internal links are dashed.

Main entry points: [`lib/features/home/presentation/pages/home_page.dart`](https://github.com/rolpppp/salin-v2/blob/main/lib/features/home/presentation/pages/home_page.dart) (Home dashboard), [`lib/features/transactions/presentation/widgets/quick_add_view.dart`](https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/widgets/quick_add_view.dart) (Quick Add), [`lib/features/transactions/presentation/providers/transaction_review_provider.dart`](https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/providers/transaction_review_provider.dart) (Transaction review), [`lib/features/transactions/presentation/pages/transactions_page.dart`](https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/pages/transactions_page.dart) (Transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_dashboard["Home dashboard<br/>[home_page.dart]"]
  node_quickadd["Quick Add"]
  node_review["Transaction review"]
  node_insights["Insights<br/>[insights_page.dart]"]
  node_personalization["Personalization<br/>[settings_page.dart]"]
end

subgraph group_money["Money management"]
  node_transactions["Transactions"]
  node_accounts["Accounts<br/>[accounts_page.dart]"]
  node_budgets["Budgets<br/>[budgets_page.dart]"]
end

subgraph group_obligations["Obligations"]
  node_recurring["Recurring payments"]
  node_splits["Expense splits"]
  node_debts["Personal debts"]
end

subgraph group_platform["Shared platform"]
  node_ai["AI extraction<br/>[ai_service.dart]"]
  node_localdata[("Local database<br/>[database.dart]")]
  node_sync["Cloud sync<br/>[sync_service.dart]"]
end

node_user(("User"))

node_user -->|"enters text"| node_quickadd
node_quickadd -->|"extracts transactions"| node_ai
node_ai -->|"presents for review"| node_review
node_review -->|"saves transactions"| node_transactions
node_user -->|"checks what's left"| node_dashboard
node_dashboard -->|"shows remaining budget"| node_budgets
node_dashboard -->|"shows upcoming bills"| node_recurring
node_dashboard -->|"shows pending splits"| node_splits
node_dashboard -->|"shows outstanding debts"| node_debts
node_dashboard -->|"shows insights"| node_insights
node_user -->|"manages accounts"| node_accounts
node_user -->|"creates budgets"| node_budgets
node_user -->|"manages payments"| node_recurring
node_user -->|"tracks shared costs"| node_splits
node_user -->|"tracks loans"| node_debts
node_user -->|"customizes app"| node_personalization
node_transactions -.->|"persists locally"| node_localdata
node_localdata -.->|"syncs data"| node_sync

click node_dashboard "https://github.com/rolpppp/salin-v2/blob/main/lib/features/home/presentation/pages/home_page.dart"
click node_quickadd "https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/widgets/quick_add_view.dart"
click node_review "https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/providers/transaction_review_provider.dart"
click node_transactions "https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/pages/transactions_page.dart"
click node_accounts "https://github.com/rolpppp/salin-v2/blob/main/lib/features/accounts/presentation/pages/accounts_page.dart"
click node_budgets "https://github.com/rolpppp/salin-v2/blob/main/lib/features/budgets/presentation/pages/budgets_page.dart"
click node_recurring "https://github.com/rolpppp/salin-v2/blob/main/lib/features/recurring/presentation/pages/recurring_page.dart"
click node_splits "https://github.com/rolpppp/salin-v2/blob/main/lib/features/splits/presentation/pages/splits_debts_page.dart"
click node_debts "https://github.com/rolpppp/salin-v2/blob/main/lib/features/debts/presentation/providers/debt_providers.dart"
click node_insights "https://github.com/rolpppp/salin-v2/blob/main/lib/features/insights/presentation/pages/insights_page.dart"
click node_personalization "https://github.com/rolpppp/salin-v2/blob/main/lib/features/settings/presentation/pages/settings_page.dart"
click node_ai "https://github.com/rolpppp/salin-v2/blob/main/lib/core/ai/ai_service.dart"
click node_localdata "https://github.com/rolpppp/salin-v2/blob/main/lib/core/database/database.dart"
click node_sync "https://github.com/rolpppp/salin-v2/blob/main/lib/core/services/sync/sync_service.dart"

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_dashboard,node_quickadd,node_review,node_insights,node_personalization,node_user toneBlue
class node_transactions,node_accounts,node_budgets toneAmber
class node_recurring,node_splits,node_debts toneMint
class node_ai,node_localdata,node_sync toneRose
```

## Components

### App experience

- [Home dashboard](https://github.com/rolpppp/salin-v2/blob/main/lib/features/home/presentation/pages/home_page.dart): `lib/features/home/presentation/pages/home_page.dart`
- [Quick Add](https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/widgets/quick_add_view.dart): `lib/features/transactions/presentation/widgets/quick_add_view.dart`
- [Transaction review](https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/providers/transaction_review_provider.dart): `lib/features/transactions/presentation/providers/transaction_review_provider.dart`
- [Insights](https://github.com/rolpppp/salin-v2/blob/main/lib/features/insights/presentation/pages/insights_page.dart): `lib/features/insights/presentation/pages/insights_page.dart`
- [Personalization](https://github.com/rolpppp/salin-v2/blob/main/lib/features/settings/presentation/pages/settings_page.dart): `lib/features/settings/presentation/pages/settings_page.dart`

### Money management

- [Transactions](https://github.com/rolpppp/salin-v2/blob/main/lib/features/transactions/presentation/pages/transactions_page.dart): `lib/features/transactions/presentation/pages/transactions_page.dart`
- [Accounts](https://github.com/rolpppp/salin-v2/blob/main/lib/features/accounts/presentation/pages/accounts_page.dart): `lib/features/accounts/presentation/pages/accounts_page.dart`
- [Budgets](https://github.com/rolpppp/salin-v2/blob/main/lib/features/budgets/presentation/pages/budgets_page.dart): `lib/features/budgets/presentation/pages/budgets_page.dart`

### Obligations

- [Recurring payments](https://github.com/rolpppp/salin-v2/blob/main/lib/features/recurring/presentation/pages/recurring_page.dart): `lib/features/recurring/presentation/pages/recurring_page.dart`
- [Expense splits](https://github.com/rolpppp/salin-v2/blob/main/lib/features/splits/presentation/pages/splits_debts_page.dart): `lib/features/splits/presentation/pages/splits_debts_page.dart`
- [Personal debts](https://github.com/rolpppp/salin-v2/blob/main/lib/features/debts/presentation/providers/debt_providers.dart): `lib/features/debts/presentation/providers/debt_providers.dart`

### Shared platform

- [AI extraction](https://github.com/rolpppp/salin-v2/blob/main/lib/core/ai/ai_service.dart): `lib/core/ai/ai_service.dart`
- [Local database](https://github.com/rolpppp/salin-v2/blob/main/lib/core/database/database.dart): `lib/core/database/database.dart`
- [Cloud sync](https://github.com/rolpppp/salin-v2/blob/main/lib/core/services/sync/sync_service.dart): `lib/core/services/sync/sync_service.dart`

### Other components

- **User**

## Connections

- User → Quick Add: enters text (evidence: `README.md`)
- Quick Add → AI extraction: extracts transactions (evidence: `README.md`)
- AI extraction → Transaction review: presents for review (evidence: `README.md`)
- Transaction review → Transactions: saves transactions (evidence: `README.md`)
- User → Home dashboard: checks what's left (evidence: `README.md`)
- Home dashboard → Budgets: shows remaining budget (evidence: `README.md`)
- Home dashboard → Recurring payments: shows upcoming bills (evidence: `README.md`)
- Home dashboard → Expense splits: shows pending splits (evidence: `README.md`)
- Home dashboard → Personal debts: shows outstanding debts (evidence: `README.md`)
- Home dashboard → Insights: shows insights (evidence: `README.md`)
- User → Accounts: manages accounts (evidence: `README.md`)
- User → Budgets: creates budgets (evidence: `README.md`)
- User → Recurring payments: manages payments (evidence: `README.md`)
- User → Expense splits: tracks shared costs (evidence: `README.md`)
- User → Personal debts: tracks loans (evidence: `README.md`)
- User → Personalization: customizes app (evidence: `README.md`)
- Transactions → Local database: persists locally
- Local database → Cloud sync: syncs data
