# keljo247/finance-tracker-app architecture

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

- Interactive diagram: https://gitdiagram.com/keljo247/finance-tracker-app
- Repository: https://github.com/keljo247/finance-tracker-app

## Overview

Finance Tracker is a cross-platform personal-finance app. The main screen combines account access with expense tracking, history, analytics, settings, and PHP/USD conversion. The sampled screen code shows Firebase authentication and a user-filtered Firestore expense subscription; the README documents the broader capabilities. Most product behavior appears in one large screen module, so its domain stages share that source path. Details of conversion and some settings behavior were not sampled.

Main entry points: [`finance-tracker/src/app/index.tsx`](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx) (Finance screen), [`finance-tracker/src/firebaseConfig.js`](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/firebaseConfig.js) (Firebase setup), [`finance-tracker/src/constants/theme.ts`](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/constants/theme.ts) (Theme tokens), [`finance-tracker/src/components/themed-text.tsx`](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/themed-text.tsx) (Themed text)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_product["Finance experience"]
  node_app["Finance screen<br/>[index.tsx]"]
  node_account["Account access<br/>[index.tsx]"]
  node_expenses["Expense tracking<br/>[index.tsx]"]
  node_history["Expense history<br/>[index.tsx]"]
  node_analytics["Analytics<br/>[index.tsx]"]
  node_settings["Account settings<br/>[index.tsx]"]
  node_currency["Currency conversion<br/>[index.tsx]"]
end

subgraph group_services["Cloud services"]
  node_firebase_config["Firebase setup<br/>[firebaseConfig.js]"]
  node_firebase_auth["Firebase Auth"]
  node_firestore[("Cloud Firestore")]
end

subgraph group_presentation["Presentation layer"]
  node_themed_text["Themed text<br/>[themed-text.tsx]"]
  node_themed_view["Themed view<br/>[themed-view.tsx]"]
  node_theme["Theme tokens<br/>[theme.ts]"]
  node_external_link["External links<br/>[external-link.tsx]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"handles"| node_account
node_app -->|"tracks"| node_expenses
node_app -->|"shows"| node_history
node_app -->|"presents"| node_analytics
node_app -->|"presents"| node_settings
node_app -->|"supports"| node_currency
node_app -->|"imports"| node_firebase_config
node_firebase_config -->|"initializes"| node_firebase_auth
node_firebase_config -->|"initializes"| node_firestore
node_app -->|"authenticates"| node_firebase_auth
node_app -->|"subscribes"| node_firestore
node_themed_text -->|"reads colors"| node_theme
node_themed_view -->|"reads colors"| node_theme
node_external_link -->|"opens links"| node_user

click node_app "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_account "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_expenses "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_history "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_analytics "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_settings "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_currency "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx"
click node_firebase_config "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/firebaseConfig.js"
click node_themed_text "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/themed-text.tsx"
click node_themed_view "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/themed-view.tsx"
click node_theme "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/constants/theme.ts"
click node_external_link "https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/external-link.tsx"

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_account,node_expenses,node_history,node_analytics,node_settings,node_currency,node_user toneBlue
class node_firebase_config,node_firebase_auth,node_firestore toneAmber
class node_themed_text,node_themed_view,node_theme,node_external_link toneMint
```

## Components

### Finance experience

- [Finance screen](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`
- [Account access](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`
- [Expense tracking](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`
- [Expense history](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`
- [Analytics](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`
- [Account settings](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`
- [Currency conversion](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/app/index.tsx): `finance-tracker/src/app/index.tsx`

### Cloud services

- [Firebase setup](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/firebaseConfig.js): `finance-tracker/src/firebaseConfig.js`
- **Firebase Auth**
- **Cloud Firestore**

### Presentation layer

- [Themed text](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/themed-text.tsx): `finance-tracker/src/components/themed-text.tsx`
- [Themed view](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/themed-view.tsx): `finance-tracker/src/components/themed-view.tsx`
- [Theme tokens](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/constants/theme.ts): `finance-tracker/src/constants/theme.ts`
- [External links](https://github.com/keljo247/finance-tracker-app/blob/main/finance-tracker/src/components/external-link.tsx): `finance-tracker/src/components/external-link.tsx`

### Other components

- **User**

## Connections

- User → Finance screen: uses
- Finance screen → Account access: handles (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Expense tracking: tracks (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Expense history: shows (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Analytics: presents (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Account settings: presents (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Currency conversion: supports (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Firebase setup: imports (evidence: `finance-tracker/src/app/index.tsx`)
- Firebase setup → Firebase Auth: initializes (evidence: `finance-tracker/src/firebaseConfig.js`)
- Firebase setup → Cloud Firestore: initializes (evidence: `finance-tracker/src/firebaseConfig.js`)
- Finance screen → Firebase Auth: authenticates (evidence: `finance-tracker/src/app/index.tsx`)
- Finance screen → Cloud Firestore: subscribes (evidence: `finance-tracker/src/app/index.tsx`)
- Themed text → Theme tokens: reads colors (evidence: `finance-tracker/src/components/themed-text.tsx`)
- Themed view → Theme tokens: reads colors (evidence: `finance-tracker/src/components/themed-view.tsx`)
- External links → User: opens links (evidence: `finance-tracker/src/components/external-link.tsx`)
