# suhas1010/rocket.chat architecture

> Architecture diagram of the GitHub repository suhas1010/rocket.chat, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/suhas1010/rocket.chat
- Repository: https://github.com/suhas1010/rocket.chat

## Overview

Rocket.Chat is a secure, extensible team communications platform. Its principal user workflow is joining a workspace and communicating with colleagues or external customers through messaging and real-time calls; administration, access controls, federation, and integrations support that workflow. The README documents these capabilities, while the sampled source is selective and does not expose the complete runtime routing between client and server, so several product-level relationships are documented rather than traced to callers.

Main entry points: [`apps/meteor/client`](https://github.com/suhas1010/rocket.chat/tree/develop/apps/meteor/client) (Web client), [`apps/meteor/client/components/message`](https://github.com/suhas1010/rocket.chat/tree/develop/apps/meteor/client/components/message) (Messaging), [`packages/apps/src/AppsEngine.ts`](https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/AppsEngine.ts) (Apps Engine), [`packages/ui-contexts/src/AuthenticationContext.ts`](https://github.com/suhas1010/rocket.chat/blob/develop/packages/ui-contexts/src/AuthenticationContext.ts) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collab["Communication"]
  node_meteor["Web client"]
  node_messages["Messaging"]
  node_livechat["Customer live chat"]
  node_calls["Voice and video"]
  node_federation["Federation<br/>[S2SManager.ts]"]
  node_presence["Presence<br/>[presenceEngine.ts]"]
end

subgraph group_security["Security and identity"]
  node_abac["Attribute access"]
  node_auth["Authentication"]
  node_session["Session sharing"]
end

subgraph group_extensions["Extensions and services"]
  node_appsengine["Apps Engine<br/>[AppsEngine.ts]"]
  node_appmanager["App manager<br/>[AppManager.ts]"]
  node_appui["App UI host"]
  node_search["AI search<br/>[clientSearch.ts]"]
end

subgraph group_runtime["Platform runtime"]
  node_ddp["Realtime transport<br/>[ClientStream.ts]"]
  node_server["Workspace server<br/>[Server.ts]"]
  node_storage[("Workspace data<br/>[Apps.ts]")]
  node_random["Random generation<br/>[main.client.ts]"]
  node_featurepreview["Feature previews"]
end

node_user(("Workspace user"))
node_external(("External systems"))

node_user -->|"uses"| node_meteor
node_meteor -.->|"communicates through"| node_messages
node_meteor -.->|"starts calls"| node_calls
node_meteor -.->|"contacts support"| node_livechat
node_messages -.->|"shows status"| node_presence
node_messages -->|"communicates across networks"| node_federation
node_meteor -->|"enforces access controls"| node_abac
node_user -.->|"authenticates"| node_auth
node_auth -->|"shares session"| node_session
node_meteor -.->|"exchanges realtime data"| node_ddp
node_ddp -.->|"transports requests"| node_server
node_server -.->|"persists workspace data"| node_storage
node_meteor -->|"uses extensions"| node_appsengine
node_appsengine -->|"manages apps"| node_appmanager
node_meteor -.->|"hosts app UI"| node_appui
node_appsengine -->|"integrates with systems"| node_external
node_meteor -.->|"searches conversations"| node_search
node_meteor -.->|"configures previews"| node_featurepreview

click node_meteor "https://github.com/suhas1010/rocket.chat/tree/develop/apps/meteor/client"
click node_messages "https://github.com/suhas1010/rocket.chat/tree/develop/apps/meteor/client/components/message"
click node_livechat "https://github.com/suhas1010/rocket.chat/tree/develop/packages/livechat"
click node_calls "https://github.com/suhas1010/rocket.chat/tree/develop/packages/ui-video-conf"
click node_federation "https://github.com/suhas1010/rocket.chat/blob/develop/ee/packages/xmpp-server/src/s2s/S2SManager.ts"
click node_abac "https://github.com/suhas1010/rocket.chat/tree/develop/ee/packages/abac"
click node_presence "https://github.com/suhas1010/rocket.chat/blob/develop/ee/packages/presence/src/lib/presenceEngine.ts"
click node_auth "https://github.com/suhas1010/rocket.chat/blob/develop/packages/ui-contexts/src/AuthenticationContext.ts"
click node_session "https://github.com/suhas1010/rocket.chat/blob/develop/apps/meteor/client/views/root/hooks/useShareSessionWithOtherClients.ts"
click node_appsengine "https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/AppsEngine.ts"
click node_appmanager "https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/server/AppManager.ts"
click node_appui "https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/client/AppsEngineUIHost.ts"
click node_search "https://github.com/suhas1010/rocket.chat/blob/develop/packages/ai-search/src/clientSearch.ts"
click node_ddp "https://github.com/suhas1010/rocket.chat/blob/develop/packages/ddp-client/src/ClientStream.ts"
click node_server "https://github.com/suhas1010/rocket.chat/blob/develop/packages/ddp-server/src/Server.ts"
click node_storage "https://github.com/suhas1010/rocket.chat/blob/develop/packages/models/src/models/Apps.ts"
click node_random "https://github.com/suhas1010/rocket.chat/blob/develop/packages/random/src/main.client.ts"
click node_featurepreview "https://github.com/suhas1010/rocket.chat/blob/develop/packages/ui-client/src/hooks/useFeaturePreviewList.ts"

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_meteor,node_messages,node_livechat,node_calls,node_federation,node_presence,node_user toneBlue
class node_abac,node_auth,node_session toneAmber
class node_appsengine,node_appmanager,node_appui,node_search toneMint
class node_ddp,node_server,node_storage,node_random,node_featurepreview toneRose
class node_external toneIndigo
```

## Components

### Communication

- [Web client](https://github.com/suhas1010/rocket.chat/tree/develop/apps/meteor/client): `apps/meteor/client`
- [Messaging](https://github.com/suhas1010/rocket.chat/tree/develop/apps/meteor/client/components/message): `apps/meteor/client/components/message`
- [Customer live chat](https://github.com/suhas1010/rocket.chat/tree/develop/packages/livechat): `packages/livechat`
- [Voice and video](https://github.com/suhas1010/rocket.chat/tree/develop/packages/ui-video-conf): `packages/ui-video-conf`
- [Federation](https://github.com/suhas1010/rocket.chat/blob/develop/ee/packages/xmpp-server/src/s2s/S2SManager.ts): `ee/packages/xmpp-server/src/s2s/S2SManager.ts`
- [Presence](https://github.com/suhas1010/rocket.chat/blob/develop/ee/packages/presence/src/lib/presenceEngine.ts): `ee/packages/presence/src/lib/presenceEngine.ts`

### Security and identity

- [Attribute access](https://github.com/suhas1010/rocket.chat/tree/develop/ee/packages/abac): `ee/packages/abac`
- [Authentication](https://github.com/suhas1010/rocket.chat/blob/develop/packages/ui-contexts/src/AuthenticationContext.ts): `packages/ui-contexts/src/AuthenticationContext.ts`
- [Session sharing](https://github.com/suhas1010/rocket.chat/blob/develop/apps/meteor/client/views/root/hooks/useShareSessionWithOtherClients.ts): `apps/meteor/client/views/root/hooks/useShareSessionWithOtherClients.ts`

### Extensions and services

- [Apps Engine](https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/AppsEngine.ts): `packages/apps/src/AppsEngine.ts`
- [App manager](https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/server/AppManager.ts): `packages/apps/src/server/AppManager.ts`
- [App UI host](https://github.com/suhas1010/rocket.chat/blob/develop/packages/apps/src/client/AppsEngineUIHost.ts): `packages/apps/src/client/AppsEngineUIHost.ts`
- [AI search](https://github.com/suhas1010/rocket.chat/blob/develop/packages/ai-search/src/clientSearch.ts): `packages/ai-search/src/clientSearch.ts`

### Platform runtime

- [Realtime transport](https://github.com/suhas1010/rocket.chat/blob/develop/packages/ddp-client/src/ClientStream.ts): `packages/ddp-client/src/ClientStream.ts`
- [Workspace server](https://github.com/suhas1010/rocket.chat/blob/develop/packages/ddp-server/src/Server.ts): `packages/ddp-server/src/Server.ts`
- [Workspace data](https://github.com/suhas1010/rocket.chat/blob/develop/packages/models/src/models/Apps.ts): `packages/models/src/models/Apps.ts`
- [Random generation](https://github.com/suhas1010/rocket.chat/blob/develop/packages/random/src/main.client.ts): `packages/random/src/main.client.ts`
- [Feature previews](https://github.com/suhas1010/rocket.chat/blob/develop/packages/ui-client/src/hooks/useFeaturePreviewList.ts): `packages/ui-client/src/hooks/useFeaturePreviewList.ts`

### Other components

- **Workspace user**
- **External systems**

## Connections

- Workspace user → Web client: uses
- Web client → Messaging: communicates through
- Web client → Voice and video: starts calls
- Web client → Customer live chat: contacts support
- Messaging → Presence: shows status
- Messaging → Federation: communicates across networks
- Web client → Attribute access: enforces access controls
- Workspace user → Authentication: authenticates
- Authentication → Session sharing: shares session (evidence: `apps/meteor/client/views/root/hooks/useShareSessionWithOtherClients.ts`)
- Web client → Realtime transport: exchanges realtime data
- Realtime transport → Workspace server: transports requests
- Workspace server → Workspace data: persists workspace data
- Web client → Apps Engine: uses extensions
- Apps Engine → App manager: manages apps (evidence: `packages/apps/src/AppsEngine.ts`)
- Web client → App UI host: hosts app UI
- Apps Engine → External systems: integrates with systems
- Web client → AI search: searches conversations
- Web client → Feature previews: configures previews
