# muniraj132/dubai-finance architecture

> Architecture diagram of the GitHub repository muniraj132/dubai-finance, 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/muniraj132/dubai-finance
- Repository: https://github.com/muniraj132/dubai-finance

## Overview

Dubai Finance Tracker is an account-scoped personal-finance app for Indian expats in Dubai, with an INR-only account option. Users authenticate, enter financial records through routed feature pages, and review dashboards, analytics, budgets, and reports. The app store persists user data in Supabase; shared utilities support currency calculations and portfolio summaries. The README documents additional features whose page implementations were not excerpted, so those nodes are retained but their internal behavior is not inferred. Edges reflect shown routing, imports, calls, or documented relationships; unsampled details are omitted.

Main entry points: [`src/stores/useAppStore.ts`](https://github.com/muniraj132/dubai-finance/blob/main/src/stores/useAppStore.ts) (Finance state), [`src/stores/useAuthStore.ts`](https://github.com/muniraj132/dubai-finance/blob/main/src/stores/useAuthStore.ts) (Auth state), [`src/App.tsx`](https://github.com/muniraj132/dubai-finance/blob/main/src/App.tsx) (App router), [`src/components/layout/Layout.tsx`](https://github.com/muniraj132/dubai-finance/blob/main/src/components/layout/Layout.tsx) (App layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and access"]
  node_app["App router<br/>[App.tsx]"]
  node_authpage["Sign in<br/>[Auth.tsx]"]
  node_reset["Password reset<br/>[ResetPassword.tsx]"]
  node_layout["App layout<br/>[Layout.tsx]"]
end

subgraph group_tracking["Finance tracking"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_expenses["Expenses<br/>[Expenses.tsx]"]
  node_income["Income<br/>[Income.tsx]"]
  node_goals["Goals<br/>[Goals.tsx]"]
  node_gold["Gold tracker<br/>[GoldTracker.tsx]"]
  node_investments["Investments<br/>[Investments.tsx]"]
  node_liabilities["Liabilities<br/>[Liabilities.tsx]"]
  node_chits["Chit funds<br/>[ChitFund.tsx]"]
end

subgraph group_insights["Planning and insights"]
  node_budget["Budget planner<br/>[BudgetPlanner.tsx]"]
  node_analytics["Analytics<br/>[Analytics.tsx]"]
  node_reports["CSV reports<br/>[Reports.tsx]"]
  node_converter["Currency converter<br/>[Converter.tsx]"]
  node_dubailife["Dubai journey<br/>[DubaiLife.tsx]"]
  node_settings["Settings<br/>[Settings.tsx]"]
end

subgraph group_platform["State and services"]
  node_appstore["Finance state<br/>[useAppStore.ts]"]
  node_authstore["Auth state<br/>[useAuthStore.ts]"]
  node_utils["Finance utilities<br/>[index.ts]"]
  node_hooks["Shared hooks<br/>[index.ts]"]
  node_supabaseclient["Supabase client<br/>[supabase.ts]"]
  node_database[("Supabase database")]
  node_mfnav["NAV lookup<br/>[mfNav.ts]"]
end

node_user(("Account holder"))
node_supabaseauth["Supabase Auth"]
node_mfapi["MF NAV service"]

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_reset
node_app -->|"wraps routes"| node_layout
node_app -->|"initializes"| node_authstore
node_authpage -->|"invokes auth"| node_authstore
node_authstore -->|"uses client"| node_supabaseclient
node_authstore -->|"auth operations"| node_supabaseauth
node_authstore -->|"resets state"| node_appstore
node_layout -->|"reads settings"| node_appstore
node_layout -->|"signs out"| node_authstore
node_dashboard -->|"reads finance data"| node_appstore
node_expenses -->|"manages records"| node_appstore
node_income -->|"manages records"| node_appstore
node_goals -->|"manages records"| node_appstore
node_gold -->|"manages records"| node_appstore
node_investments -->|"manages holdings"| node_appstore
node_investments -->|"requests NAV"| node_mfnav
node_mfnav -.->|"fetches NAV"| node_mfapi
node_liabilities -->|"manages records"| node_appstore
node_chits -->|"manages records"| node_appstore
node_budget -->|"reads budgets"| node_appstore
node_analytics -->|"reads finance data"| node_appstore
node_reports -->|"exports records"| node_appstore
node_converter -->|"uses exchange rate"| node_appstore
node_dubailife -->|"reads finance data"| node_appstore
node_settings -->|"updates settings"| node_appstore
node_appstore -->|"persists through"| node_supabaseclient
node_supabaseclient -->|"accesses"| node_database
node_appstore -->|"uses helpers"| node_utils
node_hooks -->|"reads state"| node_appstore
node_hooks -->|"uses calculations"| node_utils

click node_app "https://github.com/muniraj132/dubai-finance/blob/main/src/App.tsx"
click node_authpage "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Auth.tsx"
click node_reset "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/ResetPassword.tsx"
click node_layout "https://github.com/muniraj132/dubai-finance/blob/main/src/components/layout/Layout.tsx"
click node_dashboard "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Dashboard.tsx"
click node_expenses "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Expenses.tsx"
click node_income "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Income.tsx"
click node_goals "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Goals.tsx"
click node_gold "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/GoldTracker.tsx"
click node_investments "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Investments.tsx"
click node_liabilities "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Liabilities.tsx"
click node_chits "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/ChitFund.tsx"
click node_budget "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/BudgetPlanner.tsx"
click node_analytics "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Analytics.tsx"
click node_reports "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Reports.tsx"
click node_converter "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Converter.tsx"
click node_dubailife "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/DubaiLife.tsx"
click node_settings "https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Settings.tsx"
click node_appstore "https://github.com/muniraj132/dubai-finance/blob/main/src/stores/useAppStore.ts"
click node_authstore "https://github.com/muniraj132/dubai-finance/blob/main/src/stores/useAuthStore.ts"
click node_utils "https://github.com/muniraj132/dubai-finance/blob/main/src/utils/index.ts"
click node_hooks "https://github.com/muniraj132/dubai-finance/blob/main/src/hooks/index.ts"
click node_supabaseclient "https://github.com/muniraj132/dubai-finance/blob/main/src/utils/supabase.ts"
click node_database "https://github.com/muniraj132/dubai-finance/tree/main/supabase/migrations"
click node_mfnav "https://github.com/muniraj132/dubai-finance/blob/main/src/utils/mfNav.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,node_authpage,node_reset,node_layout toneBlue
class node_dashboard,node_expenses,node_income,node_goals,node_gold,node_investments,node_liabilities,node_chits toneAmber
class node_budget,node_analytics,node_reports,node_converter,node_dubailife,node_settings toneMint
class node_appstore,node_authstore,node_utils,node_hooks,node_supabaseclient,node_database,node_mfnav toneRose
class node_user,node_supabaseauth,node_mfapi toneIndigo
```

## Components

### App and access

- [App router](https://github.com/muniraj132/dubai-finance/blob/main/src/App.tsx): `src/App.tsx`
- [Sign in](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Auth.tsx): `src/pages/Auth.tsx`
- [Password reset](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/ResetPassword.tsx): `src/pages/ResetPassword.tsx`
- [App layout](https://github.com/muniraj132/dubai-finance/blob/main/src/components/layout/Layout.tsx): `src/components/layout/Layout.tsx`

### Finance tracking

- [Dashboard](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Expenses](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Expenses.tsx): `src/pages/Expenses.tsx`
- [Income](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Income.tsx): `src/pages/Income.tsx`
- [Goals](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Goals.tsx): `src/pages/Goals.tsx`
- [Gold tracker](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/GoldTracker.tsx): `src/pages/GoldTracker.tsx`
- [Investments](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Investments.tsx): `src/pages/Investments.tsx`
- [Liabilities](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Liabilities.tsx): `src/pages/Liabilities.tsx`
- [Chit funds](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/ChitFund.tsx): `src/pages/ChitFund.tsx`

### Planning and insights

- [Budget planner](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/BudgetPlanner.tsx): `src/pages/BudgetPlanner.tsx`
- [Analytics](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Analytics.tsx): `src/pages/Analytics.tsx`
- [CSV reports](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Reports.tsx): `src/pages/Reports.tsx`
- [Currency converter](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Converter.tsx): `src/pages/Converter.tsx`
- [Dubai journey](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/DubaiLife.tsx): `src/pages/DubaiLife.tsx`
- [Settings](https://github.com/muniraj132/dubai-finance/blob/main/src/pages/Settings.tsx): `src/pages/Settings.tsx`

### State and services

- [Finance state](https://github.com/muniraj132/dubai-finance/blob/main/src/stores/useAppStore.ts): `src/stores/useAppStore.ts`
- [Auth state](https://github.com/muniraj132/dubai-finance/blob/main/src/stores/useAuthStore.ts): `src/stores/useAuthStore.ts`
- [Finance utilities](https://github.com/muniraj132/dubai-finance/blob/main/src/utils/index.ts): `src/utils/index.ts`
- [Shared hooks](https://github.com/muniraj132/dubai-finance/blob/main/src/hooks/index.ts): `src/hooks/index.ts`
- [Supabase client](https://github.com/muniraj132/dubai-finance/blob/main/src/utils/supabase.ts): `src/utils/supabase.ts`
- [Supabase database](https://github.com/muniraj132/dubai-finance/tree/main/supabase/migrations): `supabase/migrations`
- [NAV lookup](https://github.com/muniraj132/dubai-finance/blob/main/src/utils/mfNav.ts): `src/utils/mfNav.ts`

### Other components

- **Account holder**
- **Supabase Auth**
- **MF NAV service**

## Connections

- Account holder → App router: opens (evidence: `README.md`)
- App router → Sign in: routes to (evidence: `src/App.tsx`)
- App router → Password reset: routes to (evidence: `src/App.tsx`)
- App router → App layout: wraps routes (evidence: `src/App.tsx`)
- App router → Auth state: initializes (evidence: `src/App.tsx`)
- Sign in → Auth state: invokes auth (evidence: `src/pages/Auth.tsx`)
- Auth state → Supabase client: uses client (evidence: `src/stores/useAuthStore.ts`)
- Auth state → Supabase Auth: auth operations (evidence: `src/stores/useAuthStore.ts`)
- Auth state → Finance state: resets state (evidence: `src/stores/useAuthStore.ts`)
- App layout → Finance state: reads settings (evidence: `src/components/layout/Layout.tsx`)
- App layout → Auth state: signs out (evidence: `src/components/layout/Layout.tsx`)
- Dashboard → Finance state: reads finance data (evidence: `src/pages/Dashboard.tsx`)
- Expenses → Finance state: manages records (evidence: `src/pages/Expenses.tsx`)
- Income → Finance state: manages records (evidence: `src/pages/Income.tsx`)
- Goals → Finance state: manages records (evidence: `src/pages/Goals.tsx`)
- Gold tracker → Finance state: manages records (evidence: `src/pages/GoldTracker.tsx`)
- Investments → Finance state: manages holdings (evidence: `src/pages/Investments.tsx`)
- Investments → NAV lookup: requests NAV (evidence: `src/pages/Investments.tsx`)
- NAV lookup → MF NAV service: fetches NAV
- Liabilities → Finance state: manages records (evidence: `src/pages/Liabilities.tsx`)
- Chit funds → Finance state: manages records (evidence: `src/pages/ChitFund.tsx`)
- Budget planner → Finance state: reads budgets (evidence: `src/pages/BudgetPlanner.tsx`)
- Analytics → Finance state: reads finance data (evidence: `src/pages/Analytics.tsx`)
- CSV reports → Finance state: exports records (evidence: `README.md`)
- Currency converter → Finance state: uses exchange rate (evidence: `src/pages/Converter.tsx`)
- Dubai journey → Finance state: reads finance data (evidence: `src/pages/DubaiLife.tsx`)
- Settings → Finance state: updates settings (evidence: `src/pages/Settings.tsx`)
- Finance state → Supabase client: persists through (evidence: `src/stores/useAppStore.ts`)
- Supabase client → Supabase database: accesses (evidence: `README.md`)
- Finance state → Finance utilities: uses helpers (evidence: `src/stores/useAppStore.ts`)
- Shared hooks → Finance state: reads state (evidence: `src/hooks/index.ts`)
- Shared hooks → Finance utilities: uses calculations (evidence: `src/hooks/index.ts`)
