# anshikagknp/fairshare-expense-splitter architecture

> Architecture diagram of the GitHub repository anshikagknp/fairshare-expense-splitter, 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/anshikagknp/fairshare-expense-splitter
- Repository: https://github.com/anshikagknp/fairshare-expense-splitter

## Overview

FairShare is a browser-based group expense splitter. Users add members and record expenses with equal or custom shares; the app calculates net balances and greedily reduces them to a minimal set of settlement payments, while showing expense history. Users can work in Guest Mode or sign in for Firebase-backed cloud sync. The README documents these product capabilities; the sampled script excerpt shows UI event handling and Firestore loading, but not the full calculation or authentication implementation.

Main entry points: [`script.js`](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js) (App Controller), [`index.html`](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/index.html) (FairShare Page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User Interface"]
  node_page["FairShare Page<br/>[index.html]"]
  node_app["App Controller<br/>[script.js]"]
end

subgraph group_ledger["Expense Ledger"]
  node_members["Member Management<br/>[script.js]"]
  node_expenses["Expense Splitting<br/>[script.js]"]
  node_history["Expense History<br/>[script.js]"]
end

subgraph group_settlement["Balance Settlement"]
  node_balances["Net Balances<br/>[script.js]"]
  node_optimizer["Greedy Settlement<br/>[script.js]"]
end

subgraph group_identity["Identity and Sync"]
  node_auth["Account Sign-In<br/>[script.js]"]
  node_fireauth["Firebase Auth"]
  node_cloud[("Cloud Firestore")]
end

node_user(("Group Member"))

node_user -->|"uses"| node_page
node_page -->|"binds events"| node_app
node_app -->|"updates"| node_members
node_app -->|"records splits"| node_expenses
node_app -->|"shows"| node_history
node_app -->|"calculates"| node_balances
node_balances -->|"nets debts"| node_optimizer
node_app -->|"offers sign-in"| node_auth
node_auth -->|"authenticates"| node_fireauth
node_app -->|"loads and saves"| node_cloud

click node_page "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/index.html"
click node_app "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"
click node_members "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"
click node_expenses "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"
click node_history "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"
click node_balances "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"
click node_optimizer "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"
click node_auth "https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js"

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_page,node_app toneBlue
class node_members,node_expenses,node_history toneAmber
class node_balances,node_optimizer toneMint
class node_auth,node_fireauth,node_cloud toneRose
class node_user toneIndigo
```

## Components

### User Interface

- [FairShare Page](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/index.html): `index.html`
- [App Controller](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`

### Expense Ledger

- [Member Management](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`
- [Expense Splitting](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`
- [Expense History](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`

### Balance Settlement

- [Net Balances](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`
- [Greedy Settlement](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`

### Identity and Sync

- [Account Sign-In](https://github.com/anshikagknp/fairshare-expense-splitter/blob/main/script.js): `script.js`
- **Firebase Auth**
- **Cloud Firestore**

### Other components

- **Group Member**

## Connections

- Group Member → FairShare Page: uses (evidence: `README.md`)
- FairShare Page → App Controller: binds events (evidence: `script.js`)
- App Controller → Member Management: updates (evidence: `script.js`)
- App Controller → Expense Splitting: records splits (evidence: `README.md`)
- App Controller → Expense History: shows (evidence: `README.md`)
- App Controller → Net Balances: calculates (evidence: `README.md`)
- Net Balances → Greedy Settlement: nets debts (evidence: `README.md`)
- App Controller → Account Sign-In: offers sign-in (evidence: `README.md`)
- Account Sign-In → Firebase Auth: authenticates (evidence: `README.md`)
- App Controller → Cloud Firestore: loads and saves (evidence: `script.js`)
