# jeevaofficial1905-lgtm/personal-finance-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/jeevaofficial1905-lgtm/personal-finance-tracker
- Repository: https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker

## Overview

WealthTrack is a personal-finance web app: users sign in, manage financial records, and review dashboard summaries and reports. The app shell owns authentication, tab selection, Firestore profile setup, and live collection subscriptions; feature views handle record-specific actions, with some writes performed directly by the shell. Firebase supplies auth and persistence. The graph preserves the listed finance capabilities; source evidence for several views is limited to imports or their inclusion in App, so no unshown data-flow edges are inferred.

Main entry points: [`src/App.tsx`](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/App.tsx) (App and auth), [`src/components/TransactionList.tsx`](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/TransactionList.tsx) (Transactions), [`src/lib/utils.ts`](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/lib/utils.ts) (Formatting utilities), [`src/components/Dashboard.tsx`](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Dashboard.tsx) (Dashboard reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_entry["React entry<br/>[main.tsx]"]
  node_errors["Error boundary<br/>[ErrorBoundary.tsx]"]
  node_shell["App and auth<br/>[App.tsx]"]
  node_layout["Navigation layout<br/>[Layout.tsx]"]
end

subgraph group_finance["Finance views"]
  node_dashboard["Dashboard reports<br/>[Dashboard.tsx]"]
  node_budgets["Budget tracking<br/>[BudgetTracker.tsx]"]
  node_debts["Debt and loans<br/>[DebtTracker.tsx]"]
  node_creditors["Owed and receivable"]
  node_transactions["Transactions"]
  node_income["Income and expenses"]
  node_investments["Investments"]
  node_calculator["Calculator<br/>[Calculator.tsx]"]
end

subgraph group_platform["Firebase platform"]
  node_firebase["Firebase client<br/>[firebase.ts]"]
  node_firestore[("Cloud Firestore")]
  node_authservice["Firebase Auth"]
end

subgraph group_shared["Shared presentation"]
  node_types["Finance types<br/>[types.ts]"]
  node_utils["Formatting utilities<br/>[utils.ts]"]
end

node_user(("User"))

node_user -->|"opens app"| node_entry
node_entry -->|"renders within"| node_errors
node_errors -->|"renders"| node_shell
node_shell -->|"auth and reads"| node_firebase
node_firebase -->|"initializes"| node_authservice
node_firebase -->|"initializes"| node_firestore
node_shell -->|"reads and writes"| node_firestore
node_shell -->|"renders"| node_layout
node_shell -->|"renders"| node_dashboard
node_shell -->|"renders"| node_budgets
node_shell -->|"renders"| node_debts
node_shell -->|"renders"| node_creditors
node_shell -->|"renders"| node_transactions
node_shell -->|"renders"| node_income
node_shell -->|"renders"| node_investments
node_layout -->|"displays"| node_calculator
node_transactions -->|"creates and deletes"| node_firestore
node_budgets -->|"creates and deletes"| node_firestore
node_debts -->|"updates records"| node_firestore
node_creditors -->|"writes records"| node_firestore
node_dashboard -->|"formats values"| node_utils
node_income -->|"formats values"| node_utils
node_transactions -->|"formats values"| node_utils
node_debts -->|"formats dates"| node_utils
node_shell -->|"uses models"| node_types
node_dashboard -->|"uses models"| node_types
node_transactions -->|"uses models"| node_types

click node_entry "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/main.tsx"
click node_errors "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/ErrorBoundary.tsx"
click node_shell "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/App.tsx"
click node_layout "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Layout.tsx"
click node_dashboard "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Dashboard.tsx"
click node_budgets "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/BudgetTracker.tsx"
click node_debts "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/DebtTracker.tsx"
click node_creditors "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/CreditorTracker.tsx"
click node_transactions "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/TransactionList.tsx"
click node_income "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/IncomeExpenseManager.tsx"
click node_investments "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/InvestmentTracker.tsx"
click node_calculator "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Calculator.tsx"
click node_firebase "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/lib/firebase.ts"
click node_types "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/types.ts"
click node_utils "https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/lib/utils.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_entry,node_errors,node_shell,node_layout,node_user toneBlue
class node_dashboard,node_budgets,node_debts,node_creditors,node_transactions,node_income,node_investments,node_calculator toneAmber
class node_firebase,node_firestore,node_authservice toneMint
class node_types,node_utils toneRose
```

## Components

### Application shell

- [React entry](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/main.tsx): `src/main.tsx`
- [Error boundary](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/ErrorBoundary.tsx): `src/components/ErrorBoundary.tsx`
- [App and auth](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/App.tsx): `src/App.tsx`
- [Navigation layout](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Layout.tsx): `src/components/Layout.tsx`

### Finance views

- [Dashboard reports](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Dashboard.tsx): `src/components/Dashboard.tsx`
- [Budget tracking](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/BudgetTracker.tsx): `src/components/BudgetTracker.tsx`
- [Debt and loans](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/DebtTracker.tsx): `src/components/DebtTracker.tsx`
- [Owed and receivable](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/CreditorTracker.tsx): `src/components/CreditorTracker.tsx`
- [Transactions](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/TransactionList.tsx): `src/components/TransactionList.tsx`
- [Income and expenses](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/IncomeExpenseManager.tsx): `src/components/IncomeExpenseManager.tsx`
- [Investments](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/InvestmentTracker.tsx): `src/components/InvestmentTracker.tsx`
- [Calculator](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/components/Calculator.tsx): `src/components/Calculator.tsx`

### Firebase platform

- [Firebase client](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- **Cloud Firestore**
- **Firebase Auth**

### Shared presentation

- [Finance types](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/types.ts): `src/types.ts`
- [Formatting utilities](https://github.com/jeevaofficial1905-lgtm/personal-finance-tracker/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **User**

## Connections

- User → React entry: opens app (evidence: `src/main.tsx`)
- React entry → Error boundary: renders within (evidence: `src/main.tsx`)
- Error boundary → App and auth: renders (evidence: `src/main.tsx`)
- App and auth → Firebase client: auth and reads (evidence: `src/App.tsx`)
- Firebase client → Firebase Auth: initializes (evidence: `src/lib/firebase.ts`)
- Firebase client → Cloud Firestore: initializes (evidence: `src/lib/firebase.ts`)
- App and auth → Cloud Firestore: reads and writes (evidence: `src/App.tsx`)
- App and auth → Navigation layout: renders (evidence: `src/App.tsx`)
- App and auth → Dashboard reports: renders (evidence: `src/App.tsx`)
- App and auth → Budget tracking: renders (evidence: `src/App.tsx`)
- App and auth → Debt and loans: renders (evidence: `src/App.tsx`)
- App and auth → Owed and receivable: renders (evidence: `src/App.tsx`)
- App and auth → Transactions: renders (evidence: `src/App.tsx`)
- App and auth → Income and expenses: renders (evidence: `src/App.tsx`)
- App and auth → Investments: renders (evidence: `src/App.tsx`)
- Navigation layout → Calculator: displays (evidence: `src/components/Layout.tsx`)
- Transactions → Cloud Firestore: creates and deletes (evidence: `src/components/TransactionList.tsx`)
- Budget tracking → Cloud Firestore: creates and deletes (evidence: `src/components/BudgetTracker.tsx`)
- Debt and loans → Cloud Firestore: updates records (evidence: `src/components/DebtTracker.tsx`)
- Owed and receivable → Cloud Firestore: writes records (evidence: `src/components/CreditorTracker.tsx`)
- Dashboard reports → Formatting utilities: formats values (evidence: `src/components/Dashboard.tsx`)
- Income and expenses → Formatting utilities: formats values (evidence: `src/components/IncomeExpenseManager.tsx`)
- Transactions → Formatting utilities: formats values (evidence: `src/components/TransactionList.tsx`)
- Debt and loans → Formatting utilities: formats dates (evidence: `src/components/DebtTracker.tsx`)
- App and auth → Finance types: uses models (evidence: `src/App.tsx`)
- Dashboard reports → Finance types: uses models (evidence: `src/components/Dashboard.tsx`)
- Transactions → Finance types: uses models (evidence: `src/components/TransactionList.tsx`)
