Codebase analysis · CoreStory V3

Element Web

An open-source Matrix chat client written in TypeScript and React. It covers rooms and direct messages, end-to-end encryption and device verification, room permissions and power levels, file sharing and user settings. Maintained by Element.

Maintained by
Element (element-hq)
License
AGPL-3.0
Commit analyzed
c3a4b8460cf2aa58bd7c3c4307d345d99b2a5b38
Rules extracted
2026-11-15
Extracted by CoreStory V3
22109
accepted rules, each with a cited source quote
20
capabilities
1986
features
01 · Rules

Business rules, traced to source lines.

These 11 rules are a sample of the 22,109 CoreStory V3 extracted from Element Web. Each one links to the exact lines on GitHub at commit c3a4b84. The statement is CoreStory V3’s wording; the code excerpt is the source it cites.

validation
apps/web/src/ContentMessages.ts

A file is acceptable only if the media config does not define 'm.upload.size', or the file's size is not greater than the configured 'm.upload.size' value; files exceeding the configured limit are rejected.

  • m.upload.size — media config key holding the maximum upload size
private isFileSizeAcceptable(file: File): boolean { if (this.mediaConfig?.["m.upload.size"] !== undefined && file.size > this.mediaConfig["m.upload.size"]) { return false; } return true; }

Also cited: L76–L78

authorization
apps/web/src/components/views/settings/tabs/room/SecurityRoomSettingsTab.tsx

The encryption toggle can only be enabled when the room is not already encrypted, encryption is not force-disabled, and the client has permission to send the `RoomEncryption` state event.

const hasEncryptionPermission = room.currentState.mayClientSendStateEvent(EventType.RoomEncryption, client); const isEncryptionForceDisabled = shouldForceDisableEncryption(client); const canEnableEncryption = !isEncrypted && !isEncryptionForceDisabled && hasEncryptionPermission;

Also cited: L563–L569

permission
apps/web/src/components/viewmodels/right_panel/user_info/UserInfoBasicViewModel.tsx

If the acting user can affect the target user and the acting user's power level is at least the edit power level, then `modifyLevelMax` is set to the acting user's power level; otherwise `modifyLevelMax` remains `-1`.

  • -1 — default modifyLevelMax when not permitted
let modifyLevelMax = -1; if (canAffectUser) { const editPowerLevel = powerLevels.events?.[EventType.RoomPowerLevels] ?? powerLevels.state_default ?? 50; if (me.powerLevel >= editPowerLevel) { modifyLevelMax = me.powerLevel; } }
permission
apps/web/src/components/viewmodels/right_panel/user_info/UserInfoBasicViewModel.tsx

`canInvite` is true when the acting user's power level is at least the room power-levels `invite` value, defaulting that value to `0` when absent.

  • 0 — default required power level to invite
setRoomPermissions({ canInvite: me.powerLevel >= (powerLevels.invite ?? 0), canEdit: modifyLevelMax >= 0, modifyLevelMax, });
authorization
apps/web/src/components/views/rooms/PinnedEventTile.tsx

The redact/delete menu item is rendered only when the current room state (forward direction) permits `maySendRedactionForEvent(event, matrixClient.getSafeUserId())` and the event type is neither `EventType.RoomServerAcl` nor `EventType.RoomEncryption`.

  • m.room.server_acl — event type excluded from redaction eligibility
  • m.room.encryption — event type excluded from redaction eligibility
const canRedact = room .getLiveTimeline() .getState(EventTimeline.FORWARDS) ?.maySendRedactionForEvent(event, matrixClient.getSafeUserId()) && event.getType() !== EventType.RoomServerAcl && event.getType() !== EventType.RoomEncryption;

Also cited: L239–L244

calculation
apps/web/src/components/views/rooms/NewRoomIntro.tsx

Encryption settings are considered expected when the room join rule is public, or when private rooms are not required to be encrypted, or when the room is encrypted; otherwise they are not expected.

  • public — join rule value that makes encryption settings expected
function hasExpectedEncryptionSettings(matrixClient: MatrixClient, room: Room): boolean { const isEncrypted: boolean = matrixClient.isRoomEncrypted(room.roomId); const isPublic: boolean = room.getJoinRule() === "public"; return isPublic || !privateShouldBeEncrypted(matrixClient) || isEncrypted; }
validation
apps/web/src/components/views/dialogs/ManualDeviceKeyVerificationDialog.tsx

For an unverified device, the supplied fingerprint must exactly equal the device's fingerprint; if it does not, a UserFriendlyError for 'encryption|verification|manual|wrong_fingerprint' is thrown with the actual fingerprint, deviceId, and supplied fingerprint, and verification does not proceed.

  • encryption|verification|manual|wrong_fingerprint — translation key for the fingerprint mismatch error
if (device.getFingerprint() !== fingerprint) { const fprint = device.getFingerprint(); throw new UserFriendlyError("encryption|verification|manual|wrong_fingerprint", { fprint, deviceId, fingerprint, cause: undefined, }); }
limit
apps/web/src/utils/userStatus.ts

A user status text must be at most 256 bytes when encoded as UTF-8; texts exceeding this limit are truncated to the first 256 bytes with an ellipsis appended, and validation via userStatusTextWithinMaxLength returns false when the UTF-8 byte length exceeds 256.

  • 256 bytes — maximum allowed length of status text in UTF-8 bytes
export function userStatusTextWithinMaxLength(text: string): boolean { const textEncoder = new TextEncoder(); return textEncoder.encode(text).length <= MAX_STATUS_TEXT_BYTES; }

Also cited: L16, L56–L58

calculation
apps/web/src/components/views/settings/tabs/room/SecurityRoomSettingsTab.tsx

Toggling guest access sets the guest access value to `GuestAccess.CanJoin` when the toggle is checked and `GuestAccess.Forbidden` when unchecked; if the new value equals the current value, no state event is sent.

  • can_join — guest access when checked
  • forbidden — guest access when unchecked
private onGuestAccessChange: ChangeEventHandler<HTMLInputElement> = (evt): void => { const allowed = evt.target.checked; const guestAccess = allowed ? GuestAccess.CanJoin : GuestAccess.Forbidden; const beforeGuestAccess = this.state.guestAccess; if (beforeGuestAccess === guestAccess) return; this.setState({ guestAccess });
calculation
apps/web/src/components/views/dialogs/RoomUpgradeWarningDialog.tsx

When continuing an upgrade, the `invite` flag passed to `doUpgrade` and `onFinished` is `true` only if the room is an invite-or-knock room AND the invite-users toggle state is `true`; otherwise `invite` is `false`. The `continue` flag is always `true` on this path.

  • true — value of continue flag on continue action
const opts = { continue: true, invite: this.isInviteOrKnockRoom && this.state.inviteUsersToNewRoom, };

Also cited: L82–L83

policy
apps/web/src/utils/MultiInviter.ts

If the promptBeforeInviteUnknownUsers setting is not enabled for the room, users with unknown profile errors are immediately re-invited with ignoreProfile set to true.

  • promptBeforeInviteUnknownUsers — setting controlling whether to prompt before inviting unknown users
if (!SettingsStore.getValue("promptBeforeInviteUnknownUsers", this.roomId)) { inviteUnknowns(); return; }

Also cited: L396–L399

02 · Capabilities

What the application does

20 capabilities identified, grouping 238 of the 1,185 distinct features extracted. Most extracted features are not grouped under a capability, so this list is a partial view of the application. These are descriptions, not the cited rules above.

Application Shell and Window Management

Managing application windows, menus, full-screen and zoom, quitting, menus and desktop/system services integration.

  • Application Lifecycle Control: Quitting the application with confirmation, including closing windows and brands.
  • Application Menu Bar: Top-level and context menus exposing file, edit, view, window, and help commands.
  • Application Menus: The application exposes a menu bar plus right-click/context menus for accessing core commands.
  • Application Quit: Handles quitting the application with a confirmation dialog and cancel option.
  • Application Quit and Confirmation: Quitting the application with a confirmation prompt and cancel option.
  • Clipboard Cut/Copy/Paste: Allows users to cut, copy, paste, and paste-matching-style content, including copying email and link URLs.
  • Clipboard Editing Operations: Supports cut, copy, paste, delete, undo, redo, and select-all editing actions.
  • Clipboard Operations: Provides cut, copy, paste, and match-style paste actions for content editing.
  • Context (Right-Click) Menu: Offers a right-click popup menu with context-sensitive commands such as copy, paste, and services.
  • Context Menu: Displays a right-click action menu for the current selection or target.
  • Context Menu Actions: Contextual menus for messages and rooms offering copy, edit, delete, and more.
  • Desktop Integration Services: System-level desktop actions such as file deletion, preferences, developer tools and the macOS services menu.
  • Full Screen Toggle: Allows the user to toggle full-screen display of the window.
  • Help and About: Displays application help, brand help, and about information, including developer tools access.
  • Menu Bar: Provides the top-level and context menus (file, edit, view, window, help, actions, common, right-click) that expose the application's commands to the user.
  • Quit Application: Exits the application, including a confirmation step before quitting.
  • Right-Click Context Menu: Presents a context menu on user interaction.
  • Services Integration: Invoking system services integration from the application menu.
  • Services Menu: Exposing the operating system's services menu to the user.
  • System Services Integration: Exposes the operating system's services integration to the user.
  • Undo And Redo: Enables users to undo and redo edit actions.
  • View Zoom: Lets users adjust the display scale with zoom in and zoom out actions.
  • View Zoom Control: Adjust the display zoom level by zooming in, zooming out, or resetting to actual size.
  • View Zooming: Allows the user to zoom in and out, including a reset to actual size.
  • Window Management: Controls for minimising, hiding, closing, zooming, and switching between application windows.
  • Zoom Control: Lets the user zoom in and out of content and view the actual size.

Rooms and Spaces

Creating, configuring, browsing, joining and leaving rooms and spaces, including membership, invitations and moderation.

  • Create New Space: Users can create a new space via a dedicated new-space affordance.
  • Invitation Handling: Users can accept or decline invitations with identity-server requirements.
  • Room & User Moderation: Room admins/moderators can ban, unban, kick, deop, and change power levels of users in rooms.
  • Room Creation: Users can create new rooms and direct messages, with prompts and summaries for the resulting space.
  • Room Invitations: Users can be invited to rooms and decline invitations.
  • Room Joining and Invites: Users join rooms, accept invites, and knock to request access.
  • Room Leaving: Users can leave rooms and spaces, with options to leave only specific rooms and warnings about public rejoin.
  • Room Membership: Joins, invites, leaves, knocks, and manages membership in rooms and spaces.
  • Room Membership Management: Handle users joining, inviting, leaving, being banned, and being kicked from rooms, including multiple-user and re-join variations.
  • Room Membership Notifications: View notifications when users join, leave, or rejoin a room or space.
  • Room Settings: Lets a user view and edit the settings of a room.
  • Room and Space Creation: Create new chat rooms and spaces
  • Room and Space Moderation: Kick, ban, unban, disinvite, and revoke invites for users in rooms and spaces, including bulk space actions.
  • Room and User Moderation: Ban, kick, unban and ignore users, and manage moderation rules.
  • Space Creation: Enables users to create and manage spaces.
  • Space Hierarchy Browsing: Users can browse and navigate the hierarchy of spaces and their rooms in a searchable, expandable list.
  • Space Management: Users can organise rooms within spaces and navigate between them.
  • Space Settings: Lets a user view and edit the settings and preferences of a space.
  • Space and Room Creation: Users can create spaces, rooms, and sections within the app.
  • Spaces Management: Users can create and manage spaces and their contained rooms.

End-to-End Encryption and Verification

Encrypting rooms and messages, managing keys, backups, recovery secrets, and verifying devices and users.

  • Cross-Signing and Recovery: Set up and manage cross-signing keys and account recovery.
  • Decryption Failure Handling: Surfaces decryption failure states to the user through dedicated error and warning UI containers.
  • Device Verification: Users can verify their own or other users' sessions/devices, view verified and unverified session lists, and complete verification flows.
  • Device and Identity Verification: Capabilities for verifying user identities and devices and managing secure cross-signing/recovery methods.
  • Device and User Verification: Users can verify their devices and identity, see verification status, and be alerted to new or removed recovery methods.
  • E2EE Dehydration: Dehydrating and restoring end-to-end encrypted device state.
  • Encryption: Enables and manages end-to-end encryption state for rooms.
  • Encryption Management: Users see encryption state per room and handle key backup, device verification, and decryption failures.
  • End-to-End Encryption: Rooms and messages are encrypted, with decryption failures and unverified devices surfaced to the user.
  • End-to-End Encryption & Device Verification: Users are protected by end-to-end encryption and can verify their own devices and other users.
  • End-to-End Encryption Status: Displaying encryption state and decrypting/verifying encrypted content.
  • Key Backup and Recovery: Users set up and validate secure key storage and recovery passphrases.
  • Key Import: Users can import encryption keys from a file to restore access to encrypted message history.
  • Room Encryption: Interacting with end-to-end encrypted rooms and reporting decryption state.
  • SAS Verification Display: Presents short authentication string verification material to the user, including emoji, decimal, and button-based views for comparing verification codes with another party.
  • Secure Secret Storage: Store and protect encryption keys and secrets, optionally behind a passphrase.
  • Secure Secret Storage Recovery: Passphrase-based recovery of encrypted secrets via the secure secret storage dialog.
  • Secure Secret Storage and Recovery: Users can store secrets securely and manage recovery methods.
  • User Verification: Users can verify other users via an interactive verification flow with explanation and confirmation.

Messaging and Conversation

Composing, sending, editing, redacting, reacting to, replying to, pinning, forwarding and starring messages in room timelines.

  • Chat Messaging & Timeline: Users can send and receive messages in rooms, view the timeline, reply in threads, and jump to dates or unread rooms.
  • Emotes: Sending emote actions within a conversation.
  • Failed Message Retry: Selects and retries messages that failed to send.
  • Message Composer: Provides the message composition input area with focused state, input controls, and send-button styling.
  • Message Composition: Allows the user to compose and send messages via the message composer area.
  • Message Composition and Sending: Users can compose, send, and reply to messages with autocomplete and rich upload/preview support.
  • Message Editing: Allows a user to edit an existing message through a dedicated edit composer with confirm/cancel controls.
  • Message Forwarding: Users can forward messages to other rooms.
  • Message Forwarding and Sharing: Users can share messages to other rooms using a share button and link copy actions.
  • Message Pinning: Users can pin and unpin messages in a room, view pinned messages, and jump to the pinned event.
  • Message Reactions: Allows users to add emoji reactions to messages.
  • Message Redaction: Users can redact (delete) messages, including their own, with a confirmation flow and redaction marking.
  • Message Replies: Users can reply to a specific message, with the reply relationship shown in the room and preserved in exports.
  • Message Retry: Users can retry sending failed messages, individually or all at once.
  • Message Send Status: Users can observe the delivery state of sent messages (sending, sent, failed) and retry behavior.
  • Message Starring: Starring messages to save them for later access.
  • Resending Failed Messages: Retrying unsent messages individually or in bulk.
  • Slash Commands: Execute slash commands to trigger client actions.
  • Stickers and Emotes: Send stickers and emotes in conversations.

Accessibility and Internationalization

Accessible labels, navigation and controls, keyboard shortcuts, reduced motion, and multi-language localization.

  • Accessibility: Users relying on assistive technology get accessible navigation and labels.
  • Accessibility Support: Accessibility features such as jumping to first unread room.
  • Focus Ring Styling: Provides accessible focus indication styling for interactive elements.
  • Internationalization Management: Manages translation resources via linting, sorting and diffing of i18n strings.
  • Keyboard Navigation: Navigates and acts within the app using keyboard shortcuts.
  • Keyboard Shortcuts: Provides keyboard shortcut definitions and displays them to users, likely in a help or settings panel.
  • Keyboard Shortcuts & Accessibility: Users can view and use keyboard shortcuts and accessibility settings such as jumping to the first unread room.
  • Language Selection: A UI control that lets users choose the language for an authentication body via a dropdown input and arrow.
  • Localization / Internationalization: The interface supports multiple languages via localized data elements.
  • Reduced Motion Support: Honors the user's reduced-motion preference by adjusting or disabling animations.
  • Speech (Text-to-Speech): Starts and stops speaking of content via the speech feature.
  • Speech Output: Starting and stopping spoken output of content via speech services.
  • Speech Playback: Provides text-to-speech reading of content that users can start and stop.
  • Speech Playback Control: Allows the user to start and stop text-to-speech playback.
  • Speech Synthesis: Provides text-to-speech capability letting users start and stop speaking content.
  • Text to Speech: Provides speech-based reading of content with start and stop speaking controls.
  • Text-to-Speech Playback: Start and stop spoken playback of content.

Authentication and Identity

Signing in, registering, session lifecycle, SSO/OIDC and QR login, password reset, and account security management.

  • Account Security Management: Set and manage account security details such as email and recovery methods.
  • Account Sign-In and Registration: Signing in and creating an account, including homeserver blocking states.
  • Authentication: Handles user authentication and identity.
  • Authentication and Registration: Users log in, register accounts, reset passwords, set an email and complete interactive auth steps.
  • Login & Registration: Users can register accounts, log in (including via SSO/OIDC and QR code), reset passwords, and handle soft-logout and session restore.
  • Login with QR: Allows users to sign in by scanning or generating a QR code during login.
  • Logout: Signing out of a session via a confirmation dialog.
  • Password Reset: Account password recovery and email setting flows.
  • SSO Login: A user authenticates via single sign-on through the interactive auth entry components.
  • Session Management: Users' sessions are restored, soft-logged-out, and recovered across logins and new devices.
  • Session Restore: Users can restore their session, including encrypted key backup.
  • Sign In & Account Creation: Signing in to an account, creating a new account, or continuing as a guest against a homeserver.
  • Two-Factor Authentication Setup: Users can set up two-factor authentication using a QR code and verification key.
  • User Authentication: Users can log in, register, and manage sessions including SSO/OIDC.
  • User Authentication & Login: Users can register, log in (including SSO/OIDC and QR-code login), reset passwords, verify email, and log out of their account.
  • User Authentication and Login: Users can log in, register, reset passwords, and use QR-code or OIDC-based authentication.
  • User Registration: Account creation flow including registration, terms acceptance, and user-interactive auth.

Media and File Sharing

Uploading, downloading, viewing and playing images, videos, audio, files and PDFs in rooms, including lightboxes and save/copy actions.

  • Attachment Handling: Users view, download, and open file attachments in messages.
  • Audio & Video Playback: Playing, pausing, seeking and zooming audio and video message attachments.
  • Audio Message Playback: Play back audio messages with controls and error handling.
  • Document Viewer: Provides ability to view documents shared in rooms.
  • File & Document Viewing: Viewing and downloading file, image and PDF attachments, including decryption progress states.
  • File & Media Sharing: Users can share and download files and media (images, files) in rooms, with upload/download progress and error states.
  • File Download: Retrieving files from the system through a dedicated download container.
  • File Upload: Enables users to upload and share files in rooms.
  • File and Document Viewing: Open and preview attached files, documents, PDFs, and images in a viewer and lightbox.
  • File and Media Upload: Users upload and share files, images, videos, and stickers in rooms.
  • Image Lightbox: Full-screen image viewing with a dimmed backdrop overlay.
  • Image Save and Copy: Saving rendered images to disk and copying images, image URLs and links to the clipboard.
  • Media Lightbox: Provides a full-screen image/media lightbox overlay with its own backdrop background and opacity settings.
  • PDF Viewer: Users can view PDF documents shared in rooms.
  • Voice Message Playback: Users can play, pause, and scrub through audio messages in a timeline with a seek bar and audio player display.
  • Voice Message Recording: Users can record a voice message in the composer, with recording, stop, and pulse-indicator states.
  • Voice Messages: Recording and sending voice messages in conversations.

Build, Test and Release Pipeline

Building, type-checking, linting, testing, packaging, signing, publishing and deploying the application across CI/CD workflows.

  • Artifact Build: Builds platform-specific artifacts with configurable targets, version, and naming.
  • Artifact Signing: Signs build artifacts using eSigner credentials and a signtool, with a signing cache.
  • CI Pipeline Execution: Automated build pipeline that checks out code, installs dependencies, and runs the project's test suite on each change.
  • Cloudflare Pages Deployment: A triggered workflow step publishes the built site to Cloudflare Pages, with environment and job dependencies declared.
  • Deployment: Deploys built artifacts to remote storage using configured credentials.
  • Docker Image Build: Builds the application's Docker container image for deployment.
  • End-to-End Testing: Runs Playwright end-to-end tests with an interactive mode and screenshot capture.
  • GitHub Release Creation: Automatically creates a GitHub release, including parsing the triggering tag and building an archive artifact to attach.
  • Linting & Static Analysis: Runs lint, style and type checks to enforce code quality across the codebase.
  • Project Build: Builds a project from declared inputs and outputs according to the project configuration.
  • Publish to npm: Publishes a Node package to the npm registry as part of the CI/release workflow.
  • Type Linting: Runs static type checks over the project's sources.
  • TypeScript Build: Compiles the TypeScript sources into build output.
  • Unit Testing: Runs the unit test suite, including screenshot assertions, to verify behaviour.
  • Visual Regression Testing: Detects stale screenshots and uploads/downloads visual regression results and vitest blobs.
  • Webapp Build: Builds the webapp.asar application bundle from fetched Element Web sources and a variant config.

User Profile and Settings

Viewing and editing user profiles, avatars, display names, and configuring application preferences, appearance and account options.

  • Account and Privacy Settings: Manage account details, deactivation, analytics and privacy options.
  • Appearance & Theme Settings: Users can customise the app's theme, font size, custom fonts, layout density, and emoji/timestamp display.
  • Application Preferences: Users can open and configure application preferences.
  • Avatar Upload: Allows a user to select and upload a profile avatar image via a file input control.
  • Avatar and Display Name Management: Viewing and changing user avatars and display names, including shared profile data.
  • Custom Themes: Applying user-selected custom themes and accessibility options.
  • Email & Phone Account Management: Users can add, verify, and remove email addresses and phone numbers on their account, with discovery/identity-server sharing controls.
  • Notification and Push Settings: Configure push notifications, notification rules and sound alerts.
  • Preferences: Open and edit user-configurable application preferences.
  • Settings and Preferences: Opening and adjusting application appearance, preferences, and security settings.
  • Theming: Applying official and custom themes to customise the application's appearance.
  • User Preferences: Users configure application preferences.
  • User Profile & Avatar Management: Users can set display names, avatars, nicknames, and manage profile-related fields such as email and phone numbers.
  • User Profile Display: Displays a user's profile card with avatar, display name, Matrix ID, presence, status message, timezone, and verification badge.
  • User Settings: Lets a user view and edit their account preferences.
  • User Settings and Preferences: Users can configure their profile, appearance, and app preferences.

Voice and Video Calling

Placing, receiving and controlling voice/video calls and conferences, with call controls, dial pad, screen sharing and device selection.

  • Call Controls: A set of in-call buttons that let the user hang up, toggle microphone mute, toggle the camera/video on or off, and toggle screen sharing during a call.
  • Call Tiles: Rendering and interacting with voice/video call participant tiles in the timeline.
  • Call View: Displays an active call interface, including the app tile used to represent participants or calls.
  • Call Window Controls: Pop out, maximise, minimise, and unmaximise the call view during an ongoing call.
  • Dial Pad: Open a dial pad for placing calls.
  • Dial Pad Access: Open the dial pad for initiating calls or entering numbers.
  • Element Call: Users can join and participate in video/voice conference rooms, including chat, reactions, and voice-over-IP calls.
  • Jitsi Video Call Integration: Support for hosting and joining Jitsi-based video conference calls within rooms.
  • Microphone and Camera Control: Enable or disable the microphone and camera and select input/output audio and video devices.
  • Screen Sharing: Share and stop sharing a screen or window during a call.
  • Screensharing: Start and stop sharing a screen, window, or monitor during a call and indicate who is presenting.
  • Video Room Conferencing: Capability to host and join conference/video rooms with lobby and permission controls.
  • Video Rooms: Enables Element Call video rooms as an available user-facing capability.
  • Voice & Video Calls: Users can start, answer, hold, and end voice/video calls, including viewing call events and missed-call statuses.
  • Voice and Video Calling: Users start, participate in, and hang up VoIP calls with call status and error feedback.
  • Voice and Video Calls: In-call interface styling for call views, controls, and video feeds.

Notifications

Delivering, configuring and dismissing notifications, alerts, badges and unread indicators.

  • In-App Notifications: Displays informational messages and error notifications to the user, including a branded icon overlay.
  • Notification Display: Displays notifications to the user for various events such as backend changes and errors.
  • Notification Options: Configuring room notification levels and muting or marking rooms read/unread.
  • Notification Preferences: Configuring notification options, message previews, and mention keywords.
  • Notification Preview Settings: Users can control whether message content previews appear in desktop notifications.
  • Notification Rules Configuration: Configuration of push/notification rules across override, content, room, sender, and underride scopes that determine how and whether events trigger notifications.
  • Notification Settings: Users can configure notification preferences, including quick settings and per-room notification panels.
  • Notifications: Users receive and manage notifications via panels and preferences.
  • Notifications & Mentions: Users can configure desktop and email notifications, enable audible alerts, and manage keyword/mention-based notification rules.
  • Notifications and Mentions: Configures notification options and surfaces mentions to the user.
  • Push Notification Rule Configuration: A set of push notification rules that determine how and when users are alerted to messages, calls, mentions, room events, and other activity in Matrix rooms.
  • Push Notification Rules: A set of per-event push rules that decide which room events notify a user, including message, mention, invite, reaction, and call events.
  • Toast Notifications: Display transient toast notification messages to the user, with optional title, icon, close button, and stacked layout.
  • Unread and Notification Tracking: Capability to track and jump to unread messages, mentions, and rooms.
  • Visual Notification Bell: A visual alert/bell indicator surfaced to the user.

Developer Tools and Diagnostics

Toggling developer tools, exploring room state and settings, verifying requests, and submitting bug reports and logs.

  • Analytics: Analytics tracking capability for user interactions.
  • Analytics and Usage Reporting: The app reports usage analytics to help improve the experience.
  • Bug Reporting: Allows users to submit bug reports with a developer console notice.
  • Bug Reporting and Feedback: Capability to report bugs and submit feedback, including sending logs.
  • Bug Reporting and Log Sharing: Users can report bugs and share logs including failed send diagnostics.
  • Developer Tools: Allows users to toggle developer tools for inspection.
  • Developer Tools Access: Allows users to toggle the built-in developer tools panel.
  • Developer Tools Toggle: Toggling developer tools for debugging the application.
  • Error Reporting: Displaying error, crash, and unable-to-open dialogs to inform the user of failures.
  • Feedback & Bug Reporting: Users can submit bug reports and feedback from the client.
  • Room State Explorer: A developer tools capability to query and inspect room state events by type and state key.
  • Settings Explorer: A developer tools interface for viewing and editing application settings, distinguishing mutable and immutable values.
  • Verification Request Inspection: A developer tools view for inspecting verification requests.

Search and Discovery

Searching messages, rooms and people, and discovering public rooms and spaces through directories and spotlight.

  • Autocomplete: Autocompleting user mentions and commands while typing.
  • Explore Rooms: Users discover and browse rooms through the explore directory and home views.
  • Message Search: Users can search message content across rooms, with indexing progress and result feedback provided in the UI.
  • Room Directory: Configures the public room directory presented to users for discovering rooms.
  • Room Discovery: Lets users browse and search for available rooms to join.
  • Room Exploration: Browse and discover rooms for the user to join.
  • Room Search: Search for rooms or messages within the workspace.
  • Room Search and Exploration: Users can search for and explore rooms from the interface.
  • Room, User and Message Search: Users search for rooms, people, and messages with results filtering and a cancelable search state.
  • Search: Searches messages and rooms with cancelable search interface.
  • Space Discovery and Joining: Users can discover spaces and observe joining progress or errors when joining them.
  • Spotlight Search: Opening the spotlight dialog for search and quick actions.
  • User Search: Searching for users within the application.

Integrations and Widgets

Embedding and managing widgets, bots, bridges and third-party integrations within rooms.

  • Element Call: Users can join and participate in video/voice conference rooms, including chat, reactions, and voice-over-IP calls.
  • Embedded Widgets: Users can interact with embedded widgets within rooms.
  • Integration Management: Exposes URLs for third-party integration REST endpoints, UI, and widgets.
  • Integrations: Users can manage third-party integrations and widgets.
  • Room Widgets: Users can interact with embedded room widgets and their associated data and permissions.
  • Room Widgets and Integrations: Enable embedded widgets in rooms with a widget capability and permission configuration dialog.
  • Third-Party Integrations: Provides access to external integrations such as widgets, bots, and conferencing through configured URLs.
  • Widget & Integration Management: Users can add widgets/integrations to rooms, with validation and permission checks governing the addition.
  • Widget Embedding: Embeds third-party widgets in rooms with their own body and menu bar styling.
  • Widget Integration: Supports embedding widgets within rooms.
  • Widgets: Users interact with embedded widgets in rooms.
  • Widgets and Integrations: Add and manage widgets and third-party integrations in rooms.

Message Timeline and History

Rendering the chronological room timeline with event tiles, read markers, date jumps and unread navigation.

  • Date-Based Timeline Navigation: Users jump to specific dates in the timeline with relative time labels.
  • Event List Summary: Collapse consecutive related events into a summarized grouped entry.
  • Event Tile Display: Renders individual message events as tiles with layout variants for bubbles, IRC, groups, and files.
  • Event Tile Rendering: Display individual events (messages, emoji, body content, errors) as event tiles in the timeline.
  • Event Timeline Display: Chronological timeline of room events with highlighting, selection, and timestamp presentation.
  • Jump to Bottom: A button that lets users scroll down to the newest messages, with a badge indicating hidden activity and a highlight state.
  • Jump to Date: Jumping to a specific date within the timeline.
  • Message Timeline: Displaying the room event timeline with read markers and jump-to-unread.
  • Message Timeline Viewing: Displays the room timeline with jump-to-bottom, date navigation, and read marker controls.
  • Read Receipts: Displays read receipt information on messages.
  • Room Timeline: Shows the message timeline of a room with scrolling, pagination, and date jumps.
  • Unread Message Navigation: Displays unread-message bars at the top and bottom of a conversation and lets the user jump to unread content or to the bottom of the list.

Moderation and Safety

Reporting and blocking content and users, ignoring users, applying moderation and power levels, and safety warnings.

  • Content Reporting: Users can report rooms and individual messages for abuse.
  • Content and Room Reporting: Report abusive messages or rooms and file bug reports.
  • Moderation Tools: Pending moderation review and moderation bot interactions.
  • Moderation and Power Levels: Managing room moderation and power levels.
  • Permissions and Capabilities Dialogs: Users can view and act on capability and permission dialogs for rooms and users.
  • Room & User Moderation: Room admins/moderators can ban, unban, kick, deop, and change power levels of users in rooms.
  • Room and User Moderation: Ban, kick, unban and ignore users, and manage moderation rules.
  • Scam and Safety Warnings: Users are warned about potential scams and unsafe situations.
  • User Blocking & Ignoring: Users can ignore or unignore other users, with dialogs explaining the effect and a list of ignored users managed in settings.
  • User Ignoring: Ignore or unignore another user to stop seeing their messages.
  • User Moderation and Power Levels: Moderators can promote, demote, and moderate users, adjusting power levels with appropriate warnings.

Presence and User Status

Setting and displaying user presence, custom statuses, typing indicators and read receipts.

  • Busy Presence Status: Exposes an optional presence state indicating a user is busy.
  • Custom Status: A user action that sets a custom status, optionally using an emoji and text input.
  • Presence: Users can see the online/offline status of other users.
  • Presence Status Indication: Visual indication of user availability states such as online, away, busy, and offline.
  • Read Receipt Display: Shows grouped read receipts so users can see who has read a message.
  • Read Receipts and Typing Notifications: Users see read receipts and typing indicators, and can toggle sending their own receipts and typing notifications.
  • Typing Indicators: Shows when other users are typing in a room.
  • User Presence Status Display: Displays a user's presence status (online, offline, away, busy) via presence icons on their avatar.
  • User Status: Displays and manages user presence status.
  • User Status Setting: Lets users set and clear their presence status.
  • User Status and Presence: Lets users set a status message and choose presence states like away, in a meeting, or on the road.

Room List and Navigation

Browsing, filtering, sorting and organising rooms, spaces and people in the sidebar and navigation panels.

  • Breadcrumbs: Navigating room hierarchies through breadcrumb navigation.
  • Left Panel Navigation: A left panel offers navigation actions such as searching, exploring rooms, opening the dial pad, and deleting items.
  • Navigation Panels: Navigating between home, chats, spaces, and activity via left panel and menus.
  • Room Customization: Favouriting, muting, pinning, and organizing rooms into sections.
  • Room List: Users see a navigable list of rooms with previews and load-more history.
  • Room List & Filters: Browsing, filtering, sorting, and organising rooms, spaces, and people in the sidebar.
  • Room List Filtering and Sorting: Filtering and sorting the list of rooms by type.
  • Room List Navigation: Browse, filter, and sort rooms with unread states and actions like favourite, mute, and mark read.
  • Room List Sections: Users organize rooms into custom sections, creating, editing, removing, and reordering them.
  • Space Navigation Panel: A collapsible side panel listing spaces that users can browse and navigate between.
  • Spaces Panel: The spaces sidebar panel for navigating between spaces, with its own background styling.

Call and Room Activity Navigation

Browsing activity, mentions and invites, viewing room details and member lists, and navigating room hierarchies.

  • Activity and Mentions View: Browsing recent activity, mentions, invites, and rooms grouped by category in a home view.
  • Call History Timeline: Displays past calls with human-readable relative timestamps such as 'about an hour ago' or 'in a few seconds' as part of the left panel.
  • Member List: Users can view room members and their presence.
  • Member List and Counts: Displaying room member counts and overflow lists.
  • Right Panel: Open an auxiliary side panel for room information and related content.
  • Right Panel Interaction: Users can open, pin, and maximise the right panel to view room details, threads, and widgets.
  • Room Member List: Users can view and interact with the list of members in a room, including inviting and managing permissions.
  • Room Status Area: Shows status information for the room, including expandable status lines and in-call indication.
  • Room Summary Card: Users can view a summary card for a room.
  • User and People Browsing: Browse and inspect users in the room via a member list and user info panel, with support for spotlight and suggestions.

Threaded Conversations

Viewing, following and participating in reply threads and the threads activity centre.

  • Thread List: Users can view and manage a list of threads within a room.
  • Thread Replies Summary: Show reply count and participants summary for a thread.
  • Thread Reply Summary: Displays collapsed thread reply counts and icons on messages so users can see and open reply threads.
  • Thread Row Display: Renders an individual thread entry showing the room name, sender, preview text, header, and decoration within the activity list.
  • Thread Viewing: Open and view a thread of replies in a dedicated thread panel/view.
  • Threaded Conversations: Users view and navigate threads, including the threads activity centre and thread summaries.
  • Threads: Users can participate in and browse threaded conversations, view all threads and their own threads.
  • Threads Activity Centre: A panel that lists thread activity with tabs, room and sender context, previews, and an empty-state caption for browsing ongoing conversations.
03 · Size

What was analyzed

  • TypeScript · 3,276 files · 361,818 lines
  • JSON · 197 files · 232,808 lines
  • YAML · 59 files · 25,656 lines
  • Markdown · 77 files · 20,278 lines
  • CSS · 109 files · 5,691 lines
  • HTML · 17 files · 1,444 lines
  • JavaScript · 20 files · 1,442 lines
  • SVG · 56 files · 1,019 lines
  • Bourne Shell · 18 files · 335 lines
  • Python · 2 files · 256 lines
  • diff · 11 files · 194 lines
  • Other (8 languages) · 14 files · 537 lines

Whole repository: 5,498 files. cloc 2.06 counts 651,478 lines of code in 3,856 of them (803,207 lines with comments and blanks).

04 · Source

Where this came from

Extracted by CoreStory V3 (build 4470 with two small engine fixes) using DeepSeek-V4.1-Flash from the public repository at commit c3a4b84 on 2026-11-15. Capability descriptions are from the same run.

Code excerpts are from the upstream repository and remain under its AGPL-3.0 license. CoreStory is not affiliated with or endorsed by Element (element-hq).

Want this for your own codebase?

Talk to us about mapping the business rules in your repositories.

Talk to an expert