How barmanji/threadly works
Threadly is a retro-themed real-time chat product. Its main workflow is a user signing in, opening or creating a conversation, exchanging messages and attachments in real time, and optionally starting a peer-to-peer or group call. The map also preserves account verification and recovery, call history, collaborative whiteboarding, and the public changelog. Backend socket internals and several feature implementations were not excerpted; dashed, uncited links mark relationships documented as capabilities but not verified in source.
Main entry points: message.controller.ts Message handlers · socket.ts Socket services · chat.model.ts Chat records · message.model.ts Message records
Components 29
Web client
- App routes
apps/react-Fe/src/App.tsx - Chat workspace
apps/react-Fe/src/pages/chat.tsx - Theme preferences
apps/react-Fe/src/context/ThemeContext.tsx - Release notes
apps/react-Fe/src/pages/changelog.tsx
Accounts
- Auth state
apps/react-Fe/src/context/AuthContext.tsx - Auth API
apps/react-Fe/src/api/index.ts - Account handlers
apps/http-server-Be/src/controllers/user.controller.ts - Account routes
apps/http-server-Be/src/routes/user.routes.ts - Email verification
apps/http-server-Be/src/services/emailVerification.service.ts
Chat and media
- Chat API handlers
apps/http-server-Be/src/controllers/chat.controller.ts - Chat routes
apps/http-server-Be/src/routes/chat.routes.ts - Message handlers
apps/http-server-Be/src/controllers/message.controller.ts - Message routes
apps/http-server-Be/src/routes/message.routes.ts - Cloud file storage
apps/http-server-Be/src/utils/fileUploaderCloudinary.ts - Call history
apps/http-server-Be/src/services/callLog.service.ts
Live collaboration
- Socket connection
apps/react-Fe/src/context/SocketContext.tsx - Socket services
apps/http-server-Be/src/socket/socket.ts - 1:1 calling
apps/react-Fe/src/components/call/CallModal.tsx - Group calling
apps/react-Fe/src/context/GroupCallContext.tsx - Mediasoup SFU
apps/http-server-Be/src/socket/mediasoup.ts - Collaborative board
apps/react-Fe/src/components/WhiteBoard.tsx
Backend and state
- User records
apps/http-server-Be/src/models/user/user.model.ts - Chat records
apps/http-server-Be/src/models/chat/chat.model.ts - Message records
apps/http-server-Be/src/models/chat/message.model.ts - HTTP and socket app
apps/http-server-Be/src/app.ts
Other components
- User
- MongoDB
- Cloudinary
- Resend email
Connections 40
- User → App routes: opens
apps/react-Fe/src/App.tsx - App routes → Auth state: checks session
apps/react-Fe/src/App.tsx - App routes → Chat workspace: routes to
apps/react-Fe/src/App.tsx - User → Auth state: signs in
README.md - Auth state → Auth API: requests auth
apps/react-Fe/src/context/AuthContext.tsx - Auth API → Account routes: calls endpoints
- Account routes → Account handlers: dispatches
apps/http-server-Be/src/routes/user.routes.ts - Account handlers → Email verification: issues codes
apps/http-server-Be/src/controllers/user.controller.ts - Email verification → User records: updates account
apps/http-server-Be/src/services/emailVerification.service.ts - Email verification → Resend email: emails code
apps/http-server-Be/src/services/emailVerification.service.ts - Account handlers → User records: reads and writes
apps/http-server-Be/src/controllers/user.controller.ts - Chat workspace → Chat API handlers: uses chat
- Chat routes → Chat API handlers: dispatches
apps/http-server-Be/src/routes/chat.routes.ts - Chat workspace → Message handlers: sends messages
- Message routes → Message handlers: dispatches
apps/http-server-Be/src/routes/message.routes.ts - Chat API handlers → Chat records: reads and writes
apps/http-server-Be/src/controllers/chat.controller.ts - Chat API handlers → Message records: manages messages
apps/http-server-Be/src/controllers/chat.controller.ts - Message handlers → Chat records: updates chat
apps/http-server-Be/src/controllers/message.controller.ts - Message handlers → Message records: stores messages
apps/http-server-Be/src/controllers/message.controller.ts - Message handlers → Cloud file storage: uploads attachments
apps/http-server-Be/src/controllers/message.controller.ts - Cloud file storage → Cloudinary: stores files
- Chat workspace → Socket connection: opens live channel
- Socket connection → Socket services: connects
apps/react-Fe/src/context/SocketContext.tsx - HTTP and socket app → Socket services: hosts sockets
apps/http-server-Be/src/app.ts - Socket services → Message records: persists messages
README.md - Socket services → Chat records: updates last message
README.md - 1:1 calling → Socket connection: signals peers
apps/react-Fe/src/components/call/CallModal.tsx - User → 1:1 calling: starts call
README.md - User → Group calling: joins group call
README.md - Group calling → Socket connection: coordinates call
apps/react-Fe/src/context/GroupCallContext.tsx - Group calling → Mediasoup SFU: uses SFU
README.md - User → Collaborative board: collaborates
README.md - Collaborative board → Socket services: syncs scene
README.md - Call history → Chat records: updates conversation
apps/http-server-Be/src/services/callLog.service.ts - Call history → Message records: records call message
apps/http-server-Be/src/services/callLog.service.ts - User → Theme preferences: changes appearance
README.md - User → Release notes: reads releases
- Chat records → MongoDB: persists
- Message records → MongoDB: persists
- User records → MongoDB: persists