How element-hq/element-web works
Element is a Matrix web client with an Electron desktop wrapper. The principal workflow is user authentication, selecting a room, composing and dispatching messages, and exchanging Matrix events with a homeserver; encryption and key storage protect account data along the way. The graph also preserves documented desktop delivery and major client capabilities. Relationships are limited to README statements and the supplied source excerpts/index; many feature directories are unsampled, so their internal wiring is not inferred.
Main entry points: MatrixChat.tsx Element Web · dispatcher.ts Action Dispatcher · KeyStoragePanel.tsx Encryption Settings · KeyStoragePanelViewModel.ts Key Storage Logic
Components 27
Web Client
- Element Web
apps/web/src/components/structures/MatrixChat.tsx - Login and Registration
apps/web/src/components/structures/auth - SDK Configuration
apps/web/src/SdkConfig.ts - Platform Adapter
apps/web/src/BasePlatform.ts - Matrix Client Context
apps/web/src/contexts/MatrixClientContext.tsx - Browser Storage
apps/web/src/utils/StorageManager.ts - Storage Access
apps/web/src/utils/StorageAccess.ts
Rooms and Messaging
- Action Dispatcher
apps/web/src/dispatcher/dispatcher.ts - Action Types
apps/web/src/dispatcher/actions.ts - Action Payloads
apps/web/src/dispatcher/payloads.ts - Room Timeline
apps/web/src/components/structures/RoomView.tsx - Message Composer
apps/web/src/components/views/rooms/wysiwyg_composer/hooks/useWysiwygSendActionHandler.ts - Room Features
apps/web/src/Rooms.ts - Event Search Index
apps/web/src/indexing/BaseEventIndexManager.ts - Media and Calls
apps/web/src/MediaDeviceHandler.ts
Encryption and Settings
- Encryption Settings
apps/web/src/components/views/settings/encryption/KeyStoragePanel.tsx - Key Storage Logic
apps/web/src/components/viewmodels/settings/encryption/KeyStoragePanelViewModel.ts - Delete Key Storage
apps/web/src/viewmodels/crypto/DeleteKeyStorageViewModel.ts - Device Listener
apps/web/src/device-listener/DeviceListener.ts
Desktop Runtime
- Desktop Store
apps/desktop/src/store.ts - Electron Main
apps/desktop/src/electron-main.ts - Web Contents Handler
apps/desktop/src/webcontents-handler.ts - Desktop Configuration
apps/desktop/src/config.ts
Other components
- User
- Matrix JS SDK
- Matrix Homeserver
- Desktop User
Connections 28
- User → Login and Registration: signs in
README.md - Login and Registration → Element Web: enters client
- Element Web → Matrix JS SDK: uses SDK
README.md - Matrix JS SDK → Matrix Homeserver: exchanges events
- Element Web → SDK Configuration: reads settings
- Element Web → Platform Adapter: uses platform
- User → Room Timeline: opens room
- Message Composer → Action Dispatcher: registers handler
apps/web/src/components/views/rooms/wysiwyg_composer/hooks/useWysiwygSendActionHandler.ts - Action Dispatcher → Action Types: uses actions
apps/web/src/dispatcher/dispatcher.ts - Action Dispatcher → Action Payloads: uses payloads
apps/web/src/dispatcher/dispatcher.ts - Action Dispatcher → Message Composer: dispatches actions
apps/web/src/components/views/rooms/wysiwyg_composer/hooks/useWysiwygSendActionHandler.ts - Room Timeline → Room Features: uses room logic
- User → Encryption Settings: manages key storage
apps/web/src/components/views/settings/encryption/KeyStoragePanel.tsx - Encryption Settings → Key Storage Logic: reads state
apps/web/src/components/views/settings/encryption/KeyStoragePanel.tsx - Encryption Settings → Delete Key Storage: opens deletion flow
apps/web/src/components/views/settings/encryption/KeyStoragePanel.tsx - Key Storage Logic → Device Listener: pauses listener
apps/web/src/components/viewmodels/settings/encryption/KeyStoragePanelViewModel.ts - Delete Key Storage → Device Listener: pauses listener
apps/web/src/viewmodels/crypto/DeleteKeyStorageViewModel.ts - Delete Key Storage → Matrix JS SDK: disables key storage
apps/web/src/viewmodels/crypto/DeleteKeyStorageViewModel.ts - Key Storage Logic → Matrix Client Context: gets client
apps/web/src/components/viewmodels/settings/encryption/KeyStoragePanelViewModel.ts - Matrix JS SDK → Matrix Client Context: provides client
- User → Event Search Index: searches events
- User → Media and Calls: uses media features
- Browser Storage → Storage Access: gets IndexedDB
apps/web/src/utils/StorageManager.ts - Desktop User → Electron Main: launches app
- Electron Main → Web Contents Handler: handles web contents
- Web Contents Handler → Desktop Configuration: gets configuration
apps/desktop/src/webcontents-handler.ts - Web Contents Handler → Desktop Store: uses desktop state
- Electron Main → Element Web: wraps web client
README.md