# vikiviki13/owezy_v1 architecture

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

- Interactive diagram: https://gitdiagram.com/vikiviki13/owezy_v1
- Repository: https://github.com/vikiviki13/owezy_v1

## Overview

Owezy is a mobile-first personal expense and repayment tracker. A user signs in, enters the private app, records expenses and repayments with friends, and reviews balances, activity, and statements; settings provide exports and security controls. The local calculation engine updates the UI immediately, while account data syncs through a per-user cloud document. The graph preserves documented capabilities, but sampled source was incomplete, so some feature-to-storage links rely on README documentation rather than inspected implementation.

Main entry points: [`src/App.tsx`](https://github.com/vikiviki13/owezy_v1/blob/main/src/App.tsx) (App routing), [`src/lib/securityService.ts`](https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/securityService.ts) (Security service), [`src/pages/Auth.tsx`](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Auth.tsx) (Account sign-in), [`src/pages/AddExpense.tsx`](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/AddExpense.tsx) (Expense entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and accounts"]
  node_app["App routing<br/>[App.tsx]"]
  node_auth["Account sign-in<br/>[Auth.tsx]"]
  node_onboard["Onboarding<br/>[Onboarding.tsx]"]
end

subgraph group_ledger["Expense ledger"]
  node_friends["Friends and groups<br/>[Friends.tsx]"]
  node_expense["Expense entry<br/>[AddExpense.tsx]"]
  node_repayment["Repayment entry"]
  node_contacts["Contact import<br/>[ContactImport.tsx]"]
end

subgraph group_insights["Views and exports"]
  node_dashboard["Dashboard<br/>[Home.tsx]"]
  node_activity["Activity and ledger<br/>[Activity.tsx]"]
  node_statements["Statements and reports<br/>[Statement.tsx]"]
  node_exports["Data exports"]
end

subgraph group_sync["Data and sync"]
  node_ledgerdb[("Expense data engine<br/>[db.ts]")]
  node_cloudinit["Cloud data setup<br/>[cloudData.ts]"]
  node_syncmanager["Sync manager<br/>[syncManager.ts]"]
  node_supabase[("Supabase services<br/>[supabase.ts]")]
end

subgraph group_security["Security and settings"]
  node_settings["Preferences and settings"]
  node_securityui["Security controls<br/>[SecurityPages.tsx]"]
  node_securityservice["Security service<br/>[securityService.ts]"]
  node_securityfunction["Security endpoint<br/>[index.ts]"]
end

node_user(("User"))
node_device(("Device authenticator"))

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_auth
node_user -->|"signs in"| node_auth
node_auth -->|"authenticates with"| node_supabase
node_app -->|"initializes data"| node_cloudinit
node_user -->|"sets up account"| node_onboard
node_user -->|"records expense"| node_expense
node_user -->|"records repayment"| node_repayment
node_user -->|"manages friends"| node_friends
node_user -->|"imports contacts"| node_contacts
node_expense -->|"writes locally"| node_ledgerdb
node_user -->|"reviews totals"| node_dashboard
node_user -->|"reviews activity"| node_activity
node_user -->|"views statements"| node_statements
node_user -->|"exports data"| node_exports
node_ledgerdb -->|"queues changes"| node_syncmanager
node_syncmanager -->|"syncs document"| node_supabase
node_user -->|"changes preferences"| node_settings
node_user -->|"manages protection"| node_securityui
node_securityui -->|"requests security actions"| node_securityservice
node_securityservice -->|"invokes endpoint"| node_securityfunction
node_securityservice -->|"starts authentication"| node_device

click node_app "https://github.com/vikiviki13/owezy_v1/blob/main/src/App.tsx"
click node_auth "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Auth.tsx"
click node_onboard "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Onboarding.tsx"
click node_dashboard "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Home.tsx"
click node_friends "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Friends.tsx"
click node_expense "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/AddExpense.tsx"
click node_repayment "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/RecordRepayment.tsx"
click node_contacts "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/ContactImport.tsx"
click node_ledgerdb "https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/db.ts"
click node_activity "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Activity.tsx"
click node_statements "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Statement.tsx"
click node_exports "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/settings/AccountSettingsPages.tsx"
click node_cloudinit "https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/cloudData.ts"
click node_syncmanager "https://github.com/vikiviki13/owezy_v1/blob/main/src/services/sync/syncManager.ts"
click node_supabase "https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/supabase.ts"
click node_settings "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/settings/PreferencePages.tsx"
click node_securityui "https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/settings/SecurityPages.tsx"
click node_securityservice "https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/securityService.ts"
click node_securityfunction "https://github.com/vikiviki13/owezy_v1/blob/main/supabase/functions/security/index.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_app,node_auth,node_onboard,node_user toneBlue
class node_friends,node_expense,node_repayment,node_contacts toneAmber
class node_dashboard,node_activity,node_statements,node_exports toneMint
class node_ledgerdb,node_cloudinit,node_syncmanager,node_supabase toneRose
class node_settings,node_securityui,node_securityservice,node_securityfunction,node_device toneIndigo
```

## Components

### App and accounts

- [App routing](https://github.com/vikiviki13/owezy_v1/blob/main/src/App.tsx): `src/App.tsx`
- [Account sign-in](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Auth.tsx): `src/pages/Auth.tsx`
- [Onboarding](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Onboarding.tsx): `src/pages/Onboarding.tsx`

### Expense ledger

- [Friends and groups](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Friends.tsx): `src/pages/Friends.tsx`
- [Expense entry](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/AddExpense.tsx): `src/pages/AddExpense.tsx`
- [Repayment entry](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/RecordRepayment.tsx): `src/pages/RecordRepayment.tsx`
- [Contact import](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/ContactImport.tsx): `src/pages/ContactImport.tsx`

### Views and exports

- [Dashboard](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Activity and ledger](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Activity.tsx): `src/pages/Activity.tsx`
- [Statements and reports](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/Statement.tsx): `src/pages/Statement.tsx`
- [Data exports](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/settings/AccountSettingsPages.tsx): `src/pages/settings/AccountSettingsPages.tsx`

### Data and sync

- [Expense data engine](https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Cloud data setup](https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/cloudData.ts): `src/lib/cloudData.ts`
- [Sync manager](https://github.com/vikiviki13/owezy_v1/blob/main/src/services/sync/syncManager.ts): `src/services/sync/syncManager.ts`
- [Supabase services](https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`

### Security and settings

- [Preferences and settings](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/settings/PreferencePages.tsx): `src/pages/settings/PreferencePages.tsx`
- [Security controls](https://github.com/vikiviki13/owezy_v1/blob/main/src/pages/settings/SecurityPages.tsx): `src/pages/settings/SecurityPages.tsx`
- [Security service](https://github.com/vikiviki13/owezy_v1/blob/main/src/lib/securityService.ts): `src/lib/securityService.ts`
- [Security endpoint](https://github.com/vikiviki13/owezy_v1/blob/main/supabase/functions/security/index.ts): `supabase/functions/security/index.ts`

### Other components

- **User**
- **Device authenticator**

## Connections

- User → App routing: opens (evidence: `README.md`)
- App routing → Account sign-in: routes to (evidence: `src/App.tsx`)
- User → Account sign-in: signs in (evidence: `README.md`)
- Account sign-in → Supabase services: authenticates with (evidence: `README.md`)
- App routing → Cloud data setup: initializes data (evidence: `src/App.tsx`)
- User → Onboarding: sets up account (evidence: `README.md`)
- User → Expense entry: records expense (evidence: `README.md`)
- User → Repayment entry: records repayment (evidence: `README.md`)
- User → Friends and groups: manages friends (evidence: `README.md`)
- User → Contact import: imports contacts (evidence: `README.md`)
- Expense entry → Expense data engine: writes locally (evidence: `src/pages/AddExpense.tsx`)
- User → Dashboard: reviews totals (evidence: `README.md`)
- User → Activity and ledger: reviews activity (evidence: `README.md`)
- User → Statements and reports: views statements (evidence: `README.md`)
- User → Data exports: exports data (evidence: `README.md`)
- Expense data engine → Sync manager: queues changes (evidence: `src/lib/db.ts`)
- Sync manager → Supabase services: syncs document (evidence: `README.md`)
- User → Preferences and settings: changes preferences (evidence: `README.md`)
- User → Security controls: manages protection (evidence: `README.md`)
- Security controls → Security service: requests security actions (evidence: `src/pages/settings/SecurityPages.tsx`)
- Security service → Security endpoint: invokes endpoint (evidence: `src/lib/securityService.ts`)
- Security service → Device authenticator: starts authentication (evidence: `src/lib/securityService.ts`)
