# harshp2405/mobileexpense architecture

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

- Interactive diagram: https://gitdiagram.com/harshp2405/mobileexpense
- Repository: https://github.com/harshp2405/mobileexpense

## Overview

This Expo app is a personal finance tracker: users record expenses and fuel, manage budgets and related financial records, then review spending and income analytics. Local SQLite-backed query logic supplies the app; optional workflows export/import data, synchronize records with a remote API, and back up or restore through Google Drive. The graph follows documented imports and sampled calls; unsampled screens and services are represented only where the source index supports their existence, so some connections are intentionally omitted.

Main entry points: [`src/app/(tabs)/index.jsx`](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/index.jsx) (Expense tracking), [`src/lib/db/queries.js`](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/queries.js) (Finance queries), [`src/lib/sync/syncManager.js`](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/sync/syncManager.js) (Remote sync), [`src/lib/backup/restoreService.js`](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/restoreService.js) (Restore service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_finance["Finance Tracking"]
  node_expense_screen["Expense tracking<br/>[index.jsx]"]
  node_fuel_screen["Fuel tracking<br/>[Fuel.jsx]"]
  node_budget_screen["Budget management<br/>[budgets.jsx]"]
  node_category_screen["Category management<br/>[categories.jsx]"]
  node_account_screen["Accounts<br/>[accounts.jsx]"]
end

subgraph group_insights["Analytics"]
  node_analytics_screen["Analytics views<br/>[index.jsx]"]
  node_analytics_detail["Analytics details<br/>[DataShow.jsx]"]
  node_analytics_hook["Analytics data hook"]
  node_analytics_engine["Analytics calculations"]
end

subgraph group_data["Data and Sync"]
  node_queries["Finance queries<br/>[queries.js]"]
  node_db_client["SQLite client<br/>[client.js]"]
  node_db_schema["Finance schema<br/>[schema.js]"]
  node_sync["Remote sync<br/>[syncManager.js]"]
end

subgraph group_support["Privacy and Backup"]
  node_backup_ui["Backup controls<br/>[BackupScreen.jsx]"]
  node_backup_service["Backup service<br/>[backupService.js]"]
  node_restore_service["Restore service<br/>[restoreService.js]"]
  node_drive_auth["Google authorization<br/>[googleAuth.js]"]
  node_drive_service["Google Drive access<br/>[googleDrive.js]"]
  node_privacy["Privacy mode<br/>[usePrivacyMode.js]"]
  node_biometric["Biometric lock"]
  node_storage[("Preference storage<br/>[storage.js]")]
  node_app_shell["App shell<br/>[_layout.jsx]"]
  node_settings["User settings<br/>[UserSettings.jsx]"]
end

subgraph group_capture["Capture and Export"]
  node_receipt_picker["Receipt picker<br/>[ReceiptPicker.jsx]"]
  node_image_manager["Receipt image storage<br/>[imageManager.js]"]
  node_ocr["Receipt OCR<br/>[receiptOcr.js]"]
  node_parser["Transaction parser"]
  node_excel_export["Excel export<br/>[exportExcel.js]"]
  node_excel_import["Excel import<br/>[importExcel.js]"]
  node_pdf_export["PDF export<br/>[pdfExporter.js]"]
end

node_user(("Finance user"))
node_sync_api{{"Sync API"}}
node_drive{{"Google Drive"}}

node_user -->|"records expenses"| node_expense_screen
node_expense_screen -->|"reads and writes"| node_queries
node_user -->|"records fuel"| node_fuel_screen
node_fuel_screen -->|"uses queries"| node_queries
node_budget_screen -.->|"uses queries"| node_queries
node_category_screen -.->|"uses queries"| node_queries
node_account_screen -.->|"uses queries"| node_queries
node_queries -->|"uses database"| node_db_client
node_queries -->|"queries tables"| node_db_schema
node_analytics_screen -->|"loads analytics"| node_analytics_hook
node_analytics_detail -->|"loads analytics"| node_analytics_hook
node_analytics_hook -->|"loads finance data"| node_queries
node_analytics_hook -->|"calculates metrics"| node_analytics_engine
node_expense_screen -->|"runs sync"| node_sync
node_sync -->|"reads and writes"| node_db_client
node_sync -->|"syncs tables"| node_db_schema
node_sync -->|"persists sync time"| node_storage
node_sync -->|"exchanges records"| node_sync_api
node_expense_screen -->|"opens picker"| node_receipt_picker
node_receipt_picker -->|"saves images"| node_image_manager
node_queries -->|"deletes receipt files"| node_image_manager
node_expense_screen -->|"extracts receipt text"| node_ocr
node_expense_screen -->|"parses transactions"| node_parser
node_expense_screen -->|"exports expenses"| node_excel_export
node_expense_screen -->|"imports expenses"| node_excel_import
node_expense_screen -->|"exports report"| node_pdf_export
node_user -->|"manages backups"| node_backup_ui
node_backup_ui -->|"requests backup"| node_backup_service
node_backup_ui -->|"requests restore"| node_restore_service
node_backup_service -->|"gets access token"| node_drive_auth
node_backup_service -->|"uploads backup"| node_drive_service
node_restore_service -->|"gets access token"| node_drive_auth
node_restore_service -->|"downloads backup"| node_drive_service
node_drive_service -->|"accesses files"| node_drive
node_restore_service -->|"restores records"| node_db_client
node_restore_service -->|"inserts tables"| node_db_schema
node_app_shell -->|"provides privacy state"| node_privacy
node_app_shell -->|"checks app lock"| node_biometric
node_biometric -->|"persists lock setting"| node_storage
node_privacy -->|"persists preference"| node_storage
node_settings -.->|"offers backup controls"| node_backup_ui

click node_expense_screen "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/index.jsx"
click node_fuel_screen "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/Fuel.jsx"
click node_budget_screen "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/budgets.jsx"
click node_category_screen "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/categories.jsx"
click node_account_screen "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/accounts.jsx"
click node_queries "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/queries.js"
click node_db_client "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/client.js"
click node_db_schema "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/schema.js"
click node_analytics_screen "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabt)/index.jsx"
click node_analytics_detail "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabt)/DataShow.jsx"
click node_analytics_hook "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/hooks/useAnalyticsData.js"
click node_analytics_engine "https://github.com/harshp2405/mobileexpense/tree/main/src/lib/analytics"
click node_sync "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/sync/syncManager.js"
click node_receipt_picker "https://github.com/harshp2405/mobileexpense/blob/main/src/components/ReceiptPicker.jsx"
click node_image_manager "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/utils/imageManager.js"
click node_ocr "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/features/receiptOcr.js"
click node_parser "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/features/transactionParser.js"
click node_excel_export "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/excel/exportExcel.js"
click node_excel_import "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/excel/importExcel.js"
click node_pdf_export "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/utils/pdfExporter.js"
click node_backup_ui "https://github.com/harshp2405/mobileexpense/blob/main/src/components/BackupScreen.jsx"
click node_backup_service "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/backupService.js"
click node_restore_service "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/restoreService.js"
click node_drive_auth "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/googleAuth.js"
click node_drive_service "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/googleDrive.js"
click node_privacy "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/privacy/usePrivacyMode.js"
click node_biometric "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/auth/useBiometricAuth.js"
click node_storage "https://github.com/harshp2405/mobileexpense/blob/main/src/lib/utils/storage.js"
click node_app_shell "https://github.com/harshp2405/mobileexpense/blob/main/src/app/_layout.jsx"
click node_settings "https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabt)/UserSettings.jsx"

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_expense_screen,node_fuel_screen,node_budget_screen,node_category_screen,node_account_screen,node_user toneBlue
class node_analytics_screen,node_analytics_detail,node_analytics_hook,node_analytics_engine toneAmber
class node_queries,node_db_client,node_db_schema,node_sync,node_sync_api toneMint
class node_backup_ui,node_backup_service,node_restore_service,node_drive_auth,node_drive_service,node_privacy,node_biometric,node_storage,node_app_shell,node_settings toneRose
class node_receipt_picker,node_image_manager,node_ocr,node_parser,node_excel_export,node_excel_import,node_pdf_export,node_drive toneIndigo
```

## Components

### Finance Tracking

- [Expense tracking](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/index.jsx): `src/app/(tabs)/index.jsx`
- [Fuel tracking](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/Fuel.jsx): `src/app/(tabs)/Fuel.jsx`
- [Budget management](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/budgets.jsx): `src/app/(tabs)/budgets.jsx`
- [Category management](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/categories.jsx): `src/app/(tabs)/categories.jsx`
- [Accounts](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabs)/accounts.jsx): `src/app/(tabs)/accounts.jsx`

### Analytics

- [Analytics views](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabt)/index.jsx): `src/app/(tabt)/index.jsx`
- [Analytics details](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabt)/DataShow.jsx): `src/app/(tabt)/DataShow.jsx`
- [Analytics data hook](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/hooks/useAnalyticsData.js): `src/lib/hooks/useAnalyticsData.js`
- [Analytics calculations](https://github.com/harshp2405/mobileexpense/tree/main/src/lib/analytics): `src/lib/analytics`

### Data and Sync

- [Finance queries](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/queries.js): `src/lib/db/queries.js`
- [SQLite client](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/client.js): `src/lib/db/client.js`
- [Finance schema](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/db/schema.js): `src/lib/db/schema.js`
- [Remote sync](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/sync/syncManager.js): `src/lib/sync/syncManager.js`

### Privacy and Backup

- [Backup controls](https://github.com/harshp2405/mobileexpense/blob/main/src/components/BackupScreen.jsx): `src/components/BackupScreen.jsx`
- [Backup service](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/backupService.js): `src/lib/backup/backupService.js`
- [Restore service](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/restoreService.js): `src/lib/backup/restoreService.js`
- [Google authorization](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/googleAuth.js): `src/lib/backup/googleAuth.js`
- [Google Drive access](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/backup/googleDrive.js): `src/lib/backup/googleDrive.js`
- [Privacy mode](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/privacy/usePrivacyMode.js): `src/lib/privacy/usePrivacyMode.js`
- [Biometric lock](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/auth/useBiometricAuth.js): `src/lib/auth/useBiometricAuth.js`
- [Preference storage](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/utils/storage.js): `src/lib/utils/storage.js`
- [App shell](https://github.com/harshp2405/mobileexpense/blob/main/src/app/_layout.jsx): `src/app/_layout.jsx`
- [User settings](https://github.com/harshp2405/mobileexpense/blob/main/src/app/(tabt)/UserSettings.jsx): `src/app/(tabt)/UserSettings.jsx`

### Capture and Export

- [Receipt picker](https://github.com/harshp2405/mobileexpense/blob/main/src/components/ReceiptPicker.jsx): `src/components/ReceiptPicker.jsx`
- [Receipt image storage](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/utils/imageManager.js): `src/lib/utils/imageManager.js`
- [Receipt OCR](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/features/receiptOcr.js): `src/lib/features/receiptOcr.js`
- [Transaction parser](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/features/transactionParser.js): `src/lib/features/transactionParser.js`
- [Excel export](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/excel/exportExcel.js): `src/lib/excel/exportExcel.js`
- [Excel import](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/excel/importExcel.js): `src/lib/excel/importExcel.js`
- [PDF export](https://github.com/harshp2405/mobileexpense/blob/main/src/lib/utils/pdfExporter.js): `src/lib/utils/pdfExporter.js`

### Other components

- **Finance user**
- **Sync API**
- **Google Drive**

## Connections

- Finance user → Expense tracking: records expenses (evidence: `src/app/(tabs)/index.jsx`)
- Expense tracking → Finance queries: reads and writes (evidence: `src/app/(tabs)/index.jsx`)
- Finance user → Fuel tracking: records fuel (evidence: `src/app/(tabs)/Fuel.jsx`)
- Fuel tracking → Finance queries: uses queries (evidence: `src/app/(tabs)/Fuel.jsx`)
- Budget management → Finance queries: uses queries
- Category management → Finance queries: uses queries
- Accounts → Finance queries: uses queries
- Finance queries → SQLite client: uses database (evidence: `src/lib/db/queries.js`)
- Finance queries → Finance schema: queries tables (evidence: `src/lib/db/queries.js`)
- Analytics views → Analytics data hook: loads analytics (evidence: `src/app/(tabt)/index.jsx`)
- Analytics details → Analytics data hook: loads analytics (evidence: `src/app/(tabt)/DataShow.jsx`)
- Analytics data hook → Finance queries: loads finance data (evidence: `src/lib/hooks/useAnalyticsData.js`)
- Analytics data hook → Analytics calculations: calculates metrics (evidence: `src/lib/hooks/useAnalyticsData.js`)
- Expense tracking → Remote sync: runs sync (evidence: `src/app/(tabs)/index.jsx`)
- Remote sync → SQLite client: reads and writes (evidence: `src/lib/sync/syncManager.js`)
- Remote sync → Finance schema: syncs tables (evidence: `src/lib/sync/syncManager.js`)
- Remote sync → Preference storage: persists sync time (evidence: `src/lib/sync/syncManager.js`)
- Remote sync → Sync API: exchanges records (evidence: `src/lib/sync/syncManager.js`)
- Expense tracking → Receipt picker: opens picker (evidence: `src/app/(tabs)/index.jsx`)
- Receipt picker → Receipt image storage: saves images (evidence: `src/components/ReceiptPicker.jsx`)
- Finance queries → Receipt image storage: deletes receipt files (evidence: `src/lib/db/queries.js`)
- Expense tracking → Receipt OCR: extracts receipt text (evidence: `src/app/(tabs)/index.jsx`)
- Expense tracking → Transaction parser: parses transactions (evidence: `src/app/(tabs)/index.jsx`)
- Expense tracking → Excel export: exports expenses (evidence: `src/app/(tabs)/index.jsx`)
- Expense tracking → Excel import: imports expenses (evidence: `src/app/(tabs)/index.jsx`)
- Expense tracking → PDF export: exports report (evidence: `src/app/(tabs)/index.jsx`)
- Finance user → Backup controls: manages backups (evidence: `src/components/BackupScreen.jsx`)
- Backup controls → Backup service: requests backup (evidence: `src/components/BackupScreen.jsx`)
- Backup controls → Restore service: requests restore (evidence: `src/components/BackupScreen.jsx`)
- Backup service → Google authorization: gets access token (evidence: `src/lib/backup/backupService.js`)
- Backup service → Google Drive access: uploads backup (evidence: `src/lib/backup/backupService.js`)
- Restore service → Google authorization: gets access token (evidence: `src/lib/backup/restoreService.js`)
- Restore service → Google Drive access: downloads backup (evidence: `src/lib/backup/restoreService.js`)
- Google Drive access → Google Drive: accesses files
- Restore service → SQLite client: restores records (evidence: `src/lib/backup/restoreService.js`)
- Restore service → Finance schema: inserts tables (evidence: `src/lib/backup/restoreService.js`)
- App shell → Privacy mode: provides privacy state (evidence: `src/app/_layout.jsx`)
- App shell → Biometric lock: checks app lock (evidence: `src/app/_layout.jsx`)
- Biometric lock → Preference storage: persists lock setting (evidence: `src/lib/auth/useBiometricAuth.js`)
- Privacy mode → Preference storage: persists preference (evidence: `src/lib/privacy/usePrivacyMode.js`)
- User settings → Backup controls: offers backup controls
