How ars-anosov/matrix-react works
matrix-react is a browser Matrix messenger with optional Active Directory (AD) authentication. Users can sign in directly or authenticate through AD, then use the Matrix session to browse rooms, accept invitations, view spaces and chat with text or encrypted file attachments. Device verification is a distinct E2EE workflow. The graph follows documented UI and service boundaries; unsampled implementation details are omitted, and optional external Matrix/AD endpoints are not wired to specific components without source evidence.
Main entry points: matrixClient.js Matrix client service · AuthContainer.jsx Auth coordination · mtrxControlActions.js Matrix actions · matrixRooms.js Room operations
Components 30
Application UI
- Application shell
src/App.jsx - Theme and verification config
src/theme.js
Authentication
- Auth forms and toggle
src/components/AuthPad.jsx - AD login form
src/components/AuthAd.jsx - Auth coordination
src/containers/AuthContainer.jsx - AD auth actions
src/actions/authControlActions.js - AD auth service
src/services/adAuth.js
Matrix session
- Matrix session container
src/containers/MtrxContainer.jsx - Matrix login form
src/components/MtrxReg.jsx - Matrix actions
src/actions/mtrxControlActions.js - Matrix client service
src/services/matrixClient.js - SDK loader
src/services/matrixSdk.js - Device verification UI
src/components/MtrxDeviceVerification.jsx
Rooms and messaging
- Messenger container
src/containers/MtrxPadContainer.jsx - Messenger panel
src/components/MtrxPad.jsx - Room list
src/components/MtrxRoomList.jsx - Active room
src/components/MtrxRoom.jsx - Message composer
src/components/MtrxComposer.jsx - File attachments
src/components/MtrxAttachment.jsx - Room operations
src/services/matrixRooms.js - Media transfer
src/services/matrixMedia.js
State and persistence
- Redux state
src/reducers/rootReducer.js - Auth state
src/reducers/authControlRdcr.js - Matrix state
src/reducers/mtrxControlRdcr.js - Action and UI constants
src/constants/redux.js - Client reference
src/services/matrixClientStore.js - Browser session storage
src/constants/storage.js
Other components
- User
- Matrix homeserver
- AD auth endpoint
Connections 35
- User → Application shell: uses
src/App.jsx - Application shell → Auth coordination: renders
src/App.jsx - Auth coordination → Auth forms and toggle: renders
src/containers/AuthContainer.jsx - Auth coordination → AD login form: renders
src/containers/AuthContainer.jsx - Auth coordination → AD auth actions: dispatches
src/containers/AuthContainer.jsx - AD auth actions → AD auth service: calls
src/actions/authControlActions.js - AD login form → AD auth service: submits through
src/components/AuthAd.jsx - AD auth service → AD auth endpoint: POSTs credentials
src/services/adAuth.js - Auth coordination → Matrix session container: coordinates session
src/containers/AuthContainer.jsx - Matrix session container → Matrix login form: renders
src/containers/MtrxContainer.jsx - Matrix session container → Messenger container: renders
src/containers/MtrxContainer.jsx - Messenger container → Messenger panel: renders
src/containers/MtrxPadContainer.jsx - Messenger panel → Room list: renders
src/components/MtrxPad.jsx - Messenger panel → Active room: renders
src/components/MtrxPad.jsx - Messenger panel → Device verification UI: renders
src/components/MtrxPad.jsx - Active room → Message composer: uses
README.md - Active room → File attachments: renders
README.md - Matrix session container → Matrix actions: dispatches
src/containers/MtrxContainer.jsx - Messenger container → Matrix actions: dispatches
src/containers/MtrxPadContainer.jsx - Matrix actions → Matrix client service: calls session operations
src/actions/mtrxControlActions.js - Matrix actions → Room operations: calls room operations
src/actions/mtrxControlActions.js - Matrix client service → SDK loader: loads
src/services/matrixClient.js - Matrix client service → Client reference: sets and reads
src/services/matrixClient.js - Matrix client service → Room operations: clears room cache
src/services/matrixClient.js - Matrix client service → Media transfer: clears media cache
src/services/matrixClient.js - Room operations → Client reference: gets client
src/services/matrixRooms.js - Room operations → Media transfer: uses media operations
src/services/matrixRooms.js - Room operations → Matrix homeserver: room operations
- Media transfer → Matrix homeserver: media transfer
- AD auth service → Browser session storage: persists AD session
src/services/adAuth.js - Matrix client service → Browser session storage: persists Matrix session
src/services/matrixClient.js - Redux state → Auth state: combines
src/reducers/rootReducer.js - Redux state → Matrix state: combines
src/reducers/rootReducer.js - AD auth actions → Action and UI constants: dispatches action types
src/actions/authControlActions.js - Matrix actions → Action and UI constants: dispatches action types
src/actions/mtrxControlActions.js