hcengineering / hcengineering/platform

Feature Request: Matrix integration for notifications and real-time communication in Huly Chat

Open
#9,742 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
27.7k
Forks
2.2k
PR merge metrics
No merged PRs in 30d

Description

### Summary

Add support for the [Matrix](https://matrix.org/) protocol to enable real-time messaging and notifications directly from Huly. This would allow teams to receive updates on tasks, documents, mentions, and other events in Matrix rooms (e.g., via Element or other clients).

### Motivation

Matrix is widely used in open-source and privacy-conscious teams. This integration would make Huly more accessible to communities already relying on Matrix for communication, reducing context-switching and improving response times.

### Proposed Features

- **Configuration**: Allow users to set Matrix homeserver URL and access token in workspace settings.
- **Project-to-room mapping**: Link Huly projects or spaces to specific Matrix rooms.
- **Event notifications**:
- Task created / assigned / updated / closed
- Document changes
- Mentions
- **Rich messages**: Use markdown formatting and optionally interactive buttons for quick actions.
- **Bot commands** (optional): Allow `/huly new-task "Title"` or `/huly status TASK-123` directly from Matrix.
- **E2E encryption** (optional): Support end-to-end encryption via Matrix SDK.

### Acceptance Criteria

- [ ] Settings UI to configure Matrix homeserver and token.
- [ ] Ability to map one or more Huly projects/spaces to Matrix rooms.
- [ ] Real-time notifications for key events (task changes, mentions, document edits).
- [ ] Documentation and example webhook payloads.

### Additional Context

- Matrix JS SDK: [matrix-js-sdk](https://github.com/matrix-org/matrix-js-sdk) for Node/Browser.
- List of all supported Matrix SDKs: [matrix-sdks](https://matrix.org/ecosystem/sdks/)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.