# yumesenseii/cash-aura architecture

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

- Interactive diagram: https://gitdiagram.com/yumesenseii/cash-aura
- Repository: https://github.com/yumesenseii/cash-aura

## Overview

Cashora is a local-first, iPhone-oriented cash tracker for students and young adults. Users set up preferences and starting cash, log expenses and savings, then review safe-to-spend progress, a cash timeline, history, goals, and lightweight insights. The app context owns state changes and persists them through browser localStorage; no server database or account system is documented. Edges reflect the supplied source index and excerpts plus README statements; some page implementations and the PWA manifest were not sampled, so those links are limited to documented capabilities.

Main entry points: [`src/context/CashoraContext.tsx`](https://github.com/yumesenseii/cash-aura/blob/main/src/context/CashoraContext.tsx) (Cashora state), [`src/components/HomeScreen.tsx`](https://github.com/yumesenseii/cash-aura/blob/main/src/components/HomeScreen.tsx) (Daily overview), [`src/app/app/goals/page.tsx`](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/goals/page.tsx) (Savings goals), [`src/components/Modal.tsx`](https://github.com/yumesenseii/cash-aura/blob/main/src/components/Modal.tsx) (Modal component)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_app_shell["App shell<br/>[layout.tsx]"]
  node_navigation["Bottom navigation<br/>[BottomNav.tsx]"]
  node_onboarding["Onboarding<br/>[page.tsx]"]
  node_profile["Profile settings<br/>[page.tsx]"]
  node_modal["Modal component<br/>[Modal.tsx]"]
  node_surface["Surface components<br/>[Surface.tsx]"]
  node_ring["Progress ring<br/>[RingProgress.tsx]"]
  node_spark["Area chart<br/>[AreaSpark.tsx]"]
  node_manifest["PWA manifest"]
end

subgraph group_tracking["Cash tracking"]
  node_home["Daily overview<br/>[HomeScreen.tsx]"]
  node_expense_entry["Expense entry"]
  node_savings_entry["Savings entry"]
  node_starting_cash["Starting cash entry"]
  node_timeline["Cash timeline<br/>[CashTimeline.tsx]"]
  node_daily_check["Daily cash check<br/>[DailyCashCheck.tsx]"]
end

subgraph group_review["Review and goals"]
  node_history["Transaction history<br/>[page.tsx]"]
  node_goals["Savings goals<br/>[page.tsx]"]
  node_insights["Spending insights<br/>[page.tsx]"]
end

subgraph group_state["State and persistence"]
  node_context["Cashora state<br/>[CashoraContext.tsx]"]
  node_storage[("Local storage<br/>[storage.ts]")]
  node_domain_types["Cash data model<br/>[types.ts]"]
  node_utilities["Cash calculations<br/>[utils.ts]"]
end

node_user(("Cash tracker"))

node_user -->|"opens"| node_landing
node_user -->|"uses"| node_app_shell
node_app_shell -->|"renders"| node_navigation
node_user -->|"sets up"| node_onboarding
node_onboarding -->|"updates preferences"| node_context
node_user -->|"tracks cash"| node_home
node_home -->|"reads and updates"| node_context
node_home -->|"opens"| node_expense_entry
node_home -->|"opens"| node_savings_entry
node_home -->|"opens"| node_starting_cash
node_home -->|"renders"| node_timeline
node_home -->|"renders"| node_daily_check
node_expense_entry -.->|"records expense"| node_context
node_savings_entry -.->|"records savings"| node_context
node_starting_cash -.->|"sets starting cash"| node_context
node_history -->|"reads and edits transactions"| node_context
node_goals -.->|"reads and updates goals"| node_context
node_goals -->|"opens"| node_savings_entry
node_insights -->|"reads cash data"| node_context
node_profile -.->|"reads and updates preferences"| node_context
node_context -->|"loads and saves"| node_storage
node_context -->|"uses date and ID helpers"| node_utilities
node_context -->|"uses state types"| node_domain_types
node_storage -->|"normalizes state"| node_domain_types
node_history -->|"renders"| node_modal
node_goals -->|"renders"| node_modal
node_goals -->|"renders"| node_surface
node_goals -->|"renders"| node_ring
node_history -->|"renders"| node_surface
node_insights -->|"renders"| node_surface
node_insights -->|"renders"| node_ring
node_insights -->|"renders"| node_spark
node_home -->|"renders"| node_surface
node_home -->|"renders"| node_ring
node_expense_entry -->|"uses"| node_modal
node_savings_entry -->|"uses"| node_modal
node_starting_cash -->|"uses"| node_modal
node_user -->|"installs from"| node_manifest

click node_landing "https://github.com/yumesenseii/cash-aura/blob/main/src/app/page.tsx"
click node_app_shell "https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/layout.tsx"
click node_navigation "https://github.com/yumesenseii/cash-aura/blob/main/src/components/BottomNav.tsx"
click node_onboarding "https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/onboarding/page.tsx"
click node_profile "https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/profile/page.tsx"
click node_home "https://github.com/yumesenseii/cash-aura/blob/main/src/components/HomeScreen.tsx"
click node_expense_entry "https://github.com/yumesenseii/cash-aura/blob/main/src/components/AddExpenseModal.tsx"
click node_savings_entry "https://github.com/yumesenseii/cash-aura/blob/main/src/components/AddSavingsModal.tsx"
click node_starting_cash "https://github.com/yumesenseii/cash-aura/blob/main/src/components/StartingCashModal.tsx"
click node_timeline "https://github.com/yumesenseii/cash-aura/blob/main/src/components/CashTimeline.tsx"
click node_daily_check "https://github.com/yumesenseii/cash-aura/blob/main/src/components/DailyCashCheck.tsx"
click node_history "https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/history/page.tsx"
click node_goals "https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/goals/page.tsx"
click node_insights "https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/insights/page.tsx"
click node_context "https://github.com/yumesenseii/cash-aura/blob/main/src/context/CashoraContext.tsx"
click node_storage "https://github.com/yumesenseii/cash-aura/blob/main/src/lib/storage.ts"
click node_domain_types "https://github.com/yumesenseii/cash-aura/blob/main/src/lib/types.ts"
click node_utilities "https://github.com/yumesenseii/cash-aura/blob/main/src/lib/utils.ts"
click node_modal "https://github.com/yumesenseii/cash-aura/blob/main/src/components/Modal.tsx"
click node_surface "https://github.com/yumesenseii/cash-aura/blob/main/src/components/ui/Surface.tsx"
click node_ring "https://github.com/yumesenseii/cash-aura/blob/main/src/components/ui/RingProgress.tsx"
click node_spark "https://github.com/yumesenseii/cash-aura/blob/main/src/components/ui/AreaSpark.tsx"
click node_manifest "https://github.com/yumesenseii/cash-aura/blob/main/public/manifest.webmanifest"

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_landing,node_app_shell,node_navigation,node_onboarding,node_profile,node_modal,node_surface,node_ring,node_spark,node_manifest toneBlue
class node_home,node_expense_entry,node_savings_entry,node_starting_cash,node_timeline,node_daily_check toneAmber
class node_history,node_goals,node_insights toneMint
class node_context,node_storage,node_domain_types,node_utilities toneRose
class node_user toneIndigo
```

## Components

### App experience

- [Landing page](https://github.com/yumesenseii/cash-aura/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [App shell](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/layout.tsx): `src/app/app/layout.tsx`
- [Bottom navigation](https://github.com/yumesenseii/cash-aura/blob/main/src/components/BottomNav.tsx): `src/components/BottomNav.tsx`
- [Onboarding](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/onboarding/page.tsx): `src/app/app/onboarding/page.tsx`
- [Profile settings](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/profile/page.tsx): `src/app/app/profile/page.tsx`
- [Modal component](https://github.com/yumesenseii/cash-aura/blob/main/src/components/Modal.tsx): `src/components/Modal.tsx`
- [Surface components](https://github.com/yumesenseii/cash-aura/blob/main/src/components/ui/Surface.tsx): `src/components/ui/Surface.tsx`
- [Progress ring](https://github.com/yumesenseii/cash-aura/blob/main/src/components/ui/RingProgress.tsx): `src/components/ui/RingProgress.tsx`
- [Area chart](https://github.com/yumesenseii/cash-aura/blob/main/src/components/ui/AreaSpark.tsx): `src/components/ui/AreaSpark.tsx`
- [PWA manifest](https://github.com/yumesenseii/cash-aura/blob/main/public/manifest.webmanifest): `public/manifest.webmanifest`

### Cash tracking

- [Daily overview](https://github.com/yumesenseii/cash-aura/blob/main/src/components/HomeScreen.tsx): `src/components/HomeScreen.tsx`
- [Expense entry](https://github.com/yumesenseii/cash-aura/blob/main/src/components/AddExpenseModal.tsx): `src/components/AddExpenseModal.tsx`
- [Savings entry](https://github.com/yumesenseii/cash-aura/blob/main/src/components/AddSavingsModal.tsx): `src/components/AddSavingsModal.tsx`
- [Starting cash entry](https://github.com/yumesenseii/cash-aura/blob/main/src/components/StartingCashModal.tsx): `src/components/StartingCashModal.tsx`
- [Cash timeline](https://github.com/yumesenseii/cash-aura/blob/main/src/components/CashTimeline.tsx): `src/components/CashTimeline.tsx`
- [Daily cash check](https://github.com/yumesenseii/cash-aura/blob/main/src/components/DailyCashCheck.tsx): `src/components/DailyCashCheck.tsx`

### Review and goals

- [Transaction history](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/history/page.tsx): `src/app/app/history/page.tsx`
- [Savings goals](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/goals/page.tsx): `src/app/app/goals/page.tsx`
- [Spending insights](https://github.com/yumesenseii/cash-aura/blob/main/src/app/app/insights/page.tsx): `src/app/app/insights/page.tsx`

### State and persistence

- [Cashora state](https://github.com/yumesenseii/cash-aura/blob/main/src/context/CashoraContext.tsx): `src/context/CashoraContext.tsx`
- [Local storage](https://github.com/yumesenseii/cash-aura/blob/main/src/lib/storage.ts): `src/lib/storage.ts`
- [Cash data model](https://github.com/yumesenseii/cash-aura/blob/main/src/lib/types.ts): `src/lib/types.ts`
- [Cash calculations](https://github.com/yumesenseii/cash-aura/blob/main/src/lib/utils.ts): `src/lib/utils.ts`

### Other components

- **Cash tracker**

## Connections

- Cash tracker → Landing page: opens (evidence: `README.md`)
- Cash tracker → App shell: uses (evidence: `README.md`)
- App shell → Bottom navigation: renders (evidence: `src/app/app/layout.tsx`)
- Cash tracker → Onboarding: sets up (evidence: `README.md`)
- Onboarding → Cashora state: updates preferences (evidence: `src/app/app/onboarding/page.tsx`)
- Cash tracker → Daily overview: tracks cash (evidence: `README.md`)
- Daily overview → Cashora state: reads and updates (evidence: `src/components/HomeScreen.tsx`)
- Daily overview → Expense entry: opens (evidence: `src/components/HomeScreen.tsx`)
- Daily overview → Savings entry: opens (evidence: `src/components/HomeScreen.tsx`)
- Daily overview → Starting cash entry: opens (evidence: `src/components/HomeScreen.tsx`)
- Daily overview → Cash timeline: renders (evidence: `src/components/HomeScreen.tsx`)
- Daily overview → Daily cash check: renders (evidence: `src/components/HomeScreen.tsx`)
- Expense entry → Cashora state: records expense
- Savings entry → Cashora state: records savings
- Starting cash entry → Cashora state: sets starting cash
- Transaction history → Cashora state: reads and edits transactions (evidence: `src/app/app/history/page.tsx`)
- Savings goals → Cashora state: reads and updates goals (evidence: `src/app/app/goals/page.tsx`)
- Savings goals → Savings entry: opens (evidence: `src/app/app/goals/page.tsx`)
- Spending insights → Cashora state: reads cash data (evidence: `src/app/app/insights/page.tsx`)
- Profile settings → Cashora state: reads and updates preferences (evidence: `src/app/app/profile/page.tsx`)
- Cashora state → Local storage: loads and saves (evidence: `src/context/CashoraContext.tsx`)
- Cashora state → Cash calculations: uses date and ID helpers (evidence: `src/context/CashoraContext.tsx`)
- Cashora state → Cash data model: uses state types (evidence: `src/context/CashoraContext.tsx`)
- Local storage → Cash data model: normalizes state (evidence: `src/lib/storage.ts`)
- Transaction history → Modal component: renders (evidence: `src/app/app/history/page.tsx`)
- Savings goals → Modal component: renders (evidence: `src/app/app/goals/page.tsx`)
- Savings goals → Surface components: renders (evidence: `src/app/app/goals/page.tsx`)
- Savings goals → Progress ring: renders (evidence: `src/app/app/goals/page.tsx`)
- Transaction history → Surface components: renders (evidence: `src/app/app/history/page.tsx`)
- Spending insights → Surface components: renders (evidence: `src/app/app/insights/page.tsx`)
- Spending insights → Progress ring: renders (evidence: `src/app/app/insights/page.tsx`)
- Spending insights → Area chart: renders (evidence: `src/app/app/insights/page.tsx`)
- Daily overview → Surface components: renders (evidence: `src/components/HomeScreen.tsx`)
- Daily overview → Progress ring: renders (evidence: `src/components/HomeScreen.tsx`)
- Expense entry → Modal component: uses (evidence: `src/components/AddExpenseModal.tsx`)
- Savings entry → Modal component: uses (evidence: `src/components/AddSavingsModal.tsx`)
- Starting cash entry → Modal component: uses (evidence: `src/components/StartingCashModal.tsx`)
- Cash tracker → PWA manifest: installs from (evidence: `README.md`)
