# subashan-080/mern-chat-app architecture

> Architecture diagram of the GitHub repository subashan-080/mern-chat-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/subashan-080/mern-chat-app
- Repository: https://github.com/subashan-080/mern-chat-app

## Overview

This is a MERN chat application: a React client supports registration, login, conversation selection and messaging, while an Express/Mongoose backend provides authenticated HTTP APIs and Socket.IO real-time events. The main workflow is user authentication, conversation discovery or creation, then message exchange with presence, typing and read receipts. The graph separates client UI, HTTP API handling, persistence, and real-time services. Source excerpts support the principal routes and socket behavior; some client-to-server wiring and unsampled controller details are therefore not asserted.

Main entry points: [`chat-backend/mern-chat-backend/chat-backend/server.js`](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/server.js) (HTTP and socket server), [`chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js) (Socket event handler), [`chat_frontend/src/App.jsx`](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/App.jsx) (App routing), [`chat_frontend/src/Component/Home.jsx`](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Home.jsx) (Chat home)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Login and register<br/>[Login.jsx]"]
  node_home["Chat home<br/>[Home.jsx]"]
  node_friends["Friends list<br/>[Friends.jsx]"]
  node_messages["Message view<br/>[Message.jsx]"]
  node_context["Session context<br/>[Context.jsx]"]
  node_api["API endpoint config<br/>[api.js]"]
end

subgraph group_http["HTTP API"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_convroutes["Conversation routes"]
  node_messageroutes["Message routes<br/>[messageRoutes.js]"]
  node_userroutes["User routes<br/>[userRoutes.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_conversations["Conversation management"]
  node_messagesapi["Message API"]
  node_usersapi["User API<br/>[userController.js]"]
  node_authmw["Request authentication<br/>[authMiddleware.js]"]
end

subgraph group_data["Mongo persistence"]
  node_mongo[("MongoDB<br/>[db.js]")]
  node_userdoc[("User records<br/>[User.js]")]
  node_convdoc[("Conversation records<br/>[Conversation.js]")]
  node_msgdoc[("Message records<br/>[Message.js]")]
end

subgraph group_realtime["Realtime chat"]
  node_socket["Socket event handler<br/>[socketHandler.js]"]
  node_socketauth["Socket authentication<br/>[socketAuth.js]"]
  node_online["Online user registry<br/>[onlineUsers.js]"]
end

node_user(("Chat user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_home
node_app -->|"provides"| node_context
node_home -->|"renders"| node_friends
node_home -->|"renders"| node_messages
node_authui -->|"uses"| node_api
node_friends -->|"uses"| node_api
node_messages -->|"uses"| node_api
node_server -->|"connects"| node_mongo
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_convroutes
node_server -->|"mounts"| node_messageroutes
node_server -->|"mounts"| node_userroutes
node_server -->|"initializes"| node_socket
node_authroutes -->|"protects"| node_authmw
node_convroutes -->|"protects"| node_authmw
node_authroutes -->|"dispatches"| node_auth
node_convroutes -->|"dispatches"| node_conversations
node_messageroutes -->|"dispatches"| node_messagesapi
node_userroutes -->|"dispatches"| node_usersapi
node_auth -->|"reads and writes"| node_userdoc
node_conversations -->|"reads and writes"| node_convdoc
node_conversations -->|"looks up members"| node_userdoc
node_socket -->|"registers"| node_socketauth
node_socket -->|"tracks sockets"| node_online
node_socket -->|"updates presence"| node_userdoc
node_socket -->|"checks membership"| node_convdoc
node_socket -->|"persists messages"| node_msgdoc

click node_app "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/App.jsx"
click node_authui "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Login.jsx"
click node_home "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Home.jsx"
click node_friends "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Friends.jsx"
click node_messages "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Message.jsx"
click node_context "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Context.jsx"
click node_api "https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/api.js"
click node_server "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/server.js"
click node_authroutes "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/authRoutes.js"
click node_convroutes "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/conversationRoutes.js"
click node_messageroutes "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/messageRoutes.js"
click node_userroutes "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/userRoutes.js"
click node_auth "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/authController.js"
click node_conversations "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/conversationController.js"
click node_messagesapi "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/messageController.js"
click node_usersapi "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/userController.js"
click node_authmw "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/middleware/authMiddleware.js"
click node_mongo "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/config/db.js"
click node_userdoc "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/models/User.js"
click node_convdoc "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/models/Conversation.js"
click node_msgdoc "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/models/Message.js"
click node_socket "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js"
click node_socketauth "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/socketAuth.js"
click node_online "https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/onlineUsers.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_authui,node_home,node_friends,node_messages,node_context,node_api,node_user toneBlue
class node_server,node_authroutes,node_convroutes,node_messageroutes,node_userroutes,node_auth,node_conversations,node_messagesapi,node_usersapi,node_authmw toneAmber
class node_mongo,node_userdoc,node_convdoc,node_msgdoc toneMint
class node_socket,node_socketauth,node_online toneRose
```

## Components

### React client

- [App routing](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/App.jsx): `chat_frontend/src/App.jsx`
- [Login and register](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Login.jsx): `chat_frontend/src/Component/Login.jsx`
- [Chat home](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Home.jsx): `chat_frontend/src/Component/Home.jsx`
- [Friends list](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Friends.jsx): `chat_frontend/src/Component/Friends.jsx`
- [Message view](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Message.jsx): `chat_frontend/src/Component/Message.jsx`
- [Session context](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/Component/Context.jsx): `chat_frontend/src/Component/Context.jsx`
- [API endpoint config](https://github.com/subashan-080/mern-chat-app/blob/main/chat_frontend/src/api.js): `chat_frontend/src/api.js`

### HTTP API

- [HTTP and socket server](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/server.js): `chat-backend/mern-chat-backend/chat-backend/server.js`
- [Auth routes](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/authRoutes.js): `chat-backend/mern-chat-backend/chat-backend/routes/authRoutes.js`
- [Conversation routes](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/conversationRoutes.js): `chat-backend/mern-chat-backend/chat-backend/routes/conversationRoutes.js`
- [Message routes](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/messageRoutes.js): `chat-backend/mern-chat-backend/chat-backend/routes/messageRoutes.js`
- [User routes](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/routes/userRoutes.js): `chat-backend/mern-chat-backend/chat-backend/routes/userRoutes.js`
- [Authentication](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/authController.js): `chat-backend/mern-chat-backend/chat-backend/controllers/authController.js`
- [Conversation management](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/conversationController.js): `chat-backend/mern-chat-backend/chat-backend/controllers/conversationController.js`
- [Message API](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/messageController.js): `chat-backend/mern-chat-backend/chat-backend/controllers/messageController.js`
- [User API](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/controllers/userController.js): `chat-backend/mern-chat-backend/chat-backend/controllers/userController.js`
- [Request authentication](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/middleware/authMiddleware.js): `chat-backend/mern-chat-backend/chat-backend/middleware/authMiddleware.js`

### Mongo persistence

- [MongoDB](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/config/db.js): `chat-backend/mern-chat-backend/chat-backend/config/db.js`
- [User records](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/models/User.js): `chat-backend/mern-chat-backend/chat-backend/models/User.js`
- [Conversation records](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/models/Conversation.js): `chat-backend/mern-chat-backend/chat-backend/models/Conversation.js`
- [Message records](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/models/Message.js): `chat-backend/mern-chat-backend/chat-backend/models/Message.js`

### Realtime chat

- [Socket event handler](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js): `chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`
- [Socket authentication](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/socketAuth.js): `chat-backend/mern-chat-backend/chat-backend/socket/socketAuth.js`
- [Online user registry](https://github.com/subashan-080/mern-chat-app/blob/main/chat-backend/mern-chat-backend/chat-backend/socket/onlineUsers.js): `chat-backend/mern-chat-backend/chat-backend/socket/onlineUsers.js`

### Other components

- **Chat user**

## Connections

- Chat user → App routing: uses (evidence: `chat_frontend/src/App.jsx`)
- App routing → Login and register: routes to (evidence: `chat_frontend/src/App.jsx`)
- App routing → Chat home: routes to (evidence: `chat_frontend/src/App.jsx`)
- App routing → Session context: provides (evidence: `chat_frontend/src/App.jsx`)
- Chat home → Friends list: renders (evidence: `chat_frontend/src/Component/Home.jsx`)
- Chat home → Message view: renders (evidence: `chat_frontend/src/Component/Home.jsx`)
- Login and register → API endpoint config: uses (evidence: `chat_frontend/src/Component/Login.jsx`)
- Friends list → API endpoint config: uses (evidence: `chat_frontend/src/Component/Friends.jsx`)
- Message view → API endpoint config: uses (evidence: `chat_frontend/src/Component/Message.jsx`)
- HTTP and socket server → MongoDB: connects (evidence: `chat-backend/mern-chat-backend/chat-backend/server.js`)
- HTTP and socket server → Auth routes: mounts (evidence: `chat-backend/mern-chat-backend/chat-backend/server.js`)
- HTTP and socket server → Conversation routes: mounts (evidence: `chat-backend/mern-chat-backend/chat-backend/server.js`)
- HTTP and socket server → Message routes: mounts (evidence: `chat-backend/mern-chat-backend/chat-backend/server.js`)
- HTTP and socket server → User routes: mounts (evidence: `chat-backend/mern-chat-backend/chat-backend/server.js`)
- HTTP and socket server → Socket event handler: initializes (evidence: `chat-backend/mern-chat-backend/chat-backend/server.js`)
- Auth routes → Request authentication: protects (evidence: `chat-backend/mern-chat-backend/chat-backend/routes/authRoutes.js`)
- Conversation routes → Request authentication: protects (evidence: `chat-backend/mern-chat-backend/chat-backend/routes/conversationRoutes.js`)
- Auth routes → Authentication: dispatches (evidence: `chat-backend/mern-chat-backend/chat-backend/routes/authRoutes.js`)
- Conversation routes → Conversation management: dispatches (evidence: `chat-backend/mern-chat-backend/chat-backend/routes/conversationRoutes.js`)
- Message routes → Message API: dispatches (evidence: `chat-backend/mern-chat-backend/chat-backend/routes/messageRoutes.js`)
- User routes → User API: dispatches (evidence: `chat-backend/mern-chat-backend/chat-backend/routes/userRoutes.js`)
- Authentication → User records: reads and writes (evidence: `chat-backend/mern-chat-backend/chat-backend/controllers/authController.js`)
- Conversation management → Conversation records: reads and writes (evidence: `chat-backend/mern-chat-backend/chat-backend/controllers/conversationController.js`)
- Conversation management → User records: looks up members (evidence: `chat-backend/mern-chat-backend/chat-backend/controllers/conversationController.js`)
- Socket event handler → Socket authentication: registers (evidence: `chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`)
- Socket event handler → Online user registry: tracks sockets (evidence: `chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`)
- Socket event handler → User records: updates presence (evidence: `chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`)
- Socket event handler → Conversation records: checks membership (evidence: `chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`)
- Socket event handler → Message records: persists messages (evidence: `chat-backend/mern-chat-backend/chat-backend/socket/socketHandler.js`)
