# greenbinjack/finance-tracker architecture

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

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

## Overview

Finance Tracker is a personal-finance PWA. Users sign in, then record and review everyday transactions; the dashboard summarizes balances and activity, while reports filter and analyze history. Separate branches cover budgets, investments, loans, and event/trip planning with shared expenses. Server-side services use Supabase for persistence and authentication; export routes provide JSON backups and CSV reports. The graph follows the README and supplied excerpts/index; unsampled feature internals are represented by their exact route paths, and their connections are not inferred beyond documented capabilities.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/supabase/server.ts) (Server client), [`src/app/(app)/reports/page.tsx`](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/reports/page.tsx) (Reports), [`src/lib/services/transactions.ts`](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/transactions.ts) (Transaction services), [`src/app/api/export/reports/route.ts`](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/api/export/reports/route.ts) (Export routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and shell"]
  node_login["Sign in<br/>[page.tsx]"]
  node_auth["Auth actions<br/>[actions.ts]"]
  node_settings["Settings<br/>[actions.ts]"]
end

subgraph group_money["Personal finances"]
  node_app["Finance dashboard<br/>[page.tsx]"]
  node_transactions["Transactions<br/>[page.tsx]"]
  node_accounts["Accounts<br/>[accounts.ts]"]
  node_budgets["Budgets<br/>[page.tsx]"]
  node_investments["Investments<br/>[page.tsx]"]
  node_loans["Loans<br/>[page.tsx]"]
end

subgraph group_planning["Planning and sharing"]
  node_events["Events and trips<br/>[page.tsx]"]
  node_trip_share["Shared trip view<br/>[page.tsx]"]
end

subgraph group_insights["Reports and export"]
  node_reports["Reports<br/>[page.tsx]"]
  node_csv["CSV formatting<br/>[csv.ts]"]
  node_exports["Export routes<br/>[route.ts]"]
  node_backup["Data backup<br/>[route.ts]"]
end

subgraph group_platform["Data and services"]
  node_transaction_ops["Transaction services<br/>[transactions.ts]"]
  node_supabase_client["Server client<br/>[server.ts]"]
  node_database[("Supabase")]
  node_types["Database types<br/>[database.types.ts]"]
  node_dashboard_data["Dashboard service<br/>[dashboard.ts]"]
  node_recurring["Recurring detection<br/>[recurring.ts]"]
  node_profile["Profile service<br/>[profile.ts]"]
  node_events_service["Event service<br/>[events.ts]"]
end

node_user(("User"))

node_user -->|"signs in"| node_login
node_login -->|"submits credentials"| node_auth
node_auth -->|"authenticates"| node_supabase_client
node_app -->|"loads summary"| node_dashboard_data
node_app -->|"detects patterns"| node_recurring
node_dashboard_data -.->|"queries data"| node_supabase_client
node_transactions -.->|"lists history"| node_transaction_ops
node_reports -->|"requests summaries"| node_transaction_ops
node_reports -->|"loads currency"| node_profile
node_reports -->|"loads accounts"| node_accounts
node_reports -->|"loads events"| node_events_service
node_transaction_ops -->|"queries transactions"| node_supabase_client
node_supabase_client -->|"types client"| node_types
node_supabase_client -->|"connects"| node_database
node_settings -->|"updates profile"| node_profile
node_settings -->|"manages accounts"| node_accounts
node_user -->|"sets budgets"| node_budgets
node_user -->|"tracks investments"| node_investments
node_user -->|"tracks loans"| node_loans
node_user -->|"plans trips"| node_events
node_events -.->|"shares trip"| node_trip_share
node_user -->|"reviews reports"| node_reports
node_user -.->|"downloads CSV"| node_exports
node_exports -->|"loads filtered data"| node_transaction_ops
node_exports -->|"formats CSV"| node_csv
node_user -.->|"downloads backup"| node_backup
node_backup -->|"reads records"| node_supabase_client

click node_login "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/login/page.tsx"
click node_auth "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/login/actions.ts"
click node_app "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/page.tsx"
click node_transactions "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/transactions/page.tsx"
click node_transaction_ops "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/transactions.ts"
click node_accounts "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/accounts.ts"
click node_settings "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/settings/actions.ts"
click node_budgets "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/budgets/page.tsx"
click node_investments "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/investments/page.tsx"
click node_loans "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/loans/page.tsx"
click node_events "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/events/page.tsx"
click node_trip_share "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/trips/%5Btoken%5D/page.tsx"
click node_reports "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/reports/page.tsx"
click node_csv "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/domain/csv.ts"
click node_exports "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/api/export/reports/route.ts"
click node_backup "https://github.com/greenbinjack/finance-tracker/blob/main/src/app/api/export/data/route.ts"
click node_supabase_client "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/supabase/server.ts"
click node_types "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/supabase/database.types.ts"
click node_dashboard_data "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/dashboard.ts"
click node_recurring "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/domain/recurring.ts"
click node_profile "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/profile.ts"
click node_events_service "https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/events.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_login,node_auth,node_settings,node_user toneBlue
class node_app,node_transactions,node_accounts,node_budgets,node_investments,node_loans toneAmber
class node_events,node_trip_share toneMint
class node_reports,node_csv,node_exports,node_backup toneRose
class node_transaction_ops,node_supabase_client,node_database,node_types,node_dashboard_data,node_recurring,node_profile,node_events_service toneIndigo
```

## Components

### Access and shell

- [Sign in](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Auth actions](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/login/actions.ts): `src/app/login/actions.ts`
- [Settings](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/settings/actions.ts): `src/app/(app)/settings/actions.ts`

### Personal finances

- [Finance dashboard](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/page.tsx): `src/app/(app)/page.tsx`
- [Transactions](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/transactions/page.tsx): `src/app/(app)/transactions/page.tsx`
- [Accounts](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/accounts.ts): `src/lib/services/accounts.ts`
- [Budgets](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/budgets/page.tsx): `src/app/(app)/budgets/page.tsx`
- [Investments](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/investments/page.tsx): `src/app/(app)/investments/page.tsx`
- [Loans](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/loans/page.tsx): `src/app/(app)/loans/page.tsx`

### Planning and sharing

- [Events and trips](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/events/page.tsx): `src/app/(app)/events/page.tsx`
- [Shared trip view](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/trips/%5Btoken%5D/page.tsx): `src/app/trips/[token]/page.tsx`

### Reports and export

- [Reports](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/(app)/reports/page.tsx): `src/app/(app)/reports/page.tsx`
- [CSV formatting](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/domain/csv.ts): `src/lib/domain/csv.ts`
- [Export routes](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/api/export/reports/route.ts): `src/app/api/export/reports/route.ts`
- [Data backup](https://github.com/greenbinjack/finance-tracker/blob/main/src/app/api/export/data/route.ts): `src/app/api/export/data/route.ts`

### Data and services

- [Transaction services](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/transactions.ts): `src/lib/services/transactions.ts`
- [Server client](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- **Supabase**
- [Database types](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/supabase/database.types.ts): `src/lib/supabase/database.types.ts`
- [Dashboard service](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/dashboard.ts): `src/lib/services/dashboard.ts`
- [Recurring detection](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/domain/recurring.ts): `src/lib/domain/recurring.ts`
- [Profile service](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/profile.ts): `src/lib/services/profile.ts`
- [Event service](https://github.com/greenbinjack/finance-tracker/blob/main/src/lib/services/events.ts): `src/lib/services/events.ts`

### Other components

- **User**

## Connections

- User → Sign in: signs in
- Sign in → Auth actions: submits credentials (evidence: `src/app/login/page.tsx`)
- Auth actions → Server client: authenticates (evidence: `src/app/login/actions.ts`)
- Finance dashboard → Dashboard service: loads summary (evidence: `src/app/(app)/page.tsx`)
- Finance dashboard → Recurring detection: detects patterns (evidence: `src/app/(app)/page.tsx`)
- Dashboard service → Server client: queries data
- Transactions → Transaction services: lists history
- Reports → Transaction services: requests summaries (evidence: `src/app/(app)/reports/page.tsx`)
- Reports → Profile service: loads currency (evidence: `src/app/(app)/reports/page.tsx`)
- Reports → Accounts: loads accounts (evidence: `src/app/(app)/reports/page.tsx`)
- Reports → Event service: loads events (evidence: `src/app/(app)/reports/page.tsx`)
- Transaction services → Server client: queries transactions (evidence: `src/lib/services/transactions.ts`)
- Server client → Database types: types client (evidence: `src/lib/supabase/server.ts`)
- Server client → Supabase: connects (evidence: `src/lib/supabase/server.ts`)
- Settings → Profile service: updates profile (evidence: `src/app/(app)/settings/actions.ts`)
- Settings → Accounts: manages accounts (evidence: `src/app/(app)/settings/actions.ts`)
- User → Budgets: sets budgets
- User → Investments: tracks investments
- User → Loans: tracks loans
- User → Events and trips: plans trips
- Events and trips → Shared trip view: shares trip
- User → Reports: reviews reports
- User → Export routes: downloads CSV
- Export routes → Transaction services: loads filtered data (evidence: `src/app/api/export/reports/route.ts`)
- Export routes → CSV formatting: formats CSV (evidence: `src/app/api/export/reports/route.ts`)
- User → Data backup: downloads backup
- Data backup → Server client: reads records (evidence: `src/app/api/export/data/route.ts`)
