# satviksh13/bankmanager architecture

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

- Interactive diagram: https://gitdiagram.com/satviksh13/bankmanager
- Repository: https://github.com/satviksh13/bankmanager

## Overview

Horizon is a fintech banking app whose main workflow is user authentication, linking a bank, retrieving account and transaction data, and presenting it in dashboards and bank/history views; users can also initiate transfers to other platform users. The app’s Next.js pages invoke server actions, which coordinate Appwrite persistence and Plaid/Dwolla integrations. The README documents major capabilities that the sampled code does not fully show. Some component and action relationships rely on SOURCE INDEX references rather than complete excerpts.

Main entry points: [`lib/actions/user.actions.ts`](https://github.com/satviksh13/bankmanager/blob/main/lib/actions/user.actions.ts) (User and bank actions), [`lib/actions/bank.actions.ts`](https://github.com/satviksh13/bankmanager/blob/main/lib/actions/bank.actions.ts) (Account and bank data), [`app/(root)/page.tsx`](https://github.com/satviksh13/bankmanager/blob/main/app/(root)/page.tsx) (Financial overview), [`components/PaymentTransferForm.tsx`](https://github.com/satviksh13/bankmanager/blob/main/components/PaymentTransferForm.tsx) (Transfer form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_auth["Sign-in and sign-up<br/>[page.tsx]"]
  node_authform["Authentication form<br/>[AuthForm.tsx]"]
  node_home["Financial overview<br/>[page.tsx]"]
  node_balance["Balance and spending"]
  node_recent["Recent transactions"]
  node_banksview["My banks<br/>[page.tsx]"]
  node_bankcard["Bank account card<br/>[BankCard.tsx]"]
  node_history["Transaction history<br/>[page.tsx]"]
  node_table["Transactions table"]
  node_transferpage["Transfer funds page<br/>[page.tsx]"]
end

subgraph group_account["Accounts and identity"]
  node_useractions["User and bank actions<br/>[user.actions.ts]"]
  node_bankactions["Account and bank data<br/>[bank.actions.ts]"]
  node_appwriteclient["Appwrite client<br/>[appwrite.ts]"]
  node_plaidclient["Plaid client<br/>[plaid.ts]"]
end

subgraph group_money["Transactions and transfers"]
  node_transferform["Transfer form"]
  node_transactionactions["Transaction records"]
  node_dwollaactions["Transfer processing<br/>[dwolla.actions.ts]"]
end

subgraph group_services["External services"]
  node_appwrite[("Appwrite")]
  node_plaid["Plaid"]
  node_dwolla["Dwolla"]
end

node_user(("Banking user"))

node_user -->|"starts session"| node_auth
node_auth -->|"renders"| node_authform
node_authform -->|"signs in or up"| node_useractions
node_authform -->|"links bank"| node_useractions
node_useractions -->|"uses clients"| node_appwriteclient
node_appwriteclient -->|"accesses"| node_appwrite
node_useractions -->|"exchanges bank token"| node_plaidclient
node_useractions -->|"creates funding source"| node_dwollaactions
node_plaidclient -->|"connects banks"| node_plaid
node_dwollaactions -->|"processes transfers"| node_dwolla
node_user -->|"views finances"| node_home
node_home -->|"loads user"| node_useractions
node_home -->|"loads accounts"| node_bankactions
node_home -->|"renders"| node_balance
node_home -->|"renders"| node_recent
node_bankactions -->|"gets bank records"| node_useractions
node_bankactions -->|"fetches account data"| node_plaidclient
node_bankactions -->|"loads transfer records"| node_transactionactions
node_user -->|"reviews linked banks"| node_banksview
node_banksview -->|"loads user"| node_useractions
node_banksview -->|"loads accounts"| node_bankactions
node_banksview -->|"renders"| node_bankcard
node_user -->|"browses transactions"| node_history
node_history -->|"loads user"| node_useractions
node_history -->|"loads account data"| node_bankactions
node_history -->|"renders rows"| node_table
node_user -->|"initiates transfer"| node_transferpage
node_transferpage -->|"loads user"| node_useractions
node_transferpage -->|"loads banks"| node_bankactions
node_transferpage -->|"renders"| node_transferform
node_transferform -->|"resolves banks"| node_useractions
node_transferform -->|"creates transfer"| node_dwollaactions
node_transferform -->|"records transfer"| node_transactionactions
node_transactionactions -->|"stores records"| node_appwriteclient
node_bankactions -->|"retrieves transactions"| node_plaid
node_transferform -->|"moves funds"| node_dwolla

click node_auth "https://github.com/satviksh13/bankmanager/blob/main/app/(auth)/sign-in/page.tsx"
click node_authform "https://github.com/satviksh13/bankmanager/blob/main/components/AuthForm.tsx"
click node_home "https://github.com/satviksh13/bankmanager/blob/main/app/(root)/page.tsx"
click node_balance "https://github.com/satviksh13/bankmanager/blob/main/components/TotalBalanceBox.tsx"
click node_recent "https://github.com/satviksh13/bankmanager/blob/main/components/RecentTransactions.tsx"
click node_banksview "https://github.com/satviksh13/bankmanager/blob/main/app/(root)/my-banks/page.tsx"
click node_bankcard "https://github.com/satviksh13/bankmanager/blob/main/components/BankCard.tsx"
click node_history "https://github.com/satviksh13/bankmanager/blob/main/app/(root)/transaction-history/page.tsx"
click node_table "https://github.com/satviksh13/bankmanager/blob/main/components/TransactionsTable.tsx"
click node_transferpage "https://github.com/satviksh13/bankmanager/blob/main/app/(root)/payment-transfer/page.tsx"
click node_transferform "https://github.com/satviksh13/bankmanager/blob/main/components/PaymentTransferForm.tsx"
click node_useractions "https://github.com/satviksh13/bankmanager/blob/main/lib/actions/user.actions.ts"
click node_bankactions "https://github.com/satviksh13/bankmanager/blob/main/lib/actions/bank.actions.ts"
click node_transactionactions "https://github.com/satviksh13/bankmanager/blob/main/lib/actions/transaction.actions.ts"
click node_dwollaactions "https://github.com/satviksh13/bankmanager/blob/main/lib/actions/dwolla.actions.ts"
click node_appwriteclient "https://github.com/satviksh13/bankmanager/blob/main/lib/appwrite.ts"
click node_plaidclient "https://github.com/satviksh13/bankmanager/blob/main/lib/plaid.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_auth,node_authform,node_home,node_balance,node_recent,node_banksview,node_bankcard,node_history,node_table,node_transferpage,node_user toneBlue
class node_useractions,node_bankactions,node_appwriteclient,node_plaidclient toneAmber
class node_transferform,node_transactionactions,node_dwollaactions toneMint
class node_appwrite,node_plaid,node_dwolla toneRose
```

## Components

### User experience

- [Sign-in and sign-up](https://github.com/satviksh13/bankmanager/blob/main/app/(auth)/sign-in/page.tsx): `app/(auth)/sign-in/page.tsx`
- [Authentication form](https://github.com/satviksh13/bankmanager/blob/main/components/AuthForm.tsx): `components/AuthForm.tsx`
- [Financial overview](https://github.com/satviksh13/bankmanager/blob/main/app/(root)/page.tsx): `app/(root)/page.tsx`
- [Balance and spending](https://github.com/satviksh13/bankmanager/blob/main/components/TotalBalanceBox.tsx): `components/TotalBalanceBox.tsx`
- [Recent transactions](https://github.com/satviksh13/bankmanager/blob/main/components/RecentTransactions.tsx): `components/RecentTransactions.tsx`
- [My banks](https://github.com/satviksh13/bankmanager/blob/main/app/(root)/my-banks/page.tsx): `app/(root)/my-banks/page.tsx`
- [Bank account card](https://github.com/satviksh13/bankmanager/blob/main/components/BankCard.tsx): `components/BankCard.tsx`
- [Transaction history](https://github.com/satviksh13/bankmanager/blob/main/app/(root)/transaction-history/page.tsx): `app/(root)/transaction-history/page.tsx`
- [Transactions table](https://github.com/satviksh13/bankmanager/blob/main/components/TransactionsTable.tsx): `components/TransactionsTable.tsx`
- [Transfer funds page](https://github.com/satviksh13/bankmanager/blob/main/app/(root)/payment-transfer/page.tsx): `app/(root)/payment-transfer/page.tsx`

### Accounts and identity

- [User and bank actions](https://github.com/satviksh13/bankmanager/blob/main/lib/actions/user.actions.ts): `lib/actions/user.actions.ts`
- [Account and bank data](https://github.com/satviksh13/bankmanager/blob/main/lib/actions/bank.actions.ts): `lib/actions/bank.actions.ts`
- [Appwrite client](https://github.com/satviksh13/bankmanager/blob/main/lib/appwrite.ts): `lib/appwrite.ts`
- [Plaid client](https://github.com/satviksh13/bankmanager/blob/main/lib/plaid.ts): `lib/plaid.ts`

### Transactions and transfers

- [Transfer form](https://github.com/satviksh13/bankmanager/blob/main/components/PaymentTransferForm.tsx): `components/PaymentTransferForm.tsx`
- [Transaction records](https://github.com/satviksh13/bankmanager/blob/main/lib/actions/transaction.actions.ts): `lib/actions/transaction.actions.ts`
- [Transfer processing](https://github.com/satviksh13/bankmanager/blob/main/lib/actions/dwolla.actions.ts): `lib/actions/dwolla.actions.ts`

### External services

- **Appwrite**
- **Plaid**
- **Dwolla**

### Other components

- **Banking user**

## Connections

- Banking user → Sign-in and sign-up: starts session
- Sign-in and sign-up → Authentication form: renders (evidence: `app/(auth)/sign-in/page.tsx`)
- Authentication form → User and bank actions: signs in or up (evidence: `components/AuthForm.tsx`)
- Authentication form → User and bank actions: links bank (evidence: `components/AuthForm.tsx`)
- User and bank actions → Appwrite client: uses clients (evidence: `lib/actions/user.actions.ts`)
- Appwrite client → Appwrite: accesses
- User and bank actions → Plaid client: exchanges bank token (evidence: `lib/actions/user.actions.ts`)
- User and bank actions → Transfer processing: creates funding source (evidence: `lib/actions/user.actions.ts`)
- Plaid client → Plaid: connects banks
- Transfer processing → Dwolla: processes transfers
- Banking user → Financial overview: views finances
- Financial overview → User and bank actions: loads user (evidence: `app/(root)/page.tsx`)
- Financial overview → Account and bank data: loads accounts (evidence: `app/(root)/page.tsx`)
- Financial overview → Balance and spending: renders (evidence: `app/(root)/page.tsx`)
- Financial overview → Recent transactions: renders (evidence: `app/(root)/page.tsx`)
- Account and bank data → User and bank actions: gets bank records (evidence: `lib/actions/bank.actions.ts`)
- Account and bank data → Plaid client: fetches account data (evidence: `lib/actions/bank.actions.ts`)
- Account and bank data → Transaction records: loads transfer records (evidence: `lib/actions/bank.actions.ts`)
- Banking user → My banks: reviews linked banks
- My banks → User and bank actions: loads user (evidence: `app/(root)/my-banks/page.tsx`)
- My banks → Account and bank data: loads accounts (evidence: `app/(root)/my-banks/page.tsx`)
- My banks → Bank account card: renders (evidence: `app/(root)/my-banks/page.tsx`)
- Banking user → Transaction history: browses transactions
- Transaction history → User and bank actions: loads user (evidence: `app/(root)/transaction-history/page.tsx`)
- Transaction history → Account and bank data: loads account data (evidence: `app/(root)/transaction-history/page.tsx`)
- Transaction history → Transactions table: renders rows (evidence: `app/(root)/transaction-history/page.tsx`)
- Banking user → Transfer funds page: initiates transfer
- Transfer funds page → User and bank actions: loads user (evidence: `app/(root)/payment-transfer/page.tsx`)
- Transfer funds page → Account and bank data: loads banks (evidence: `app/(root)/payment-transfer/page.tsx`)
- Transfer funds page → Transfer form: renders (evidence: `app/(root)/payment-transfer/page.tsx`)
- Transfer form → User and bank actions: resolves banks (evidence: `components/PaymentTransferForm.tsx`)
- Transfer form → Transfer processing: creates transfer (evidence: `components/PaymentTransferForm.tsx`)
- Transfer form → Transaction records: records transfer (evidence: `components/PaymentTransferForm.tsx`)
- Transaction records → Appwrite client: stores records (evidence: `lib/actions/transaction.actions.ts`)
- Account and bank data → Plaid: retrieves transactions
- Transfer form → Dwolla: moves funds
