# ehsan-alrz/accounting-mobile-app-reactnative architecture

> Architecture diagram of the GitHub repository ehsan-alrz/accounting-mobile-app-reactnative, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ehsan-alrz/accounting-mobile-app-reactnative
- Repository: https://github.com/ehsan-alrz/accounting-mobile-app-reactnative

## Overview

Ledgerly is an early Arabic-first RTL accounting-app prototype. The implemented user journey is opening the app to a themed home dashboard with a cash balance, receivable/payable KPIs, and recent activity; tab controls are present, but only Home is implemented. The graph includes the shared UI and theme layer. The README describes future invoice and reporting capabilities, but these are roadmap items, not implemented runtime subsystems.

Main entry points: [`src/theme/ThemeProvider.tsx`](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/ThemeProvider.tsx) (Theme provider), [`src/screens/HomeScreen.tsx`](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/screens/HomeScreen.tsx) (Home screen), [`src/components/AppText.tsx`](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/AppText.tsx) (Themed text), [`src/app/App.tsx`](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/app/App.tsx) (App root)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_app_root["App root<br/>[App.tsx]"]
end

subgraph group_dashboard["Home dashboard"]
  node_home["Home screen<br/>[HomeScreen.tsx]"]
end

subgraph group_ui["Reusable UI"]
  node_tabbar["Tab bar<br/>[TabBar.tsx]"]
  node_hero["Balance card<br/>[HeroBalance.tsx]"]
  node_kpi["KPI card<br/>[KpiCard.tsx]"]
  node_listrow["Activity row<br/>[ListRow.tsx]"]
  node_section["Section header<br/>[SectionHeader.tsx]"]
  node_card["Card surface<br/>[Card.tsx]"]
  node_fab["Floating action<br/>[Fab.tsx]"]
  node_amount["Money display<br/>[Amount.tsx]"]
  node_apptext["Themed text<br/>[AppText.tsx]"]
  node_button["Button<br/>[Button.tsx]"]
  node_status["Status badge<br/>[StatusBadge.tsx]"]
end

subgraph group_theme["Theme system"]
  node_theme_provider["Theme provider<br/>[ThemeProvider.tsx]"]
  node_tokens["Design tokens<br/>[tokens.ts]"]
  node_styles["Theme styles hook<br/>[useStyles.ts]"]
end

node_user(("User"))
node_storage[("Async storage")]
node_device["Device appearance"]

node_user -->|"opens"| node_app_root
node_app_root -->|"wraps"| node_theme_provider
node_app_root -->|"renders"| node_home
node_app_root -->|"renders"| node_tabbar
node_home -->|"renders"| node_hero
node_home -->|"renders"| node_kpi
node_home -->|"renders"| node_section
node_home -->|"renders"| node_card
node_home -->|"renders"| node_listrow
node_home -->|"renders"| node_fab
node_hero -->|"renders"| node_amount
node_listrow -->|"renders"| node_amount
node_listrow -->|"renders"| node_apptext
node_kpi -->|"renders"| node_amount
node_kpi -->|"renders"| node_card
node_kpi -->|"renders"| node_apptext
node_section -->|"renders"| node_apptext
node_fab -->|"renders"| node_apptext
node_tabbar -->|"renders"| node_apptext
node_app_root -->|"selects tabs"| node_tabbar
node_theme_provider -->|"uses colors"| node_tokens
node_theme_provider -->|"reads and writes"| node_storage
node_theme_provider -->|"reads scheme"| node_device
node_styles -->|"reads theme"| node_theme_provider
node_amount -->|"reads theme"| node_theme_provider
node_apptext -->|"reads theme"| node_theme_provider
node_button -->|"reads theme"| node_theme_provider
node_status -->|"reads theme"| node_theme_provider

click node_app_root "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/app/App.tsx"
click node_home "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/screens/HomeScreen.tsx"
click node_tabbar "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/TabBar.tsx"
click node_hero "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/HeroBalance.tsx"
click node_kpi "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/KpiCard.tsx"
click node_listrow "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/ListRow.tsx"
click node_section "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/SectionHeader.tsx"
click node_card "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Card.tsx"
click node_fab "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Fab.tsx"
click node_amount "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Amount.tsx"
click node_apptext "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/AppText.tsx"
click node_button "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Button.tsx"
click node_status "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/StatusBadge.tsx"
click node_theme_provider "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/ThemeProvider.tsx"
click node_tokens "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/tokens.ts"
click node_styles "https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/useStyles.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_root,node_user toneBlue
class node_home,node_storage toneAmber
class node_tabbar,node_hero,node_kpi,node_listrow,node_section,node_card,node_fab,node_amount,node_apptext,node_button,node_status toneMint
class node_theme_provider,node_tokens,node_styles toneRose
class node_device toneIndigo
```

## Components

### App shell

- [App root](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/app/App.tsx): `src/app/App.tsx`

### Home dashboard

- [Home screen](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/screens/HomeScreen.tsx): `src/screens/HomeScreen.tsx`

### Reusable UI

- [Tab bar](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/TabBar.tsx): `src/components/TabBar.tsx`
- [Balance card](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/HeroBalance.tsx): `src/components/HeroBalance.tsx`
- [KPI card](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/KpiCard.tsx): `src/components/KpiCard.tsx`
- [Activity row](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/ListRow.tsx): `src/components/ListRow.tsx`
- [Section header](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/SectionHeader.tsx): `src/components/SectionHeader.tsx`
- [Card surface](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Card.tsx): `src/components/Card.tsx`
- [Floating action](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Fab.tsx): `src/components/Fab.tsx`
- [Money display](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Amount.tsx): `src/components/Amount.tsx`
- [Themed text](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/AppText.tsx): `src/components/AppText.tsx`
- [Button](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/Button.tsx): `src/components/Button.tsx`
- [Status badge](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/components/StatusBadge.tsx): `src/components/StatusBadge.tsx`

### Theme system

- [Theme provider](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/ThemeProvider.tsx): `src/theme/ThemeProvider.tsx`
- [Design tokens](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/tokens.ts): `src/theme/tokens.ts`
- [Theme styles hook](https://github.com/ehsan-alrz/accounting-mobile-app-reactnative/blob/main/src/theme/useStyles.ts): `src/theme/useStyles.ts`

### Other components

- **User**
- **Async storage**
- **Device appearance**

## Connections

- User → App root: opens (evidence: `README.md`)
- App root → Theme provider: wraps (evidence: `src/app/App.tsx`)
- App root → Home screen: renders (evidence: `src/app/App.tsx`)
- App root → Tab bar: renders (evidence: `src/app/App.tsx`)
- Home screen → Balance card: renders (evidence: `src/screens/HomeScreen.tsx`)
- Home screen → KPI card: renders (evidence: `src/screens/HomeScreen.tsx`)
- Home screen → Section header: renders (evidence: `src/screens/HomeScreen.tsx`)
- Home screen → Card surface: renders (evidence: `src/screens/HomeScreen.tsx`)
- Home screen → Activity row: renders (evidence: `src/screens/HomeScreen.tsx`)
- Home screen → Floating action: renders (evidence: `src/screens/HomeScreen.tsx`)
- Balance card → Money display: renders (evidence: `src/components/HeroBalance.tsx`)
- Activity row → Money display: renders (evidence: `src/components/ListRow.tsx`)
- Activity row → Themed text: renders (evidence: `src/components/ListRow.tsx`)
- KPI card → Money display: renders (evidence: `src/components/KpiCard.tsx`)
- KPI card → Card surface: renders (evidence: `src/components/KpiCard.tsx`)
- KPI card → Themed text: renders (evidence: `src/components/KpiCard.tsx`)
- Section header → Themed text: renders (evidence: `src/components/SectionHeader.tsx`)
- Floating action → Themed text: renders (evidence: `src/components/Fab.tsx`)
- Tab bar → Themed text: renders (evidence: `src/components/TabBar.tsx`)
- App root → Tab bar: selects tabs (evidence: `src/app/App.tsx`)
- Theme provider → Design tokens: uses colors (evidence: `src/theme/ThemeProvider.tsx`)
- Theme provider → Async storage: reads and writes (evidence: `src/theme/ThemeProvider.tsx`)
- Theme provider → Device appearance: reads scheme (evidence: `src/theme/ThemeProvider.tsx`)
- Theme styles hook → Theme provider: reads theme (evidence: `src/theme/useStyles.ts`)
- Money display → Theme provider: reads theme (evidence: `src/components/Amount.tsx`)
- Themed text → Theme provider: reads theme (evidence: `src/components/AppText.tsx`)
- Button → Theme provider: reads theme (evidence: `src/components/Button.tsx`)
- Status badge → Theme provider: reads theme (evidence: `src/components/StatusBadge.tsx`)
