How francescocartelli/nyla-instant-messaging-app works
Nyla is a browser-based instant messaging application: users authenticate, find people, create direct or group chats, and exchange and manage rich-text messages. The React SPA calls an Express REST API for account, user, chat, and message operations; a separate WebSocket server delivers real-time notifications, coordinated with the API through Redis. MongoDB backs application data. The main workflow and server links are supported by the excerpts and README; several client and service internals were not sampled, so their finer-grained connections are omitted.
Main entry points: app.ts Express routes · App.jsx Routed SPA · Chat.ts Chat controllers · Chat.jsx Chat screens
Components 21
React client
- Routed SPA
client/src/App.jsx - Account screens
client/src/pages/Account/Account.jsx - People search
client/src/pages/Users/Users.jsx - Chat screens
client/src/pages/Chats/Chat.jsx - Rich text editor
client/src/components/SEditor/editor.jsx - Message views
client/src/components/Chats/useMessagesContainer.js - WebSocket context
client/src/components/Ws/WsContext.jsx - API clients
client/src/api/chatAPI.js
REST API
- Express routes
server-api/app.ts - Account controllers
server-api/src/controllers/Account.ts - Chat controllers
server-api/src/controllers/Chat.ts - Message controllers
server-api/src/controllers/Message.ts - User controllers
server-api/src/controllers/User.ts - Chat services
server-api/src/services/Chat.ts - Message services
server-api/src/services/Message.ts - User services
server-api/src/services/User.ts
Realtime delivery
- WebSocket server
server-ws/server.ts - Connection groups
server-ws/utilities/ConnectionManager.ts
Persistence and messaging
- MongoDB
- Redis queue
Other components
- App user
Connections 33
- App user → Routed SPA: uses
- Routed SPA → Account screens: routes to
client/src/App.jsx - Routed SPA → People search: routes to
client/src/App.jsx - Routed SPA → Chat screens: routes to
client/src/App.jsx - Chat screens → Message views: displays
- Chat screens → Rich text editor: composes messages
- Routed SPA → WebSocket context: provides
client/src/App.jsx - Account screens → API clients: requests account data
- People search → API clients: searches users
- Chat screens → API clients: requests chat data
- API clients → Express routes: HTTP requests
- Express routes → Account controllers: routes authentication
server-api/app.ts - Express routes → Chat controllers: routes chat operations
server-api/app.ts - Express routes → Message controllers: routes message operations
server-api/app.ts - Express routes → User controllers: routes user operations
server-api/app.ts - Chat controllers → Chat services: calls
server-api/src/controllers/Chat.ts - Chat controllers → Message services: deletes messages
server-api/src/controllers/Chat.ts - Chat controllers → User services: looks up users
server-api/src/controllers/Chat.ts - Message controllers → Message services: calls
server-api/src/controllers/Message.ts - Message controllers → Chat services: checks chats
server-api/src/controllers/Message.ts - Message controllers → Redis queue: publishes events
- Chat controllers → Redis queue: notifies chat changes
server-api/src/controllers/Chat.ts - Account controllers → User services: uses accounts
server-api/src/controllers/Account.ts - User controllers → User services: calls
server-api/src/controllers/User.ts - User services → MongoDB: reads and writes
server-api/src/services/User.ts - Chat services → MongoDB: stores chat data
- Message services → MongoDB: stores messages
- WebSocket context → WebSocket server: WebSocket connection
- WebSocket server → Connection groups: groups connections
server-ws/server.ts - WebSocket server → Redis queue: subscribes and forwards
server-ws/server.ts - WebSocket server → Express routes: fetches current user
server-ws/server.ts - Express routes → MongoDB: persists application data
- Express routes → Redis queue: coordinates notifications