# srijan300/chat-application architecture

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

## Overview

QuickChat is a one-to-one messenger: users sign in, select a conversation, exchange and manage messages and media, and view presence and 24-hour statuses. The React client keeps session/chat state and uses HTTP APIs plus Socket.IO; the Express server routes requests to domain controllers, which persist data in MongoDB and upload media to Cloudinary. The map preserves the README’s messaging, account, realtime, media, and status capabilities. Some implementation details are unsampled, so only documented or indexed relationships are shown.

Main entry points: [`server/server.js`](https://github.com/srijan300/chat-application/blob/main/server/server.js) (HTTP and socket server), [`server/controllers/messageController.js`](https://github.com/srijan300/chat-application/blob/main/server/controllers/messageController.js) (Messaging operations), [`client/src/components/ChatContainer.jsx`](https://github.com/srijan300/chat-application/blob/main/client/src/components/ChatContainer.jsx) (Conversation UI), [`server/controllers/statusController.js`](https://github.com/srijan300/chat-application/blob/main/server/controllers/statusController.js) (Status operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routes<br/>[App.jsx]"]
  node_login["Login and profile<br/>[LoginPage.jsx]"]
  node_home["Chat workspace<br/>[HomePage.jsx]"]
  node_auth["Session state<br/>[AuthContext.jsx]"]
  node_chatstate["Chat state<br/>[ChatContext.jsx]"]
  node_thread["Conversation UI<br/>[ChatContainer.jsx]"]
  node_messageview["Message rendering<br/>[MessageBubble.jsx]"]
  node_composer["Voice and camera<br/>[VoiceRecorder.jsx]"]
  node_sidebar["Chat and status list<br/>[Sidebar.jsx]"]
  node_storyui["Status viewer<br/>[StatusTray.jsx]"]
end

subgraph group_api["API and domain"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_userroute["Account routes<br/>[userRoutes.js]"]
  node_userctrl["Account operations<br/>[userController.js]"]
  node_authmw["JWT protection<br/>[auth.js]"]
  node_messageroute["Message routes<br/>[messageRoutes.js]"]
  node_messagectrl["Messaging operations"]
  node_statusroute["Status routes<br/>[statusRoutes.js]"]
  node_statusctrl["Status operations"]
end

subgraph group_realtime["Realtime and presence"]
  node_socketclient["Socket.IO client<br/>[AuthContext.jsx]"]
end

subgraph group_data["Persistence and media"]
  node_dbconn["Mongo connection<br/>[db.js]"]
  node_users[("User records<br/>[User.js]")]
  node_messages[("Message records<br/>[Message.js]")]
  node_statuses[("Status records<br/>[Status.js]")]
  node_cloudinary["Cloudinary uploads<br/>[cloudinary.js]"]
end

node_person(("Messenger"))
node_mediahost[("Cloudinary service")]
node_mongo[("MongoDB")]

node_person -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_home
node_person -.->|"signs in"| node_login
node_home -->|"renders"| node_thread
node_home -->|"renders"| node_sidebar
node_login -->|"uses session"| node_auth
node_thread -->|"uses chat state"| node_chatstate
node_thread -->|"renders"| node_messageview
node_thread -->|"renders"| node_composer
node_sidebar -->|"uses chat state"| node_chatstate
node_sidebar -->|"renders"| node_storyui
node_auth -->|"calls account API"| node_server
node_auth -->|"opens socket"| node_socketclient
node_chatstate -->|"calls chat APIs"| node_server
node_chatstate -.->|"handles events"| node_socketclient
node_socketclient -.->|"connects to"| node_server
node_server -->|"routes requests"| node_userroute
node_server -->|"routes requests"| node_messageroute
node_server -.->|"routes requests"| node_statusroute
node_userroute -->|"protects routes"| node_authmw
node_userroute -->|"dispatches to"| node_userctrl
node_messageroute -->|"protects routes"| node_authmw
node_messageroute -->|"dispatches to"| node_messagectrl
node_statusroute -.->|"protects routes"| node_authmw
node_statusroute -.->|"dispatches to"| node_statusctrl
node_authmw -->|"loads user"| node_users
node_userctrl -->|"reads and writes"| node_users
node_userctrl -->|"uploads avatar"| node_cloudinary
node_messagectrl -->|"reads and writes"| node_messages
node_messagectrl -->|"queries users"| node_users
node_messagectrl -->|"uploads attachments"| node_cloudinary
node_statusctrl -->|"reads and writes"| node_statuses
node_statusctrl -->|"uploads images"| node_cloudinary
node_cloudinary -.->|"stores media"| node_mediahost
node_server -->|"connects database"| node_dbconn
node_dbconn -.->|"opens connection"| node_mongo
node_messagectrl -->|"emits message events"| node_server
node_server -->|"updates last seen"| node_users
node_statusctrl -->|"broadcasts status"| node_server

click node_app "https://github.com/srijan300/chat-application/blob/main/client/src/App.jsx"
click node_login "https://github.com/srijan300/chat-application/blob/main/client/src/pages/LoginPage.jsx"
click node_home "https://github.com/srijan300/chat-application/blob/main/client/src/pages/HomePage.jsx"
click node_auth "https://github.com/srijan300/chat-application/blob/main/client/context/AuthContext.jsx"
click node_chatstate "https://github.com/srijan300/chat-application/blob/main/client/context/ChatContext.jsx"
click node_thread "https://github.com/srijan300/chat-application/blob/main/client/src/components/ChatContainer.jsx"
click node_messageview "https://github.com/srijan300/chat-application/blob/main/client/src/components/MessageBubble.jsx"
click node_composer "https://github.com/srijan300/chat-application/blob/main/client/src/components/VoiceRecorder.jsx"
click node_sidebar "https://github.com/srijan300/chat-application/blob/main/client/src/components/Sidebar.jsx"
click node_storyui "https://github.com/srijan300/chat-application/blob/main/client/src/components/StatusTray.jsx"
click node_server "https://github.com/srijan300/chat-application/blob/main/server/server.js"
click node_userroute "https://github.com/srijan300/chat-application/blob/main/server/routes/userRoutes.js"
click node_userctrl "https://github.com/srijan300/chat-application/blob/main/server/controllers/userController.js"
click node_authmw "https://github.com/srijan300/chat-application/blob/main/server/middleware/auth.js"
click node_messageroute "https://github.com/srijan300/chat-application/blob/main/server/routes/messageRoutes.js"
click node_messagectrl "https://github.com/srijan300/chat-application/blob/main/server/controllers/messageController.js"
click node_statusroute "https://github.com/srijan300/chat-application/blob/main/server/routes/statusRoutes.js"
click node_statusctrl "https://github.com/srijan300/chat-application/blob/main/server/controllers/statusController.js"
click node_dbconn "https://github.com/srijan300/chat-application/blob/main/server/lib/db.js"
click node_users "https://github.com/srijan300/chat-application/blob/main/server/models/User.js"
click node_messages "https://github.com/srijan300/chat-application/blob/main/server/models/Message.js"
click node_statuses "https://github.com/srijan300/chat-application/blob/main/server/models/Status.js"
click node_cloudinary "https://github.com/srijan300/chat-application/blob/main/server/lib/cloudinary.js"
click node_socketclient "https://github.com/srijan300/chat-application/blob/main/client/context/AuthContext.jsx"

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_login,node_home,node_auth,node_chatstate,node_thread,node_messageview,node_composer,node_sidebar,node_storyui toneBlue
class node_server,node_userroute,node_userctrl,node_authmw,node_messageroute,node_messagectrl,node_statusroute,node_statusctrl,node_mediahost,node_mongo toneAmber
class node_socketclient toneMint
class node_dbconn,node_users,node_messages,node_statuses,node_cloudinary toneRose
class node_person toneIndigo
```

## Components

### React client

- [App routes](https://github.com/srijan300/chat-application/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Login and profile](https://github.com/srijan300/chat-application/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [Chat workspace](https://github.com/srijan300/chat-application/blob/main/client/src/pages/HomePage.jsx): `client/src/pages/HomePage.jsx`
- [Session state](https://github.com/srijan300/chat-application/blob/main/client/context/AuthContext.jsx): `client/context/AuthContext.jsx`
- [Chat state](https://github.com/srijan300/chat-application/blob/main/client/context/ChatContext.jsx): `client/context/ChatContext.jsx`
- [Conversation UI](https://github.com/srijan300/chat-application/blob/main/client/src/components/ChatContainer.jsx): `client/src/components/ChatContainer.jsx`
- [Message rendering](https://github.com/srijan300/chat-application/blob/main/client/src/components/MessageBubble.jsx): `client/src/components/MessageBubble.jsx`
- [Voice and camera](https://github.com/srijan300/chat-application/blob/main/client/src/components/VoiceRecorder.jsx): `client/src/components/VoiceRecorder.jsx`
- [Chat and status list](https://github.com/srijan300/chat-application/blob/main/client/src/components/Sidebar.jsx): `client/src/components/Sidebar.jsx`
- [Status viewer](https://github.com/srijan300/chat-application/blob/main/client/src/components/StatusTray.jsx): `client/src/components/StatusTray.jsx`

### API and domain

- [HTTP and socket server](https://github.com/srijan300/chat-application/blob/main/server/server.js): `server/server.js`
- [Account routes](https://github.com/srijan300/chat-application/blob/main/server/routes/userRoutes.js): `server/routes/userRoutes.js`
- [Account operations](https://github.com/srijan300/chat-application/blob/main/server/controllers/userController.js): `server/controllers/userController.js`
- [JWT protection](https://github.com/srijan300/chat-application/blob/main/server/middleware/auth.js): `server/middleware/auth.js`
- [Message routes](https://github.com/srijan300/chat-application/blob/main/server/routes/messageRoutes.js): `server/routes/messageRoutes.js`
- [Messaging operations](https://github.com/srijan300/chat-application/blob/main/server/controllers/messageController.js): `server/controllers/messageController.js`
- [Status routes](https://github.com/srijan300/chat-application/blob/main/server/routes/statusRoutes.js): `server/routes/statusRoutes.js`
- [Status operations](https://github.com/srijan300/chat-application/blob/main/server/controllers/statusController.js): `server/controllers/statusController.js`

### Realtime and presence

- [Socket.IO client](https://github.com/srijan300/chat-application/blob/main/client/context/AuthContext.jsx): `client/context/AuthContext.jsx`

### Persistence and media

- [Mongo connection](https://github.com/srijan300/chat-application/blob/main/server/lib/db.js): `server/lib/db.js`
- [User records](https://github.com/srijan300/chat-application/blob/main/server/models/User.js): `server/models/User.js`
- [Message records](https://github.com/srijan300/chat-application/blob/main/server/models/Message.js): `server/models/Message.js`
- [Status records](https://github.com/srijan300/chat-application/blob/main/server/models/Status.js): `server/models/Status.js`
- [Cloudinary uploads](https://github.com/srijan300/chat-application/blob/main/server/lib/cloudinary.js): `server/lib/cloudinary.js`

### Other components

- **Messenger**
- **Cloudinary service**
- **MongoDB**

## Connections

- Messenger → App routes: uses (evidence: `client/src/App.jsx`)
- App routes → Login and profile: routes to (evidence: `client/src/App.jsx`)
- App routes → Chat workspace: routes to (evidence: `client/src/App.jsx`)
- Messenger → Login and profile: signs in (evidence: `README.md`)
- Chat workspace → Conversation UI: renders (evidence: `client/src/pages/HomePage.jsx`)
- Chat workspace → Chat and status list: renders (evidence: `client/src/pages/HomePage.jsx`)
- Login and profile → Session state: uses session (evidence: `client/src/pages/LoginPage.jsx`)
- Conversation UI → Chat state: uses chat state (evidence: `client/src/components/ChatContainer.jsx`)
- Conversation UI → Message rendering: renders (evidence: `client/src/components/ChatContainer.jsx`)
- Conversation UI → Voice and camera: renders (evidence: `client/src/components/ChatContainer.jsx`)
- Chat and status list → Chat state: uses chat state (evidence: `client/src/components/Sidebar.jsx`)
- Chat and status list → Status viewer: renders (evidence: `client/src/components/Sidebar.jsx`)
- Session state → HTTP and socket server: calls account API (evidence: `client/context/AuthContext.jsx`)
- Session state → Socket.IO client: opens socket (evidence: `client/context/AuthContext.jsx`)
- Chat state → HTTP and socket server: calls chat APIs (evidence: `client/context/ChatContext.jsx`)
- Chat state → Socket.IO client: handles events (evidence: `README.md`)
- Socket.IO client → HTTP and socket server: connects to (evidence: `README.md`)
- HTTP and socket server → Account routes: routes requests (evidence: `server/server.js`)
- HTTP and socket server → Message routes: routes requests (evidence: `server/server.js`)
- HTTP and socket server → Status routes: routes requests (evidence: `README.md`)
- Account routes → JWT protection: protects routes (evidence: `server/routes/userRoutes.js`)
- Account routes → Account operations: dispatches to (evidence: `server/routes/userRoutes.js`)
- Message routes → JWT protection: protects routes (evidence: `server/routes/messageRoutes.js`)
- Message routes → Messaging operations: dispatches to (evidence: `server/routes/messageRoutes.js`)
- Status routes → JWT protection: protects routes (evidence: `server/routes/statusRoutes.js`)
- Status routes → Status operations: dispatches to (evidence: `server/routes/statusRoutes.js`)
- JWT protection → User records: loads user (evidence: `server/middleware/auth.js`)
- Account operations → User records: reads and writes (evidence: `server/controllers/userController.js`)
- Account operations → Cloudinary uploads: uploads avatar (evidence: `server/controllers/userController.js`)
- Messaging operations → Message records: reads and writes (evidence: `server/controllers/messageController.js`)
- Messaging operations → User records: queries users (evidence: `server/controllers/messageController.js`)
- Messaging operations → Cloudinary uploads: uploads attachments (evidence: `server/controllers/messageController.js`)
- Status operations → Status records: reads and writes (evidence: `server/controllers/statusController.js`)
- Status operations → Cloudinary uploads: uploads images (evidence: `server/controllers/statusController.js`)
- Cloudinary uploads → Cloudinary service: stores media (evidence: `README.md`)
- HTTP and socket server → Mongo connection: connects database (evidence: `server/server.js`)
- Mongo connection → MongoDB: opens connection (evidence: `README.md`)
- Messaging operations → HTTP and socket server: emits message events (evidence: `server/controllers/messageController.js`)
- HTTP and socket server → User records: updates last seen (evidence: `server/server.js`)
- Status operations → HTTP and socket server: broadcasts status (evidence: `server/controllers/statusController.js`)
