# priyansh019/novabank architecture

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

## Overview

NovaBank is a banking web app for account holders to sign in, view balances and account activity, and make deposits, withdrawals, transfers, and QR payments. The React app routes these tasks through a shared API client, which attempts backend requests and includes a client-side fallback. The repository also contains a Python banking engine and a TypeScript server; their detailed runtime relationship is not established by the excerpts, so the graph keeps those services distinct. Connections reflect shown imports and calls; unsampled capabilities are represented by their known page paths.

Main entry points: [`src/App.tsx`](https://github.com/priyansh019/novabank/blob/main/src/App.tsx) (App routing), [`src/services/api.ts`](https://github.com/priyansh019/novabank/blob/main/src/services/api.ts) (API client), [`src/types/bank.ts`](https://github.com/priyansh019/novabank/blob/main/src/types/bank.ts) (Bank data types), [`src/pages/Dashboard.tsx`](https://github.com/priyansh019/novabank/blob/main/src/pages/Dashboard.tsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_app_shell["App routing<br/>[App.tsx]"]
end

subgraph group_banking["Banking workflows"]
  node_login["Sign in<br/>[Login.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_account_details["Account details<br/>[AccountDetails.tsx]"]
  node_deposit["Deposit<br/>[Deposit.tsx]"]
  node_withdraw["Withdraw<br/>[Withdraw.tsx]"]
  node_transfer["Transfer<br/>[Transfer.tsx]"]
  node_transactions["Transactions<br/>[Transactions.tsx]"]
  node_change_pin["Change PIN<br/>[ChangePin.tsx]"]
end

subgraph group_qr["QR payments"]
  node_my_qr["My QR<br/>[MyQR.tsx]"]
  node_scan_pay["Scan and pay<br/>[ScanPay.tsx]"]
  node_qr_scanner["QR scanner<br/>[QRScannerModal.tsx]"]
end

subgraph group_service["Bank services and data"]
  node_api["API client<br/>[api.ts]"]
  node_server["HTTP server<br/>[server.ts]"]
  node_python_bank["Bank engine<br/>[bank_engine.py]"]
  node_python_bank_app["Bank operations<br/>[bank.py]"]
  node_account_data[("Account records<br/>[account.csv]")]
  node_transaction_data[("Transaction records<br/>[transaction.csv]")]
  node_blocked_data[("Blocked accounts")]
  node_bank_types["Bank data types<br/>[bank.ts]"]
end

subgraph group_views["Shared interface"]
  node_balance_card["Balance card<br/>[BalanceCard.tsx]"]
  node_bank_logo["Bank identity<br/>[BankLogo.tsx]"]
  node_sidebar["Navigation sidebar<br/>[Sidebar.tsx]"]
  node_transaction_table["Transaction table"]
end

node_account_holder(("Account holder"))

node_account_holder -->|"uses"| node_app_shell
node_app_shell -->|"shows"| node_login
node_app_shell -->|"routes to"| node_dashboard
node_app_shell -->|"routes to"| node_account_details
node_app_shell -->|"routes to"| node_deposit
node_app_shell -->|"routes to"| node_withdraw
node_app_shell -->|"routes to"| node_transfer
node_app_shell -->|"routes to"| node_scan_pay
node_app_shell -->|"routes to"| node_transactions
node_app_shell -->|"routes to"| node_change_pin
node_app_shell -->|"routes to"| node_my_qr
node_app_shell -->|"fetches account"| node_api
node_app_shell -->|"renders"| node_sidebar
node_login -->|"authenticates"| node_api
node_dashboard -->|"loads data"| node_api
node_dashboard -->|"renders"| node_balance_card
node_dashboard -->|"renders"| node_transaction_table
node_transactions -->|"loads history"| node_api
node_transactions -->|"renders"| node_transaction_table
node_deposit -->|"submits deposit"| node_api
node_withdraw -->|"submits withdrawal"| node_api
node_transfer -->|"submits transfer"| node_api
node_transfer -->|"opens scanner"| node_qr_scanner
node_scan_pay -->|"submits payment"| node_api
node_scan_pay -->|"opens scanner"| node_qr_scanner
node_change_pin -->|"changes PIN"| node_api
node_my_qr -->|"refreshes account"| node_api
node_qr_scanner -->|"checks QR image"| node_api
node_api -->|"uses types"| node_bank_types
node_login -->|"uses types"| node_bank_types
node_deposit -->|"uses types"| node_bank_types
node_withdraw -->|"uses types"| node_bank_types
node_transfer -->|"uses types"| node_bank_types
node_scan_pay -->|"uses types"| node_bank_types
node_qr_scanner -->|"uses types"| node_bank_types
node_dashboard -->|"uses types"| node_bank_types
node_my_qr -->|"uses types"| node_bank_types
node_transaction_table -->|"uses types"| node_bank_types
node_api -.->|"requests"| node_server
node_server -.->|"delegates"| node_python_bank
node_python_bank_app -.->|"uses engine"| node_python_bank
node_python_bank -.->|"reads or writes"| node_account_data
node_python_bank -.->|"reads or writes"| node_transaction_data
node_python_bank -.->|"checks"| node_blocked_data
node_app_shell -->|"renders"| node_bank_logo
node_dashboard -->|"renders"| node_balance_card
node_sidebar -->|"renders"| node_bank_logo
node_my_qr -->|"renders"| node_bank_logo

click node_app_shell "https://github.com/priyansh019/novabank/blob/main/src/App.tsx"
click node_login "https://github.com/priyansh019/novabank/blob/main/src/pages/Login.tsx"
click node_dashboard "https://github.com/priyansh019/novabank/blob/main/src/pages/Dashboard.tsx"
click node_account_details "https://github.com/priyansh019/novabank/blob/main/src/pages/AccountDetails.tsx"
click node_deposit "https://github.com/priyansh019/novabank/blob/main/src/pages/Deposit.tsx"
click node_withdraw "https://github.com/priyansh019/novabank/blob/main/src/pages/Withdraw.tsx"
click node_transfer "https://github.com/priyansh019/novabank/blob/main/src/pages/Transfer.tsx"
click node_transactions "https://github.com/priyansh019/novabank/blob/main/src/pages/Transactions.tsx"
click node_change_pin "https://github.com/priyansh019/novabank/blob/main/src/pages/ChangePin.tsx"
click node_my_qr "https://github.com/priyansh019/novabank/blob/main/src/pages/MyQR.tsx"
click node_scan_pay "https://github.com/priyansh019/novabank/blob/main/src/pages/ScanPay.tsx"
click node_qr_scanner "https://github.com/priyansh019/novabank/blob/main/src/components/QRScannerModal.tsx"
click node_api "https://github.com/priyansh019/novabank/blob/main/src/services/api.ts"
click node_server "https://github.com/priyansh019/novabank/blob/main/server.ts"
click node_python_bank "https://github.com/priyansh019/novabank/blob/main/bank_engine.py"
click node_python_bank_app "https://github.com/priyansh019/novabank/blob/main/bank.py"
click node_account_data "https://github.com/priyansh019/novabank/blob/main/account.csv"
click node_transaction_data "https://github.com/priyansh019/novabank/blob/main/transaction.csv"
click node_blocked_data "https://github.com/priyansh019/novabank/blob/main/blocked_accounts.json"
click node_bank_types "https://github.com/priyansh019/novabank/blob/main/src/types/bank.ts"
click node_balance_card "https://github.com/priyansh019/novabank/blob/main/src/components/BalanceCard.tsx"
click node_bank_logo "https://github.com/priyansh019/novabank/blob/main/src/components/BankLogo.tsx"
click node_sidebar "https://github.com/priyansh019/novabank/blob/main/src/components/Sidebar.tsx"
click node_transaction_table "https://github.com/priyansh019/novabank/blob/main/src/components/TransactionTable.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_shell toneBlue
class node_login,node_dashboard,node_account_details,node_deposit,node_withdraw,node_transfer,node_transactions,node_change_pin toneAmber
class node_my_qr,node_scan_pay,node_qr_scanner toneMint
class node_api,node_server,node_python_bank,node_python_bank_app,node_account_data,node_transaction_data,node_blocked_data,node_bank_types toneRose
class node_balance_card,node_bank_logo,node_sidebar,node_transaction_table,node_account_holder toneIndigo
```

## Components

### App and navigation

- [App routing](https://github.com/priyansh019/novabank/blob/main/src/App.tsx): `src/App.tsx`

### Banking workflows

- [Sign in](https://github.com/priyansh019/novabank/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [Dashboard](https://github.com/priyansh019/novabank/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Account details](https://github.com/priyansh019/novabank/blob/main/src/pages/AccountDetails.tsx): `src/pages/AccountDetails.tsx`
- [Deposit](https://github.com/priyansh019/novabank/blob/main/src/pages/Deposit.tsx): `src/pages/Deposit.tsx`
- [Withdraw](https://github.com/priyansh019/novabank/blob/main/src/pages/Withdraw.tsx): `src/pages/Withdraw.tsx`
- [Transfer](https://github.com/priyansh019/novabank/blob/main/src/pages/Transfer.tsx): `src/pages/Transfer.tsx`
- [Transactions](https://github.com/priyansh019/novabank/blob/main/src/pages/Transactions.tsx): `src/pages/Transactions.tsx`
- [Change PIN](https://github.com/priyansh019/novabank/blob/main/src/pages/ChangePin.tsx): `src/pages/ChangePin.tsx`

### QR payments

- [My QR](https://github.com/priyansh019/novabank/blob/main/src/pages/MyQR.tsx): `src/pages/MyQR.tsx`
- [Scan and pay](https://github.com/priyansh019/novabank/blob/main/src/pages/ScanPay.tsx): `src/pages/ScanPay.tsx`
- [QR scanner](https://github.com/priyansh019/novabank/blob/main/src/components/QRScannerModal.tsx): `src/components/QRScannerModal.tsx`

### Bank services and data

- [API client](https://github.com/priyansh019/novabank/blob/main/src/services/api.ts): `src/services/api.ts`
- [HTTP server](https://github.com/priyansh019/novabank/blob/main/server.ts): `server.ts`
- [Bank engine](https://github.com/priyansh019/novabank/blob/main/bank_engine.py): `bank_engine.py`
- [Bank operations](https://github.com/priyansh019/novabank/blob/main/bank.py): `bank.py`
- [Account records](https://github.com/priyansh019/novabank/blob/main/account.csv): `account.csv`
- [Transaction records](https://github.com/priyansh019/novabank/blob/main/transaction.csv): `transaction.csv`
- [Blocked accounts](https://github.com/priyansh019/novabank/blob/main/blocked_accounts.json): `blocked_accounts.json`
- [Bank data types](https://github.com/priyansh019/novabank/blob/main/src/types/bank.ts): `src/types/bank.ts`

### Shared interface

- [Balance card](https://github.com/priyansh019/novabank/blob/main/src/components/BalanceCard.tsx): `src/components/BalanceCard.tsx`
- [Bank identity](https://github.com/priyansh019/novabank/blob/main/src/components/BankLogo.tsx): `src/components/BankLogo.tsx`
- [Navigation sidebar](https://github.com/priyansh019/novabank/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Transaction table](https://github.com/priyansh019/novabank/blob/main/src/components/TransactionTable.tsx): `src/components/TransactionTable.tsx`

### Other components

- **Account holder**

## Connections

- Account holder → App routing: uses
- App routing → Sign in: shows (evidence: `src/App.tsx`)
- App routing → Dashboard: routes to (evidence: `src/App.tsx`)
- App routing → Account details: routes to (evidence: `src/App.tsx`)
- App routing → Deposit: routes to (evidence: `src/App.tsx`)
- App routing → Withdraw: routes to (evidence: `src/App.tsx`)
- App routing → Transfer: routes to (evidence: `src/App.tsx`)
- App routing → Scan and pay: routes to (evidence: `src/App.tsx`)
- App routing → Transactions: routes to (evidence: `src/App.tsx`)
- App routing → Change PIN: routes to (evidence: `src/App.tsx`)
- App routing → My QR: routes to (evidence: `src/App.tsx`)
- App routing → API client: fetches account (evidence: `src/App.tsx`)
- App routing → Navigation sidebar: renders (evidence: `src/App.tsx`)
- Sign in → API client: authenticates (evidence: `src/pages/Login.tsx`)
- Dashboard → API client: loads data (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Balance card: renders (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Transaction table: renders (evidence: `src/pages/Dashboard.tsx`)
- Transactions → API client: loads history (evidence: `src/pages/Transactions.tsx`)
- Transactions → Transaction table: renders (evidence: `src/pages/Transactions.tsx`)
- Deposit → API client: submits deposit (evidence: `src/pages/Deposit.tsx`)
- Withdraw → API client: submits withdrawal (evidence: `src/pages/Withdraw.tsx`)
- Transfer → API client: submits transfer (evidence: `src/pages/Transfer.tsx`)
- Transfer → QR scanner: opens scanner (evidence: `src/pages/Transfer.tsx`)
- Scan and pay → API client: submits payment (evidence: `src/pages/ScanPay.tsx`)
- Scan and pay → QR scanner: opens scanner (evidence: `src/pages/ScanPay.tsx`)
- Change PIN → API client: changes PIN (evidence: `src/pages/ChangePin.tsx`)
- My QR → API client: refreshes account (evidence: `src/pages/MyQR.tsx`)
- QR scanner → API client: checks QR image (evidence: `src/components/QRScannerModal.tsx`)
- API client → Bank data types: uses types (evidence: `src/services/api.ts`)
- Sign in → Bank data types: uses types (evidence: `src/pages/Login.tsx`)
- Deposit → Bank data types: uses types (evidence: `src/pages/Deposit.tsx`)
- Withdraw → Bank data types: uses types (evidence: `src/pages/Withdraw.tsx`)
- Transfer → Bank data types: uses types (evidence: `src/pages/Transfer.tsx`)
- Scan and pay → Bank data types: uses types (evidence: `src/pages/ScanPay.tsx`)
- QR scanner → Bank data types: uses types (evidence: `src/components/QRScannerModal.tsx`)
- Dashboard → Bank data types: uses types (evidence: `src/pages/Dashboard.tsx`)
- My QR → Bank data types: uses types (evidence: `src/pages/MyQR.tsx`)
- Transaction table → Bank data types: uses types (evidence: `src/components/TransactionTable.tsx`)
- API client → HTTP server: requests
- HTTP server → Bank engine: delegates
- Bank operations → Bank engine: uses engine
- Bank engine → Account records: reads or writes
- Bank engine → Transaction records: reads or writes
- Bank engine → Blocked accounts: checks
- App routing → Bank identity: renders (evidence: `src/App.tsx`)
- Dashboard → Balance card: renders (evidence: `src/pages/Dashboard.tsx`)
- Navigation sidebar → Bank identity: renders (evidence: `src/components/Sidebar.tsx`)
- My QR → Bank identity: renders (evidence: `src/pages/MyQR.tsx`)
