# ankushvarma-ui/chatnest architecture

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

## Overview

ChatNest is a real-time room chat app. Users browse or create a room, submit a username and optional password, receive a JWT, then connect to the room to exchange messages and live presence/typing updates. Chat history is paginated from MongoDB; messages are persisted only after authenticated socket validation, profanity filtering, and per-user rate checks. The graph follows shown REST, socket, and frontend calls. Other documented protections and room lifecycle behavior are represented, but unsampled server details are not inferred.

Main entry points: [`mern-chat-room/frontend/src/pages/ChatPage.jsx`](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/pages/ChatPage.jsx) (Chat page), [`mern-chat-room/backend/socket/socketHandler.js`](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/socket/socketHandler.js) (Socket event handlers), [`mern-chat-room/backend/server.js`](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/server.js) (HTTP and socket server), [`mern-chat-room/frontend/src/App.jsx`](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/App.jsx) (App routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["App routing<br/>[App.jsx]"]
  node_join["Join and browse<br/>[JoinPage.jsx]"]
  node_chat["Chat page<br/>[ChatPage.jsx]"]
  node_apihelper["REST client<br/>[api.js]"]
  node_socketclient["Socket client<br/>[socket.js]"]
  node_bubble["Message display<br/>[MessageBubble.jsx]"]
  node_users["User list<br/>[UserList.jsx]"]
  node_boundary["Error boundary<br/>[ErrorBoundary.jsx]"]
end

subgraph group_api["Room and access API"]
  node_server["HTTP and socket server<br/>[server.js]"]
  node_roomsapi["Room routes<br/>[roomRoutes.js]"]
  node_historyapi["History route<br/>[messageRoutes.js]"]
  node_validation["Input validation<br/>[validation.js]"]
  node_auth["JWT authentication<br/>[auth.js]"]
end

subgraph group_realtime["Realtime chat"]
  node_roomstore[("Room state and limits<br/>[roomStore.js]")]
  node_socketserver["Socket event handlers<br/>[socketHandler.js]"]
  node_profanity["Profanity filter<br/>[profanity.js]"]
end

subgraph group_persistence["Message persistence"]
  node_message["Message model<br/>[Message.js]"]
  node_mongo[("MongoDB")]
end

node_visitor(("Room participant"))

node_visitor -->|"uses"| node_app
node_app -->|"wraps"| node_boundary
node_app -->|"routes"| node_join
node_app -->|"routes"| node_chat
node_join -->|"requests"| node_apihelper
node_chat -->|"loads history"| node_apihelper
node_chat -->|"emits and listens"| node_socketclient
node_chat -->|"renders"| node_bubble
node_chat -->|"renders"| node_users
node_apihelper -.->|"HTTP requests"| node_server
node_socketclient -.->|"socket connection"| node_server
node_server -->|"mounts routes"| node_roomsapi
node_server -->|"mounts routes"| node_historyapi
node_server -->|"registers handlers"| node_socketserver
node_roomsapi -->|"validates input"| node_validation
node_roomsapi -->|"prepares and lists"| node_roomstore
node_roomsapi -->|"issues token"| node_auth
node_historyapi -->|"requires token"| node_auth
node_historyapi -->|"validates room"| node_validation
node_historyapi -->|"queries history"| node_message
node_socketserver -->|"verifies token"| node_auth
node_socketserver -->|"tracks users and limits"| node_roomstore
node_socketserver -->|"checks text"| node_profanity
node_socketserver -->|"creates messages"| node_message
node_message -.->|"persists records"| node_mongo

click node_app "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/App.jsx"
click node_join "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/pages/JoinPage.jsx"
click node_chat "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/pages/ChatPage.jsx"
click node_apihelper "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/api.js"
click node_socketclient "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/socket.js"
click node_bubble "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/components/MessageBubble.jsx"
click node_users "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/components/UserList.jsx"
click node_boundary "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/components/ErrorBoundary.jsx"
click node_server "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/server.js"
click node_roomsapi "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/routes/roomRoutes.js"
click node_historyapi "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/routes/messageRoutes.js"
click node_validation "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/utils/validation.js"
click node_auth "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/middleware/auth.js"
click node_roomstore "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/utils/roomStore.js"
click node_socketserver "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/socket/socketHandler.js"
click node_profanity "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/utils/profanity.js"
click node_message "https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/models/Message.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_join,node_chat,node_apihelper,node_socketclient,node_bubble,node_users,node_boundary toneBlue
class node_server,node_roomsapi,node_historyapi,node_validation,node_auth toneAmber
class node_roomstore,node_socketserver,node_profanity toneMint
class node_message,node_mongo toneRose
class node_visitor toneIndigo
```

## Components

### React client

- [App routing](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/App.jsx): `mern-chat-room/frontend/src/App.jsx`
- [Join and browse](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/pages/JoinPage.jsx): `mern-chat-room/frontend/src/pages/JoinPage.jsx`
- [Chat page](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/pages/ChatPage.jsx): `mern-chat-room/frontend/src/pages/ChatPage.jsx`
- [REST client](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/api.js): `mern-chat-room/frontend/src/api.js`
- [Socket client](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/socket.js): `mern-chat-room/frontend/src/socket.js`
- [Message display](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/components/MessageBubble.jsx): `mern-chat-room/frontend/src/components/MessageBubble.jsx`
- [User list](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/components/UserList.jsx): `mern-chat-room/frontend/src/components/UserList.jsx`
- [Error boundary](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/frontend/src/components/ErrorBoundary.jsx): `mern-chat-room/frontend/src/components/ErrorBoundary.jsx`

### Room and access API

- [HTTP and socket server](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/server.js): `mern-chat-room/backend/server.js`
- [Room routes](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/routes/roomRoutes.js): `mern-chat-room/backend/routes/roomRoutes.js`
- [History route](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/routes/messageRoutes.js): `mern-chat-room/backend/routes/messageRoutes.js`
- [Input validation](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/utils/validation.js): `mern-chat-room/backend/utils/validation.js`
- [JWT authentication](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/middleware/auth.js): `mern-chat-room/backend/middleware/auth.js`

### Realtime chat

- [Room state and limits](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/utils/roomStore.js): `mern-chat-room/backend/utils/roomStore.js`
- [Socket event handlers](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/socket/socketHandler.js): `mern-chat-room/backend/socket/socketHandler.js`
- [Profanity filter](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/utils/profanity.js): `mern-chat-room/backend/utils/profanity.js`

### Message persistence

- [Message model](https://github.com/ankushvarma-ui/chatnest/blob/main/mern-chat-room/backend/models/Message.js): `mern-chat-room/backend/models/Message.js`
- **MongoDB**

### Other components

- **Room participant**

## Connections

- Room participant → App routing: uses (evidence: `mern-chat-room/frontend/src/App.jsx`)
- App routing → Error boundary: wraps (evidence: `mern-chat-room/frontend/src/App.jsx`)
- App routing → Join and browse: routes (evidence: `mern-chat-room/frontend/src/App.jsx`)
- App routing → Chat page: routes (evidence: `mern-chat-room/frontend/src/App.jsx`)
- Join and browse → REST client: requests (evidence: `mern-chat-room/frontend/src/pages/JoinPage.jsx`)
- Chat page → REST client: loads history (evidence: `mern-chat-room/frontend/src/pages/ChatPage.jsx`)
- Chat page → Socket client: emits and listens (evidence: `mern-chat-room/frontend/src/pages/ChatPage.jsx`)
- Chat page → Message display: renders (evidence: `mern-chat-room/frontend/src/pages/ChatPage.jsx`)
- Chat page → User list: renders (evidence: `mern-chat-room/frontend/src/pages/ChatPage.jsx`)
- REST client → HTTP and socket server: HTTP requests
- Socket client → HTTP and socket server: socket connection
- HTTP and socket server → Room routes: mounts routes (evidence: `mern-chat-room/backend/server.js`)
- HTTP and socket server → History route: mounts routes (evidence: `mern-chat-room/backend/server.js`)
- HTTP and socket server → Socket event handlers: registers handlers (evidence: `mern-chat-room/backend/server.js`)
- Room routes → Input validation: validates input (evidence: `mern-chat-room/backend/routes/roomRoutes.js`)
- Room routes → Room state and limits: prepares and lists (evidence: `mern-chat-room/backend/routes/roomRoutes.js`)
- Room routes → JWT authentication: issues token (evidence: `mern-chat-room/backend/routes/roomRoutes.js`)
- History route → JWT authentication: requires token (evidence: `mern-chat-room/backend/routes/messageRoutes.js`)
- History route → Input validation: validates room (evidence: `mern-chat-room/backend/routes/messageRoutes.js`)
- History route → Message model: queries history (evidence: `mern-chat-room/backend/routes/messageRoutes.js`)
- Socket event handlers → JWT authentication: verifies token (evidence: `mern-chat-room/backend/socket/socketHandler.js`)
- Socket event handlers → Room state and limits: tracks users and limits (evidence: `mern-chat-room/backend/socket/socketHandler.js`)
- Socket event handlers → Profanity filter: checks text (evidence: `mern-chat-room/backend/socket/socketHandler.js`)
- Socket event handlers → Message model: creates messages (evidence: `mern-chat-room/backend/socket/socketHandler.js`)
- Message model → MongoDB: persists records
