How piyushyadav0191/full-stack-whatsapp-clone works
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: home.js Home workspace · chatSlice.js Chat state · auth.controller.js Auth controller · conversation.controller.js Conversation controller
Components 26
Identity
- Auth routes
backend/src/routes/auth.route.js - Auth controller
backend/src/controllers/auth.controller.js - Auth service
backend/src/services/auth.service.js - Token service
backend/src/services/token.service.js - User service
backend/src/services/user.service.js - User records
backend/src/models/userModel.js
Conversations
- Conversation controller
backend/src/controllers/conversation.controller.js - Conversation service
backend/src/services/conversation.service.js - Conversation records
backend/src/models/conversationModel.js
Messaging
- Message timeline
frontend/src/components/Chat/messages/ChatMessages.jsx - Attachment preview
frontend/src/components/Chat/preview/files/FilesPreview.jsx - Upload and send
frontend/src/components/Chat/preview/files/HandleAndSend.jsx - Message controller
backend/src/controllers/message.controller.js - Message service
backend/src/services/message.service.js - Message records
backend/src/models/messageModel.js
Realtime calls
- Socket.IO service
backend/src/SocketServer.js - Socket context
frontend/src/context/SocketContext.js - WebRTC call UI
frontend/src/components/Chat/call/Call.jsx - Peer connection
frontend/src/pages/home.js
Client shell
- Login / register
frontend/src/components/auth/LoginForm.jsx - Home workspace
frontend/src/pages/home.js - Conversation sidebar
frontend/src/components/sidebar/Sidebar.jsx - Contact search
frontend/src/components/sidebar/search/Contact.jsx - Chat view
frontend/src/components/Chat/ChatContainer.jsx - Chat state
frontend/src/features/chatSlice.js
Other components
- User
Connections 32
- User → Login / register: signs in
README.md - Login / register → Auth routes: submits credentials
- Auth routes → Auth controller: routes to
backend/src/routes/auth.route.js - Auth controller → Auth service: registers or signs in
backend/src/controllers/auth.controller.js - Auth controller → Token service: issues tokens
backend/src/controllers/auth.controller.js - Auth controller → User service: finds user
backend/src/controllers/auth.controller.js - Auth service → User records: reads and creates
backend/src/services/auth.service.js - User service → User records: reads users
backend/src/services/user.service.js - User → Home workspace: opens chats
README.md - Home workspace → Conversation sidebar: renders
frontend/src/pages/home.js - Home workspace → Chat view: renders
frontend/src/pages/home.js - Home workspace → Socket context: receives socket
frontend/src/pages/home.js - Home workspace → Chat state: loads conversations
frontend/src/pages/home.js - Conversation sidebar → Contact search: offers contact search
- Contact search → Chat state: selects conversation
frontend/src/components/sidebar/search/Contact.jsx - Chat state → Conversation controller: requests conversations
- Conversation controller → Conversation service: creates and lists
backend/src/controllers/conversation.controller.js - Conversation controller → User service: looks up recipient
backend/src/controllers/conversation.controller.js - Conversation service → Conversation records: queries and updates
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
frontend/src/components/Chat/preview/files/FilesPreview.jsx - Upload and send → Chat state: sends message
frontend/src/components/Chat/preview/files/HandleAndSend.jsx - Chat state → Message controller: requests messages
- Message controller → Message service: creates or fetches
backend/src/controllers/message.controller.js - Message controller → Conversation service: updates latest message
backend/src/controllers/message.controller.js - Message service → Message records: persists messages
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
frontend/src/pages/home.js - Peer connection → Socket.IO service: signals calls
frontend/src/pages/home.js - Home workspace → WebRTC call UI: renders call
frontend/src/pages/home.js