# blvcksamurai/mobile_wallet architecture

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

- Interactive diagram: https://gitdiagram.com/blvcksamurai/mobile_wallet
- Repository: https://github.com/blvcksamurai/mobile_wallet

## Overview

Mobile Wallet is a Flutter personal-finance UI for reviewing financial activity and organizing spending. The apparent user workflow is entering the app, viewing a budget overview, then exploring expense categories, transactions, and financial articles. The README also describes income/expense tracking, activity visualization, and monitoring spending and goals. Flutter/Dart implementation excerpts were not provided, so screen routing and data flow are not verified; dashed, uncited edges indicate only the likely navigation structure. No persistent store or external finance service is evidenced.

Main entry points: [`lib/src/features/budget/budget_home/budget_home.dart`](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/budget_home.dart) (Budget overview), [`lib/main.dart`](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/main.dart) (Flutter entry), [`lib/src/features/budget/budget_home/expense_categories_screen.dart`](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/expense_categories_screen.dart) (Expense categories), [`lib/src/features/budget/budget_home/recent_transactions_screen.dart`](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/recent_transactions_screen.dart) (Recent transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App entry"]
  node_entry["Flutter entry<br/>[main.dart]"]
end

subgraph group_finance["Finance views"]
  node_overview["Budget overview<br/>[budget_home.dart]"]
  node_categories["Expense categories"]
  node_transactions["Recent transactions"]
  node_articles["Financial articles"]
end

subgraph group_shared["Shared presentation"]
  node_expense_model["Category data"]
  node_transaction_model["Transaction data"]
  node_flow_model["Money flow data<br/>[money_flow.dart]"]
  node_bill_model["Upcoming bills data"]
  node_article_model["Article data"]
  node_flow_chart["Money flow chart"]
  node_bar_chart["Bar chart"]
  node_spending_bar["Spending progress"]
  node_category_item["Category item"]
  node_transaction_item["Transaction item"]
  node_bill_item["Upcoming bill item"]
  node_article_item["Article item<br/>[articles_item.dart]"]
end

node_user(("Wallet user"))

node_user -->|"uses"| node_entry
node_entry -.->|"likely opens"| node_overview
node_overview -.->|"likely navigates"| node_categories
node_overview -.->|"likely navigates"| node_transactions
node_overview -.->|"likely navigates"| node_articles

click node_entry "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/main.dart"
click node_overview "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/budget_home.dart"
click node_categories "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/expense_categories_screen.dart"
click node_transactions "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/recent_transactions_screen.dart"
click node_articles "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/articles_screen.dart"
click node_expense_model "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/expense_categories_model.dart"
click node_transaction_model "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/recent_transactions_model.dart"
click node_flow_model "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/money_flow.dart"
click node_bill_model "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/upcoming_bills_model.dart"
click node_article_model "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/articles_model.dart"
click node_flow_chart "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/money_flow_chart.dart"
click node_bar_chart "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/custom_bar_chart.dart"
click node_spending_bar "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/spending_progress_bar.dart"
click node_category_item "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/expense_category_item.dart"
click node_transaction_item "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/recent_transaction_item.dart"
click node_bill_item "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/upcoming_bills_item.dart"
click node_article_item "https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/articles_item.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_entry,node_user toneBlue
class node_overview,node_categories,node_transactions,node_articles toneAmber
class node_expense_model,node_transaction_model,node_flow_model,node_bill_model,node_article_model,node_flow_chart,node_bar_chart,node_spending_bar,node_category_item,node_transaction_item,node_bill_item,node_article_item toneMint
```

## Components

### App entry

- [Flutter entry](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/main.dart): `lib/main.dart`

### Finance views

- [Budget overview](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/budget_home.dart): `lib/src/features/budget/budget_home/budget_home.dart`
- [Expense categories](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/expense_categories_screen.dart): `lib/src/features/budget/budget_home/expense_categories_screen.dart`
- [Recent transactions](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/recent_transactions_screen.dart): `lib/src/features/budget/budget_home/recent_transactions_screen.dart`
- [Financial articles](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/features/budget/budget_home/articles_screen.dart): `lib/src/features/budget/budget_home/articles_screen.dart`

### Shared presentation

- [Category data](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/expense_categories_model.dart): `lib/src/common/models/expense_categories_model.dart`
- [Transaction data](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/recent_transactions_model.dart): `lib/src/common/models/recent_transactions_model.dart`
- [Money flow data](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/money_flow.dart): `lib/src/common/models/money_flow.dart`
- [Upcoming bills data](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/upcoming_bills_model.dart): `lib/src/common/models/upcoming_bills_model.dart`
- [Article data](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/models/articles_model.dart): `lib/src/common/models/articles_model.dart`
- [Money flow chart](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/money_flow_chart.dart): `lib/src/common/widgets/money_flow_chart.dart`
- [Bar chart](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/custom_bar_chart.dart): `lib/src/common/widgets/custom_bar_chart.dart`
- [Spending progress](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/spending_progress_bar.dart): `lib/src/common/widgets/spending_progress_bar.dart`
- [Category item](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/expense_category_item.dart): `lib/src/common/widgets/expense_category_item.dart`
- [Transaction item](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/recent_transaction_item.dart): `lib/src/common/widgets/recent_transaction_item.dart`
- [Upcoming bill item](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/upcoming_bills_item.dart): `lib/src/common/widgets/upcoming_bills_item.dart`
- [Article item](https://github.com/blvcksamurai/mobile_wallet/blob/main/lib/src/common/widgets/articles_item.dart): `lib/src/common/widgets/articles_item.dart`

### Other components

- **Wallet user**

## Connections

- Wallet user → Flutter entry: uses (evidence: `README.md`)
- Flutter entry → Budget overview: likely opens
- Budget overview → Expense categories: likely navigates
- Budget overview → Recent transactions: likely navigates
- Budget overview → Financial articles: likely navigates
