# kaushalrishabh/securevoice architecture

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

## Overview

SecureVoice is a browser-based encrypted notes and sharing application with a React client and Express/MySQL API. Users register or log in, establish client-held encryption keys, then create, read, and edit encrypted notes; they can organize notes, share access through invites, and receive activity updates in real time. The graph follows documented and excerpted calls. Some UI, routing, and backend details are unsampled, so their internal relationships are shown only where the source index or README supports them.

Main entry points: [`securevoice-web/src/lib/api.ts`](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/api.ts) (HTTP client), [`securevoice-web/src/pages/app/Notes.tsx`](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/pages/app/Notes.tsx) (Notes workspace), [`securevoice-api/src/db/connection.ts`](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/db/connection.ts) (MySQL pool), [`securevoice-web/src/services/notes.service.ts`](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/notes.service.ts) (Encrypted notes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App shell<br/>[App.tsx]"]
  node_routes["Page routing"]
  node_authpages["Login and register"]
  node_notespage["Notes workspace<br/>[Notes.tsx]"]
  node_noteeditor["Note editor<br/>[NoteEditor.tsx]"]
  node_notelist["Notes list<br/>[NotesList.tsx]"]
  node_sidebar["Folder sidebar<br/>[Sidebar.tsx]"]
  node_invitebanner["Invite banner"]
  node_activitypanel["Activity panel<br/>[ActivityPanel.tsx]"]
end

subgraph group_security["Client security"]
  node_authservice["Auth flows<br/>[auth.service.ts]"]
  node_cryptolib["Browser crypto<br/>[crypto.ts]"]
  node_session["Key session<br/>[session.ts]"]
  node_authstore["User session state<br/>[authStore.ts]"]
  node_notesservice["Encrypted notes<br/>[notes.service.ts]"]
  node_inviteservice["Sharing invites<br/>[invites.service.ts]"]
end

subgraph group_api["API services"]
  node_authroutes["Authentication API<br/>[auth.ts]"]
  node_noteroutes["Notes API<br/>[notes.ts]"]
  node_folderroutes["Folders API<br/>[folder.ts]"]
  node_inviteroutes["Invites API<br/>[invites.ts]"]
  node_usersroutes["Users API<br/>[users.ts]"]
  node_authmiddleware["JWT authorization<br/>[auth.ts]"]
  node_apiclient["HTTP client<br/>[api.ts]"]
end

subgraph group_realtime["Realtime activity"]
  node_activity["Activity events<br/>[activity.ts]"]
  node_websocket["Socket server<br/>[socket.ts]"]
  node_websocketclient["Socket client<br/>[socket.ts]"]
  node_activityservice["Activity client"]
end

subgraph group_persistence["Persistence"]
  node_dbpool[("MySQL pool<br/>[connection.ts]")]
end

node_user(("User"))
node_mysql[("MySQL")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_routes
node_routes -.->|"routes to"| node_authpages
node_routes -.->|"routes to"| node_notespage
node_user -.->|"submits credentials"| node_authpages
node_authpages -->|"calls"| node_authservice
node_authservice -->|"derives keys"| node_cryptolib
node_authservice -->|"stores keys"| node_session
node_authservice -->|"sends auth"| node_apiclient
node_authservice -.->|"updates state"| node_authstore
node_notespage -->|"loads and saves"| node_notesservice
node_notespage -->|"renders"| node_noteeditor
node_notespage -->|"renders"| node_notelist
node_notespage -->|"renders"| node_sidebar
node_notespage -->|"renders"| node_invitebanner
node_notespage -->|"renders"| node_activitypanel
node_noteeditor -->|"saves notes"| node_notesservice
node_notelist -->|"loads notes"| node_notesservice
node_invitebanner -->|"manages invites"| node_inviteservice
node_activitypanel -->|"loads activity"| node_activityservice
node_notesservice -->|"encrypts content"| node_cryptolib
node_notesservice -->|"gets keys"| node_session
node_notesservice -->|"transfers ciphertext"| node_apiclient
node_inviteservice -->|"wraps shared keys"| node_cryptolib
node_inviteservice -->|"gets keys"| node_session
node_inviteservice -->|"sends invites"| node_apiclient
node_activityservice -->|"fetches activity"| node_apiclient
node_apiclient -->|"reads auth state"| node_authstore
node_apiclient -.->|"HTTP requests"| node_authroutes
node_apiclient -.->|"HTTP requests"| node_noteroutes
node_apiclient -.->|"HTTP requests"| node_folderroutes
node_apiclient -.->|"HTTP requests"| node_inviteroutes
node_apiclient -.->|"HTTP requests"| node_usersroutes
node_authroutes -->|"guards private routes"| node_authmiddleware
node_noteroutes -->|"guards requests"| node_authmiddleware
node_folderroutes -->|"guards requests"| node_authmiddleware
node_inviteroutes -->|"guards requests"| node_authmiddleware
node_usersroutes -->|"guards requests"| node_authmiddleware
node_authroutes -->|"queries"| node_dbpool
node_noteroutes -->|"queries"| node_dbpool
node_folderroutes -->|"queries"| node_dbpool
node_inviteroutes -->|"queries"| node_dbpool
node_usersroutes -->|"queries"| node_dbpool
node_dbpool -->|"stores data"| node_mysql
node_noteroutes -->|"records activity"| node_activity
node_inviteroutes -->|"records activity"| node_activity
node_activity -->|"emits events"| node_websocket
node_websocket -->|"checks note access"| node_dbpool

click node_app "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/App.tsx"
click node_routes "https://github.com/kaushalrishabh/securevoice/tree/main/securevoice-web/src/router"
click node_authpages "https://github.com/kaushalrishabh/securevoice/tree/main/securevoice-web/src/pages/auth"
click node_notespage "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/pages/app/Notes.tsx"
click node_noteeditor "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/NoteEditor.tsx"
click node_notelist "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/NotesList.tsx"
click node_sidebar "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/layout/Sidebar.tsx"
click node_invitebanner "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/PendingInvitesBanner.tsx"
click node_activitypanel "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/ActivityPanel.tsx"
click node_authservice "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/auth.service.ts"
click node_cryptolib "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/crypto.ts"
click node_session "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/session.ts"
click node_authstore "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/store/authStore.ts"
click node_notesservice "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/notes.service.ts"
click node_inviteservice "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/invites.service.ts"
click node_authroutes "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/auth.ts"
click node_noteroutes "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/notes.ts"
click node_folderroutes "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/folder.ts"
click node_inviteroutes "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/invites.ts"
click node_usersroutes "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/users.ts"
click node_authmiddleware "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/middleware/auth.ts"
click node_activity "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/lib/activity.ts"
click node_websocket "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/socket.ts"
click node_websocketclient "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/socket.ts"
click node_activityservice "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/activity.service.ts"
click node_apiclient "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/api.ts"
click node_dbpool "https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/db/connection.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_routes,node_authpages,node_notespage,node_noteeditor,node_notelist,node_sidebar,node_invitebanner,node_activitypanel,node_user toneBlue
class node_authservice,node_cryptolib,node_session,node_authstore,node_notesservice,node_inviteservice,node_mysql toneAmber
class node_authroutes,node_noteroutes,node_folderroutes,node_inviteroutes,node_usersroutes,node_authmiddleware,node_apiclient toneMint
class node_activity,node_websocket,node_websocketclient,node_activityservice toneRose
class node_dbpool toneIndigo
```

## Components

### Web client

- [App shell](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/App.tsx): `securevoice-web/src/App.tsx`
- [Page routing](https://github.com/kaushalrishabh/securevoice/tree/main/securevoice-web/src/router): `securevoice-web/src/router`
- [Login and register](https://github.com/kaushalrishabh/securevoice/tree/main/securevoice-web/src/pages/auth): `securevoice-web/src/pages/auth`
- [Notes workspace](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/pages/app/Notes.tsx): `securevoice-web/src/pages/app/Notes.tsx`
- [Note editor](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/NoteEditor.tsx): `securevoice-web/src/components/notes/NoteEditor.tsx`
- [Notes list](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/NotesList.tsx): `securevoice-web/src/components/notes/NotesList.tsx`
- [Folder sidebar](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/layout/Sidebar.tsx): `securevoice-web/src/components/layout/Sidebar.tsx`
- [Invite banner](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/PendingInvitesBanner.tsx): `securevoice-web/src/components/notes/PendingInvitesBanner.tsx`
- [Activity panel](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/components/notes/ActivityPanel.tsx): `securevoice-web/src/components/notes/ActivityPanel.tsx`

### Client security

- [Auth flows](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/auth.service.ts): `securevoice-web/src/services/auth.service.ts`
- [Browser crypto](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/crypto.ts): `securevoice-web/src/lib/crypto.ts`
- [Key session](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/session.ts): `securevoice-web/src/lib/session.ts`
- [User session state](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/store/authStore.ts): `securevoice-web/src/store/authStore.ts`
- [Encrypted notes](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/notes.service.ts): `securevoice-web/src/services/notes.service.ts`
- [Sharing invites](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/invites.service.ts): `securevoice-web/src/services/invites.service.ts`

### API services

- [Authentication API](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/auth.ts): `securevoice-api/src/routes/auth.ts`
- [Notes API](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/notes.ts): `securevoice-api/src/routes/notes.ts`
- [Folders API](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/folder.ts): `securevoice-api/src/routes/folder.ts`
- [Invites API](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/invites.ts): `securevoice-api/src/routes/invites.ts`
- [Users API](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/routes/users.ts): `securevoice-api/src/routes/users.ts`
- [JWT authorization](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/middleware/auth.ts): `securevoice-api/src/middleware/auth.ts`
- [HTTP client](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/api.ts): `securevoice-web/src/lib/api.ts`

### Realtime activity

- [Activity events](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/lib/activity.ts): `securevoice-api/src/lib/activity.ts`
- [Socket server](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/socket.ts): `securevoice-api/src/socket.ts`
- [Socket client](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/lib/socket.ts): `securevoice-web/src/lib/socket.ts`
- [Activity client](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-web/src/services/activity.service.ts): `securevoice-web/src/services/activity.service.ts`

### Persistence

- [MySQL pool](https://github.com/kaushalrishabh/securevoice/blob/main/securevoice-api/src/db/connection.ts): `securevoice-api/src/db/connection.ts`

### Other components

- **User**
- **MySQL**

## Connections

- User → App shell: uses (evidence: `securevoice-web/src/App.tsx`)
- App shell → Page routing: renders (evidence: `securevoice-web/src/App.tsx`)
- Page routing → Login and register: routes to
- Page routing → Notes workspace: routes to
- User → Login and register: submits credentials
- Login and register → Auth flows: calls (evidence: `securevoice-web/src/services/auth.service.ts`)
- Auth flows → Browser crypto: derives keys (evidence: `securevoice-web/src/services/auth.service.ts`)
- Auth flows → Key session: stores keys (evidence: `securevoice-web/src/services/auth.service.ts`)
- Auth flows → HTTP client: sends auth (evidence: `securevoice-web/src/services/auth.service.ts`)
- Auth flows → User session state: updates state
- Notes workspace → Encrypted notes: loads and saves (evidence: `securevoice-web/src/pages/app/Notes.tsx`)
- Notes workspace → Note editor: renders (evidence: `securevoice-web/src/pages/app/Notes.tsx`)
- Notes workspace → Notes list: renders (evidence: `securevoice-web/src/pages/app/Notes.tsx`)
- Notes workspace → Folder sidebar: renders (evidence: `securevoice-web/src/pages/app/Notes.tsx`)
- Notes workspace → Invite banner: renders (evidence: `securevoice-web/src/pages/app/Notes.tsx`)
- Notes workspace → Activity panel: renders (evidence: `securevoice-web/src/pages/app/Notes.tsx`)
- Note editor → Encrypted notes: saves notes (evidence: `securevoice-web/src/components/notes/NoteEditor.tsx`)
- Notes list → Encrypted notes: loads notes (evidence: `securevoice-web/src/components/notes/NotesList.tsx`)
- Invite banner → Sharing invites: manages invites (evidence: `securevoice-web/src/components/notes/PendingInvitesBanner.tsx`)
- Activity panel → Activity client: loads activity (evidence: `securevoice-web/src/components/notes/ActivityPanel.tsx`)
- Encrypted notes → Browser crypto: encrypts content (evidence: `securevoice-web/src/services/notes.service.ts`)
- Encrypted notes → Key session: gets keys (evidence: `securevoice-web/src/services/notes.service.ts`)
- Encrypted notes → HTTP client: transfers ciphertext (evidence: `securevoice-web/src/services/notes.service.ts`)
- Sharing invites → Browser crypto: wraps shared keys (evidence: `securevoice-web/src/services/invites.service.ts`)
- Sharing invites → Key session: gets keys (evidence: `securevoice-web/src/services/invites.service.ts`)
- Sharing invites → HTTP client: sends invites (evidence: `securevoice-web/src/services/invites.service.ts`)
- Activity client → HTTP client: fetches activity (evidence: `securevoice-web/src/services/activity.service.ts`)
- HTTP client → User session state: reads auth state (evidence: `securevoice-web/src/lib/api.ts`)
- HTTP client → Authentication API: HTTP requests
- HTTP client → Notes API: HTTP requests
- HTTP client → Folders API: HTTP requests
- HTTP client → Invites API: HTTP requests
- HTTP client → Users API: HTTP requests
- Authentication API → JWT authorization: guards private routes (evidence: `securevoice-api/src/routes/auth.ts`)
- Notes API → JWT authorization: guards requests (evidence: `securevoice-api/src/routes/notes.ts`)
- Folders API → JWT authorization: guards requests (evidence: `securevoice-api/src/routes/folder.ts`)
- Invites API → JWT authorization: guards requests (evidence: `securevoice-api/src/routes/invites.ts`)
- Users API → JWT authorization: guards requests (evidence: `securevoice-api/src/routes/users.ts`)
- Authentication API → MySQL pool: queries (evidence: `securevoice-api/src/routes/auth.ts`)
- Notes API → MySQL pool: queries (evidence: `securevoice-api/src/routes/notes.ts`)
- Folders API → MySQL pool: queries (evidence: `securevoice-api/src/routes/folder.ts`)
- Invites API → MySQL pool: queries (evidence: `securevoice-api/src/routes/invites.ts`)
- Users API → MySQL pool: queries (evidence: `securevoice-api/src/routes/users.ts`)
- MySQL pool → MySQL: stores data (evidence: `securevoice-api/src/db/connection.ts`)
- Notes API → Activity events: records activity (evidence: `securevoice-api/src/routes/notes.ts`)
- Invites API → Activity events: records activity (evidence: `securevoice-api/src/routes/invites.ts`)
- Activity events → Socket server: emits events (evidence: `securevoice-api/src/lib/activity.ts`)
- Socket server → MySQL pool: checks note access (evidence: `securevoice-api/src/socket.ts`)
