# kajamaqbool/encrypted-chat-app architecture

> Architecture diagram of the GitHub repository kajamaqbool/encrypted-chat-app, 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/kajamaqbool/encrypted-chat-app
- Repository: https://github.com/kajamaqbool/encrypted-chat-app

## Overview

Encrypted Chat App is a MERN chat product. A user signs up or logs in, then enters the protected chat view to browse users, select a conversation, load history, and send text or images; messages can also arrive live, with online presence shown in the UI. The graph separates frontend screens and state, backend API/auth, persistence and media, and realtime transport. The README documents protected APIs, cloud image storage and themes; unsampled implementation details are represented only where documented, and evidence limits are noted on uncertain connections.

Main entry points: [`frontend/src/App.jsx`](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/App.jsx) (App routing), [`frontend/src/store/useAuthStore.js`](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useAuthStore.js) (Auth state), [`backend/src/controllers/message.controller.js`](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/controllers/message.controller.js) (Message handlers), [`frontend/src/store/useChatStore.js`](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useChatStore.js) (Chat state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Frontend experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_signup["Sign up<br/>[SignUpPage.jsx]"]
  node_login["Login<br/>[LoginPage.jsx]"]
  node_home["Chat home<br/>[HomePage.jsx]"]
  node_sidebar["User sidebar<br/>[Sidebar.jsx]"]
  node_chatui["Conversation UI<br/>[ChatContainer.jsx]"]
  node_messageinput["Message composer<br/>[MessageInput.jsx]"]
  node_profile["Profile settings<br/>[ProfilePage.jsx]"]
  node_settings["Theme settings<br/>[SettingsPage.jsx]"]
  node_authstate["Auth state<br/>[useAuthStore.js]"]
  node_chatstate["Chat state<br/>[useChatStore.js]"]
  node_themestate["Theme state<br/>[useThemeStore.js]"]
  node_axios["HTTP client<br/>[axios.js]"]
end

subgraph group_api["Backend API"]
  node_authroutes["Auth routes<br/>[auth.route.js]"]
  node_messageroutes["Message routes<br/>[message.route.js]"]
  node_authcontroller["Auth handlers<br/>[auth.controller.js]"]
  node_messagecontroller["Message handlers"]
  node_authmiddleware["JWT guard<br/>[auth.middleware.js]"]
  node_server["Server entry<br/>[index.js]"]
end

subgraph group_data["Persistence and media"]
  node_users[("User records<br/>[user.model.js]")]
  node_messages[("Message records<br/>[message.model.js]")]
  node_database[("MongoDB connection<br/>[db.js]")]
  node_cloudinary["Cloudinary media<br/>[cloudinary.js]"]
end

subgraph group_realtime["Realtime messaging"]
  node_socket["Socket.IO server<br/>[socket.js]"]
end

node_user(("Chat user"))

node_user -->|"opens app"| node_app
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_settings
node_signup -->|"submits signup"| node_authstate
node_login -->|"submits login"| node_authstate
node_profile -->|"updates profile"| node_authstate
node_settings -->|"changes theme"| node_themestate
node_home -->|"loads chat"| node_chatstate
node_home -->|"renders"| node_sidebar
node_home -->|"renders"| node_chatui
node_chatui -->|"renders"| node_messageinput
node_sidebar -->|"selects user"| node_chatstate
node_messageinput -->|"sends message"| node_chatstate
node_authstate -->|"requests API"| node_axios
node_chatstate -->|"requests API"| node_axios
node_authstate -->|"connects realtime"| node_socket
node_chatstate -->|"listens messages"| node_socket
node_server -->|"connects"| node_database
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_messageroutes
node_server -->|"uses server"| node_socket
node_authroutes -->|"dispatches"| node_authcontroller
node_authroutes -->|"guards endpoints"| node_authmiddleware
node_messageroutes -->|"guards endpoints"| node_authmiddleware
node_messageroutes -->|"dispatches"| node_messagecontroller
node_authmiddleware -->|"loads user"| node_users
node_authcontroller -->|"reads and writes"| node_users
node_authcontroller -->|"uploads profile image"| node_cloudinary
node_messagecontroller -->|"queries users"| node_users
node_messagecontroller -->|"reads and writes"| node_messages
node_messagecontroller -->|"uploads image"| node_cloudinary
node_messagecontroller -->|"emits message"| node_socket
node_socket -->|"broadcasts presence"| node_authstate

click node_app "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/App.jsx"
click node_signup "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/SignUpPage.jsx"
click node_login "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/LoginPage.jsx"
click node_home "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/HomePage.jsx"
click node_sidebar "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/components/Sidebar.jsx"
click node_chatui "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/components/ChatContainer.jsx"
click node_messageinput "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/components/MessageInput.jsx"
click node_profile "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/ProfilePage.jsx"
click node_settings "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/SettingsPage.jsx"
click node_authstate "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useAuthStore.js"
click node_chatstate "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useChatStore.js"
click node_themestate "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useThemeStore.js"
click node_axios "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/lib/axios.js"
click node_authroutes "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/routes/auth.route.js"
click node_messageroutes "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/routes/message.route.js"
click node_authcontroller "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/controllers/auth.controller.js"
click node_messagecontroller "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/controllers/message.controller.js"
click node_authmiddleware "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/middleware/auth.middleware.js"
click node_server "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/index.js"
click node_users "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/models/user.model.js"
click node_messages "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/models/message.model.js"
click node_database "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/lib/db.js"
click node_cloudinary "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/lib/cloudinary.js"
click node_socket "https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/lib/socket.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_app,node_signup,node_login,node_home,node_sidebar,node_chatui,node_messageinput,node_profile,node_settings,node_authstate,node_chatstate,node_themestate,node_axios,node_user toneBlue
class node_authroutes,node_messageroutes,node_authcontroller,node_messagecontroller,node_authmiddleware,node_server toneAmber
class node_users,node_messages,node_database,node_cloudinary toneMint
class node_socket toneRose
```

## Components

### Frontend experience

- [App routing](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sign up](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/SignUpPage.jsx): `frontend/src/pages/SignUpPage.jsx`
- [Login](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/LoginPage.jsx): `frontend/src/pages/LoginPage.jsx`
- [Chat home](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [User sidebar](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/components/Sidebar.jsx): `frontend/src/components/Sidebar.jsx`
- [Conversation UI](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/components/ChatContainer.jsx): `frontend/src/components/ChatContainer.jsx`
- [Message composer](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/components/MessageInput.jsx): `frontend/src/components/MessageInput.jsx`
- [Profile settings](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/ProfilePage.jsx): `frontend/src/pages/ProfilePage.jsx`
- [Theme settings](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/pages/SettingsPage.jsx): `frontend/src/pages/SettingsPage.jsx`
- [Auth state](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useAuthStore.js): `frontend/src/store/useAuthStore.js`
- [Chat state](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useChatStore.js): `frontend/src/store/useChatStore.js`
- [Theme state](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/store/useThemeStore.js): `frontend/src/store/useThemeStore.js`
- [HTTP client](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/frontend/src/lib/axios.js): `frontend/src/lib/axios.js`

### Backend API

- [Auth routes](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/routes/auth.route.js): `backend/src/routes/auth.route.js`
- [Message routes](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/routes/message.route.js): `backend/src/routes/message.route.js`
- [Auth handlers](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Message handlers](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/controllers/message.controller.js): `backend/src/controllers/message.controller.js`
- [JWT guard](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/middleware/auth.middleware.js): `backend/src/middleware/auth.middleware.js`
- [Server entry](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/index.js): `backend/src/index.js`

### Persistence and media

- [User records](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/models/user.model.js): `backend/src/models/user.model.js`
- [Message records](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/models/message.model.js): `backend/src/models/message.model.js`
- [MongoDB connection](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/lib/db.js): `backend/src/lib/db.js`
- [Cloudinary media](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/lib/cloudinary.js): `backend/src/lib/cloudinary.js`

### Realtime messaging

- [Socket.IO server](https://github.com/kajamaqbool/encrypted-chat-app/blob/main/backend/src/lib/socket.js): `backend/src/lib/socket.js`

### Other components

- **Chat user**

## Connections

- Chat user → App routing: opens app (evidence: `README.md`)
- App routing → Sign up: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Login: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Chat home: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Profile settings: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Theme settings: routes to (evidence: `frontend/src/App.jsx`)
- Sign up → Auth state: submits signup (evidence: `frontend/src/pages/SignUpPage.jsx`)
- Login → Auth state: submits login (evidence: `frontend/src/pages/LoginPage.jsx`)
- Profile settings → Auth state: updates profile (evidence: `frontend/src/pages/ProfilePage.jsx`)
- Theme settings → Theme state: changes theme (evidence: `frontend/src/pages/SettingsPage.jsx`)
- Chat home → Chat state: loads chat (evidence: `frontend/src/pages/HomePage.jsx`)
- Chat home → User sidebar: renders (evidence: `frontend/src/pages/HomePage.jsx`)
- Chat home → Conversation UI: renders (evidence: `frontend/src/pages/HomePage.jsx`)
- Conversation UI → Message composer: renders (evidence: `frontend/src/components/ChatContainer.jsx`)
- User sidebar → Chat state: selects user (evidence: `frontend/src/components/Sidebar.jsx`)
- Message composer → Chat state: sends message (evidence: `frontend/src/components/MessageInput.jsx`)
- Auth state → HTTP client: requests API (evidence: `frontend/src/store/useAuthStore.js`)
- Chat state → HTTP client: requests API (evidence: `frontend/src/store/useChatStore.js`)
- Auth state → Socket.IO server: connects realtime (evidence: `frontend/src/store/useAuthStore.js`)
- Chat state → Socket.IO server: listens messages (evidence: `frontend/src/store/useChatStore.js`)
- Server entry → MongoDB connection: connects (evidence: `backend/src/index.js`)
- Server entry → Auth routes: mounts routes (evidence: `backend/src/index.js`)
- Server entry → Message routes: mounts routes (evidence: `backend/src/index.js`)
- Server entry → Socket.IO server: uses server (evidence: `backend/src/index.js`)
- Auth routes → Auth handlers: dispatches (evidence: `backend/src/routes/auth.route.js`)
- Auth routes → JWT guard: guards endpoints (evidence: `backend/src/routes/auth.route.js`)
- Message routes → JWT guard: guards endpoints (evidence: `backend/src/routes/message.route.js`)
- Message routes → Message handlers: dispatches (evidence: `backend/src/routes/message.route.js`)
- JWT guard → User records: loads user (evidence: `backend/src/middleware/auth.middleware.js`)
- Auth handlers → User records: reads and writes (evidence: `backend/src/controllers/auth.controller.js`)
- Auth handlers → Cloudinary media: uploads profile image (evidence: `backend/src/controllers/auth.controller.js`)
- Message handlers → User records: queries users (evidence: `backend/src/controllers/message.controller.js`)
- Message handlers → Message records: reads and writes (evidence: `backend/src/controllers/message.controller.js`)
- Message handlers → Cloudinary media: uploads image (evidence: `backend/src/controllers/message.controller.js`)
- Message handlers → Socket.IO server: emits message (evidence: `backend/src/controllers/message.controller.js`)
- Socket.IO server → Auth state: broadcasts presence (evidence: `README.md`)
