# phasini2546/subsub-frontend architecture

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

- Interactive diagram: https://gitdiagram.com/phasini2546/subsub-frontend
- Repository: https://github.com/phasini2546/subsub-frontend

## Overview

SubSub is a React frontend for subscription cost-sharing, with host group management and member payment/join flows alongside personal subscriptions. The principal member path is viewing group and solo services, joining a group or managing a solo subscription, then tracking payment; hosts create and manage groups and review member payments. Data access currently uses localStorage. The route map and selected page/data-layer excerpts support the edges shown; some unsampled pages are included as documented capabilities, with their links limited to route and source-index evidence.

Main entry points: [`src/main.tsx`](https://github.com/phasini2546/subsub-frontend/blob/main/src/main.tsx) (SPA router), [`src/db.ts`](https://github.com/phasini2546/subsub-frontend/blob/main/src/db.ts) (Data access), [`src/pages/ServicesPage.tsx`](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/ServicesPage.tsx) (Services overview), [`src/pages/AddServiceForm.tsx`](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/AddServiceForm.tsx) (Solo subscription form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App routing"]
  node_router["SPA router<br/>[main.tsx]"]
end

subgraph group_member["Member experience"]
  node_services["Services overview<br/>[ServicesPage.tsx]"]
  node_soloform["Solo subscription form<br/>[AddServiceForm.tsx]"]
  node_subdetail["Subscription detail<br/>[SubDetailPage.tsx]"]
  node_memberjoin["Join group<br/>[MemberJoin.tsx]"]
  node_membergroup["Member group<br/>[MemberGroup.tsx]"]
  node_memberpay["Member payment<br/>[MemberPay.tsx]"]
  node_memberui["Payment UI<br/>[MemberUI.tsx]"]
  node_mock["Member mock data<br/>[memberMock.ts]"]
end

subgraph group_host["Host management"]
  node_groups["Groups list<br/>[GroupsPage.tsx]"]
  node_create["Create group<br/>[CreatePage.tsx]"]
  node_detail["Group administration<br/>[DetailPage.tsx]"]
  node_edit["Edit group<br/>[EditPage.tsx]"]
  node_dashboard["Spending dashboard<br/>[DashboardPage.tsx]"]
end

subgraph group_shared["Shared services"]
  node_howto["Usage guide<br/>[HowToPage.tsx]"]
  node_db["Data access<br/>[db.ts]"]
  node_storage[("Browser storage")]
  node_types["Domain types<br/>[types.ts]"]
  node_ui["Shared UI<br/>[ui.tsx]"]
  node_datepicker["Date picker<br/>[DatePicker.tsx]"]
end

node_actor(("Host or member"))

node_actor -->|"opens app"| node_router
node_router -->|"routes to"| node_services
node_router -->|"routes to"| node_memberjoin
node_router -->|"routes to"| node_memberpay
node_router -->|"routes to"| node_membergroup
node_router -->|"routes to"| node_subdetail
node_router -->|"routes to"| node_groups
node_router -->|"routes to"| node_create
node_router -->|"routes to"| node_detail
node_router -->|"routes to"| node_edit
node_router -->|"routes to"| node_dashboard
node_router -->|"routes to"| node_howto
node_services -->|"loads summaries"| node_db
node_services -->|"opens form"| node_soloform
node_services -->|"navigates to"| node_subdetail
node_soloform -->|"saves subscription"| node_db
node_memberjoin -->|"joins by code"| node_db
node_membergroup -->|"reads and updates"| node_db
node_membergroup -->|"uses payment UI"| node_memberui
node_memberpay -->|"uses data access"| node_db
node_memberjoin -->|"references mock data"| node_mock
node_memberui -->|"references mock data"| node_mock
node_groups -->|"loads groups"| node_db
node_create -->|"creates group"| node_db
node_detail -->|"manages group"| node_db
node_edit -->|"updates group"| node_db
node_dashboard -->|"loads totals"| node_db
node_subdetail -->|"uses data access"| node_db
node_db -->|"reads and writes"| node_storage
node_db -->|"uses domain types"| node_types
node_ui -->|"uses category type"| node_types
node_soloform -->|"uses picker"| node_datepicker
node_create -->|"uses picker"| node_datepicker
node_edit -->|"uses picker"| node_datepicker
node_howto -->|"uses shared UI"| node_ui

click node_router "https://github.com/phasini2546/subsub-frontend/blob/main/src/main.tsx"
click node_services "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/ServicesPage.tsx"
click node_soloform "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/AddServiceForm.tsx"
click node_subdetail "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/SubDetailPage.tsx"
click node_memberjoin "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberJoin.tsx"
click node_membergroup "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberGroup.tsx"
click node_memberpay "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberPay.tsx"
click node_memberui "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberUI.tsx"
click node_mock "https://github.com/phasini2546/subsub-frontend/blob/main/src/memberMock.ts"
click node_groups "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/GroupsPage.tsx"
click node_create "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/CreatePage.tsx"
click node_detail "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/DetailPage.tsx"
click node_edit "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/EditPage.tsx"
click node_dashboard "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/DashboardPage.tsx"
click node_howto "https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/HowToPage.tsx"
click node_db "https://github.com/phasini2546/subsub-frontend/blob/main/src/db.ts"
click node_types "https://github.com/phasini2546/subsub-frontend/blob/main/src/types.ts"
click node_ui "https://github.com/phasini2546/subsub-frontend/blob/main/src/ui.tsx"
click node_datepicker "https://github.com/phasini2546/subsub-frontend/blob/main/src/components/DatePicker.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_router toneBlue
class node_services,node_soloform,node_subdetail,node_memberjoin,node_membergroup,node_memberpay,node_memberui,node_mock toneAmber
class node_groups,node_create,node_detail,node_edit,node_dashboard toneMint
class node_howto,node_db,node_storage,node_types,node_ui,node_datepicker toneRose
class node_actor toneIndigo
```

## Components

### App routing

- [SPA router](https://github.com/phasini2546/subsub-frontend/blob/main/src/main.tsx): `src/main.tsx`

### Member experience

- [Services overview](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/ServicesPage.tsx): `src/pages/ServicesPage.tsx`
- [Solo subscription form](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/AddServiceForm.tsx): `src/pages/AddServiceForm.tsx`
- [Subscription detail](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/SubDetailPage.tsx): `src/pages/SubDetailPage.tsx`
- [Join group](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberJoin.tsx): `src/pages/MemberJoin.tsx`
- [Member group](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberGroup.tsx): `src/pages/MemberGroup.tsx`
- [Member payment](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberPay.tsx): `src/pages/MemberPay.tsx`
- [Payment UI](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/MemberUI.tsx): `src/pages/MemberUI.tsx`
- [Member mock data](https://github.com/phasini2546/subsub-frontend/blob/main/src/memberMock.ts): `src/memberMock.ts`

### Host management

- [Groups list](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/GroupsPage.tsx): `src/pages/GroupsPage.tsx`
- [Create group](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/CreatePage.tsx): `src/pages/CreatePage.tsx`
- [Group administration](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/DetailPage.tsx): `src/pages/DetailPage.tsx`
- [Edit group](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/EditPage.tsx): `src/pages/EditPage.tsx`
- [Spending dashboard](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/DashboardPage.tsx): `src/pages/DashboardPage.tsx`

### Shared services

- [Usage guide](https://github.com/phasini2546/subsub-frontend/blob/main/src/pages/HowToPage.tsx): `src/pages/HowToPage.tsx`
- [Data access](https://github.com/phasini2546/subsub-frontend/blob/main/src/db.ts): `src/db.ts`
- **Browser storage**
- [Domain types](https://github.com/phasini2546/subsub-frontend/blob/main/src/types.ts): `src/types.ts`
- [Shared UI](https://github.com/phasini2546/subsub-frontend/blob/main/src/ui.tsx): `src/ui.tsx`
- [Date picker](https://github.com/phasini2546/subsub-frontend/blob/main/src/components/DatePicker.tsx): `src/components/DatePicker.tsx`

### Other components

- **Host or member**

## Connections

- Host or member → SPA router: opens app (evidence: `src/main.tsx`)
- SPA router → Services overview: routes to (evidence: `src/main.tsx`)
- SPA router → Join group: routes to (evidence: `src/main.tsx`)
- SPA router → Member payment: routes to (evidence: `src/main.tsx`)
- SPA router → Member group: routes to (evidence: `src/main.tsx`)
- SPA router → Subscription detail: routes to (evidence: `src/main.tsx`)
- SPA router → Groups list: routes to (evidence: `src/main.tsx`)
- SPA router → Create group: routes to (evidence: `src/main.tsx`)
- SPA router → Group administration: routes to (evidence: `src/main.tsx`)
- SPA router → Edit group: routes to (evidence: `src/main.tsx`)
- SPA router → Spending dashboard: routes to (evidence: `src/main.tsx`)
- SPA router → Usage guide: routes to (evidence: `src/main.tsx`)
- Services overview → Data access: loads summaries (evidence: `src/pages/ServicesPage.tsx`)
- Services overview → Solo subscription form: opens form (evidence: `src/pages/ServicesPage.tsx`)
- Services overview → Subscription detail: navigates to (evidence: `src/pages/ServicesPage.tsx`)
- Solo subscription form → Data access: saves subscription (evidence: `README.md`)
- Join group → Data access: joins by code (evidence: `README.md`)
- Member group → Data access: reads and updates (evidence: `src/pages/MemberGroup.tsx`)
- Member group → Payment UI: uses payment UI (evidence: `src/pages/MemberGroup.tsx`)
- Member payment → Data access: uses data access (evidence: `src/pages/MemberPay.tsx`)
- Join group → Member mock data: references mock data (evidence: `src/pages/MemberJoin.tsx`)
- Payment UI → Member mock data: references mock data (evidence: `src/pages/MemberUI.tsx`)
- Groups list → Data access: loads groups (evidence: `src/pages/GroupsPage.tsx`)
- Create group → Data access: creates group (evidence: `src/pages/CreatePage.tsx`)
- Group administration → Data access: manages group (evidence: `src/pages/DetailPage.tsx`)
- Edit group → Data access: updates group (evidence: `src/pages/EditPage.tsx`)
- Spending dashboard → Data access: loads totals (evidence: `src/pages/DashboardPage.tsx`)
- Subscription detail → Data access: uses data access (evidence: `src/pages/SubDetailPage.tsx`)
- Data access → Browser storage: reads and writes (evidence: `README.md`)
- Data access → Domain types: uses domain types (evidence: `src/db.ts`)
- Shared UI → Domain types: uses category type (evidence: `src/ui.tsx`)
- Solo subscription form → Date picker: uses picker (evidence: `src/pages/AddServiceForm.tsx`)
- Create group → Date picker: uses picker (evidence: `src/pages/CreatePage.tsx`)
- Edit group → Date picker: uses picker (evidence: `src/pages/EditPage.tsx`)
- Usage guide → Shared UI: uses shared UI (evidence: `src/pages/HowToPage.tsx`)
