# piyushyadav0191/full-stack-whatsapp-clone architecture

> Architecture diagram of the GitHub repository piyushyadav0191/full-stack-whatsapp-clone, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/piyushyadav0191/full-stack-whatsapp-clone
- Repository: https://github.com/piyushyadav0191/full-stack-whatsapp-clone

## Overview

This is a WhatsApp-style messaging application with registration/login, one-to-one and group conversations, text and file messages, chat filtering/search, and peer-to-peer video calls. The user flow is to authenticate, select or create a conversation, load its messages, then send messages or attachments; Home also handles Socket.IO presence, incoming messages, typing signals, and WebRTC call signaling. Backend controllers own service calls, while services persist through MongoDB models. The README advertises end-to-end encryption, but no encryption module or implementation is evidenced here. Several UI, routing, and socket-server relationships are documented by the README or source index; unsampled details are not assumed.

Main entry points: [`frontend/src/pages/home.js`](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/pages/home.js) (Home workspace), [`frontend/src/features/chatSlice.js`](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/features/chatSlice.js) (Chat state), [`backend/src/controllers/auth.controller.js`](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/auth.controller.js) (Auth controller), [`backend/src/controllers/conversation.controller.js`](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/conversation.controller.js) (Conversation controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_auth["Identity"]
  node_authroutes["Auth routes<br/>[auth.route.js]"]
  node_authcontroller["Auth controller<br/>[auth.controller.js]"]
  node_authservice["Auth service<br/>[auth.service.js]"]
  node_tokens["Token service<br/>[token.service.js]"]
  node_userservice["User service<br/>[user.service.js]"]
  node_userdb[("User records<br/>[userModel.js]")]
end

subgraph group_conversation["Conversations"]
  node_conversationapi["Conversation controller"]
  node_conversationservice["Conversation service"]
  node_conversationdb[("Conversation records")]
end

subgraph group_messaging["Messaging"]
  node_messageview["Message timeline<br/>[ChatMessages.jsx]"]
  node_filepreview["Attachment preview<br/>[FilesPreview.jsx]"]
  node_uploadsend["Upload and send<br/>[HandleAndSend.jsx]"]
  node_messageapi["Message controller"]
  node_messageservice["Message service<br/>[message.service.js]"]
  node_messagedb[("Message records<br/>[messageModel.js]")]
end

subgraph group_realtime["Realtime calls"]
  node_socket["Socket.IO service<br/>[SocketServer.js]"]
  node_socketcontext["Socket context<br/>[SocketContext.js]"]
  node_callflow["WebRTC call UI<br/>[Call.jsx]"]
  node_peer["Peer connection<br/>[home.js]"]
end

subgraph group_client["Client shell"]
  node_loginui["Login / register<br/>[LoginForm.jsx]"]
  node_home["Home workspace<br/>[home.js]"]
  node_sidebar["Conversation sidebar<br/>[Sidebar.jsx]"]
  node_search["Contact search<br/>[Contact.jsx]"]
  node_chatview["Chat view<br/>[ChatContainer.jsx]"]
  node_chatstate["Chat state<br/>[chatSlice.js]"]
end

node_person(("User"))

node_person -->|"signs in"| node_loginui
node_loginui -.->|"submits credentials"| node_authroutes
node_authroutes -->|"routes to"| node_authcontroller
node_authcontroller -->|"registers or signs in"| node_authservice
node_authcontroller -->|"issues tokens"| node_tokens
node_authcontroller -->|"finds user"| node_userservice
node_authservice -->|"reads and creates"| node_userdb
node_userservice -->|"reads users"| node_userdb
node_person -->|"opens chats"| node_home
node_home -->|"renders"| node_sidebar
node_home -->|"renders"| node_chatview
node_home -->|"receives socket"| node_socketcontext
node_home -->|"loads conversations"| node_chatstate
node_sidebar -.->|"offers contact search"| node_search
node_search -->|"selects conversation"| node_chatstate
node_chatstate -.->|"requests conversations"| node_conversationapi
node_conversationapi -->|"creates and lists"| node_conversationservice
node_conversationapi -->|"looks up recipient"| node_userservice
node_conversationservice -->|"queries and updates"| node_conversationdb
node_chatview -.->|"shows messages"| node_messageview
node_chatview -.->|"opens attachments"| node_filepreview
node_filepreview -->|"hands off files"| node_uploadsend
node_uploadsend -->|"sends message"| node_chatstate
node_chatstate -.->|"requests messages"| node_messageapi
node_messageapi -->|"creates or fetches"| node_messageservice
node_messageapi -->|"updates latest message"| node_conversationservice
node_messageservice -->|"persists messages"| node_messagedb
node_home -.->|"exchanges events"| node_socket
node_socketcontext -.->|"provides connection"| node_socket
node_home -->|"creates peer"| node_peer
node_peer -->|"signals calls"| node_socket
node_home -->|"renders call"| node_callflow

click node_loginui "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/auth/LoginForm.jsx"
click node_authroutes "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/routes/auth.route.js"
click node_authcontroller "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/auth.controller.js"
click node_authservice "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/auth.service.js"
click node_tokens "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/token.service.js"
click node_userservice "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/user.service.js"
click node_userdb "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/models/userModel.js"
click node_home "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/pages/home.js"
click node_sidebar "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/sidebar/Sidebar.jsx"
click node_search "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/sidebar/search/Contact.jsx"
click node_chatview "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/ChatContainer.jsx"
click node_chatstate "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/features/chatSlice.js"
click node_conversationapi "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/conversation.controller.js"
click node_conversationservice "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/conversation.service.js"
click node_conversationdb "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/models/conversationModel.js"
click node_messageview "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/messages/ChatMessages.jsx"
click node_filepreview "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/preview/files/FilesPreview.jsx"
click node_uploadsend "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/preview/files/HandleAndSend.jsx"
click node_messageapi "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/message.controller.js"
click node_messageservice "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/message.service.js"
click node_messagedb "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/models/messageModel.js"
click node_socket "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/SocketServer.js"
click node_socketcontext "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/context/SocketContext.js"
click node_callflow "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/call/Call.jsx"
click node_peer "https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/pages/home.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_authroutes,node_authcontroller,node_authservice,node_tokens,node_userservice,node_userdb,node_person toneBlue
class node_conversationapi,node_conversationservice,node_conversationdb toneAmber
class node_messageview,node_filepreview,node_uploadsend,node_messageapi,node_messageservice,node_messagedb toneMint
class node_socket,node_socketcontext,node_callflow,node_peer toneRose
class node_loginui,node_home,node_sidebar,node_search,node_chatview,node_chatstate toneIndigo
```

## Components

### Identity

- [Auth routes](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/routes/auth.route.js): `backend/src/routes/auth.route.js`
- [Auth controller](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/auth.controller.js): `backend/src/controllers/auth.controller.js`
- [Auth service](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/auth.service.js): `backend/src/services/auth.service.js`
- [Token service](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/token.service.js): `backend/src/services/token.service.js`
- [User service](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/user.service.js): `backend/src/services/user.service.js`
- [User records](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/models/userModel.js): `backend/src/models/userModel.js`

### Conversations

- [Conversation controller](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/conversation.controller.js): `backend/src/controllers/conversation.controller.js`
- [Conversation service](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/conversation.service.js): `backend/src/services/conversation.service.js`
- [Conversation records](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/models/conversationModel.js): `backend/src/models/conversationModel.js`

### Messaging

- [Message timeline](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/messages/ChatMessages.jsx): `frontend/src/components/Chat/messages/ChatMessages.jsx`
- [Attachment preview](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/preview/files/FilesPreview.jsx): `frontend/src/components/Chat/preview/files/FilesPreview.jsx`
- [Upload and send](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/preview/files/HandleAndSend.jsx): `frontend/src/components/Chat/preview/files/HandleAndSend.jsx`
- [Message controller](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/controllers/message.controller.js): `backend/src/controllers/message.controller.js`
- [Message service](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/services/message.service.js): `backend/src/services/message.service.js`
- [Message records](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/models/messageModel.js): `backend/src/models/messageModel.js`

### Realtime calls

- [Socket.IO service](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/backend/src/SocketServer.js): `backend/src/SocketServer.js`
- [Socket context](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/context/SocketContext.js): `frontend/src/context/SocketContext.js`
- [WebRTC call UI](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/call/Call.jsx): `frontend/src/components/Chat/call/Call.jsx`
- [Peer connection](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/pages/home.js): `frontend/src/pages/home.js`

### Client shell

- [Login / register](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/auth/LoginForm.jsx): `frontend/src/components/auth/LoginForm.jsx`
- [Home workspace](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/pages/home.js): `frontend/src/pages/home.js`
- [Conversation sidebar](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/sidebar/Sidebar.jsx): `frontend/src/components/sidebar/Sidebar.jsx`
- [Contact search](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/sidebar/search/Contact.jsx): `frontend/src/components/sidebar/search/Contact.jsx`
- [Chat view](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/components/Chat/ChatContainer.jsx): `frontend/src/components/Chat/ChatContainer.jsx`
- [Chat state](https://github.com/piyushyadav0191/full-stack-whatsapp-clone/blob/master/frontend/src/features/chatSlice.js): `frontend/src/features/chatSlice.js`

### Other components

- **User**

## Connections

- User → Login / register: signs in (evidence: `README.md`)
- Login / register → Auth routes: submits credentials
- Auth routes → Auth controller: routes to (evidence: `backend/src/routes/auth.route.js`)
- Auth controller → Auth service: registers or signs in (evidence: `backend/src/controllers/auth.controller.js`)
- Auth controller → Token service: issues tokens (evidence: `backend/src/controllers/auth.controller.js`)
- Auth controller → User service: finds user (evidence: `backend/src/controllers/auth.controller.js`)
- Auth service → User records: reads and creates (evidence: `backend/src/services/auth.service.js`)
- User service → User records: reads users (evidence: `backend/src/services/user.service.js`)
- User → Home workspace: opens chats (evidence: `README.md`)
- Home workspace → Conversation sidebar: renders (evidence: `frontend/src/pages/home.js`)
- Home workspace → Chat view: renders (evidence: `frontend/src/pages/home.js`)
- Home workspace → Socket context: receives socket (evidence: `frontend/src/pages/home.js`)
- Home workspace → Chat state: loads conversations (evidence: `frontend/src/pages/home.js`)
- Conversation sidebar → Contact search: offers contact search
- Contact search → Chat state: selects conversation (evidence: `frontend/src/components/sidebar/search/Contact.jsx`)
- Chat state → Conversation controller: requests conversations
- Conversation controller → Conversation service: creates and lists (evidence: `backend/src/controllers/conversation.controller.js`)
- Conversation controller → User service: looks up recipient (evidence: `backend/src/controllers/conversation.controller.js`)
- Conversation service → Conversation records: queries and updates (evidence: `backend/src/services/conversation.service.js`)
- Chat view → Message timeline: shows messages
- Chat view → Attachment preview: opens attachments
- Attachment preview → Upload and send: hands off files (evidence: `frontend/src/components/Chat/preview/files/FilesPreview.jsx`)
- Upload and send → Chat state: sends message (evidence: `frontend/src/components/Chat/preview/files/HandleAndSend.jsx`)
- Chat state → Message controller: requests messages
- Message controller → Message service: creates or fetches (evidence: `backend/src/controllers/message.controller.js`)
- Message controller → Conversation service: updates latest message (evidence: `backend/src/controllers/message.controller.js`)
- Message service → Message records: persists messages (evidence: `backend/src/services/message.service.js`)
- Home workspace → Socket.IO service: exchanges events
- Socket context → Socket.IO service: provides connection
- Home workspace → Peer connection: creates peer (evidence: `frontend/src/pages/home.js`)
- Peer connection → Socket.IO service: signals calls (evidence: `frontend/src/pages/home.js`)
- Home workspace → WebRTC call UI: renders call (evidence: `frontend/src/pages/home.js`)
