







A solution to organizing meetings in Matrix chat rooms and video conferences. Users can plan meetings, configure options like widgets for meeting rooms, invite participants, perform breakout sessions, and see their calendar. Meeting metadata is stored in Matrix rooms. It also provides an API to create meetings from third party services, like Open-Xchange.
![]() |
![]() |
![]() |
![]() |
The widgets has multiple parts:
- NeoDateFix Widget: Matrix widget for managing and viewing the calendar.
- NeoDateFix Bot: Matrix bot for creating meeting rooms.
- End-to-end tests: An end-to-end test suite for the Matrix widget and bot for creating meeting rooms.
Development on the widget happens at GitHub.
Please take a look at our Contribution Guidelines.
Check the following section on how to setup a development environment for the widget:
You need to install Node.js (>= 20.0.0
, prefer using an LTS version) and run
yarn
to work on this package.
The minimal Element version to use this widget is 1.11.29
.
After checkout, run yarn install
to download the required dependencies
Warning Do not use
npm install
when working with this package.
Rename the provided .env.local.default
to .env.local
in the widget or bot folder and fill it with your configuration.
For a list of available options, see Configuration.
Follow the instructions to run the widget locally.
Once running, you can visit the widget URL (http(s)://localhost:3000/
) and follow the instructions on how to add it to a room within Element Web.
In the project directory, you can run:
yarn dev
: Start the widget for development.yarn start
: Start the widget for development with a self-signed HTTPS certificate.yarn build
: Run the build step in all projects.yarn test
: Watch all files for changes and run tests of the widget.yarn lint
: Run eslint in all projects.yarn prettier:write
: Run prettier on all files to format them.yarn depcheck
: Check for missing or unused dependencies.yarn generate-disclaimer
: Generates license disclaimer and include it in the build output.yarn deduplicate
: Deduplicate dependencies in theyarn.lock
file.yarn changeset
: Generate a changeset that provides a description of a change.yarn docker:build
: Builds all containers from the output ofyarn build
andyarn generate-disclaimer
.yarn e2e
: Runs the end-to-end tests in a single browser. Pass--debug
to enable the debug UI. Runyarn docker:build
first.
Follow the instructions in the README.md file of the matrix-meetings-bot folder.
This package uses automated versioning.
Each change should be accompanied by a specification of the impact (patch
, minor
, or major
) and a description of the change.
Use yarn changeset
to generate a new changeset for a pull request.
Learn more in the .changeset
folder.
Once the change is merged to main
, a “Version Packages” pull request will be created.
As soon as the project maintainers merged it, the package will be released and the container is published.
We use Architecture Decision Records (ADR)s to document decisions for our software.
You can find them at /docs/adrs
.
You can run the widget using Docker:
docker run --rm -p 8080:8080 ghcr.io/nordeck/matrix-meetings-widget:latest
Be sure, that you also read the security notes in the base image @matrix-widget-toolkit/widget-server docs.
Our docker image supports customizing the nginx config by supplying additional config files. For example, this allows running the image in an IPv4-only environment, as demonstrated at https://github.com/nordeck/matrix-widget-toolkit/tree/main/containers/widget-server#custom-listen-directive
You can run the bot using Docker:
docker run --rm -p 3000:3000 ghcr.io/nordeck/matrix-meetings-bot:latest
We also provide HELM charts.
To ensure transparency and security in our software supply chain, we provide comprehensive Software Bill of Materials (SBOM) reports for this project and signed container images.
We provide SBOM reports within the widget container and as a release artifact.
- The generated SBOM report is available alongside the hosted widget assets, and can be found at
<DEPLOYMENT-URL>/sbom.spdx.json
, or via the filesystem at/usr/share/nginx/html/sbom.spdx.json
- For the bot container, you will find the SBOM at
/usr/local/share/doc/matrix-meetings-bot.sbom.spdx.json
- Each GitHub release has a corresponding image SBOM scan report file attached as a release asset
The container images releases are signed by cosign using identity-based (“keyless”) signing and transparency. Execute the following command to verify the signature of the container images:
cosign verify \
--certificate-identity-regexp https://github.com/nordeck/matrix-meetings/.github/workflows/publish-release-bot.yml@refs/tags/@nordeck/matrix-meetings-bot \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
ghcr.io/nordeck/matrix-meetings-bot:<version> | jq
cosign verify \
--certificate-identity-regexp https://github.com/nordeck/matrix-meetings/.github/workflows/publish-release-widget.yml@refs/tags/@nordeck/matrix-meetings-widget \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
ghcr.io/nordeck/matrix-meetings-widget:<version> | jq
It may be necessary to upgrade meeting rooms to a different Matrix room version, for example to use room version 12. You can learn more about Matrix room upgrades in general on the Matrix.org website.
Rooms used with NeoDateFix have special attributes. These rooms cannot simply be upgraded, as this will not keep the widget-specific events and will make the state stored in the meetings inconsistent.
The recommended way to “upgrade” instead is to recreate the rooms that were created or modified by the bot. All the necessary content must be exported from these rooms.
This applies to all the rooms: one-to-one chat with the bot, calendar room with meetings widget, meetings rooms, and breakout session rooms.
- In the case of one-to-one chat: the user has to leave the room and interact with the bot anew using a direct message.
- In the case of calendar room: the user has to leave the room, create a new one and invite the bot to the new room.
- In the case of meeting rooms and breakout rooms: the meeting creator should export any widget contents in the old meeting room and then has to delete their meetings via the meetings widget UI and create new meetings.
A new room gets the default room version from the Matrix server. This applies to the bot: new meeting rooms will use the default room version.
The widget and the bot are supported to work with multiple different room versions. It is not required to have the same room version for all bot rooms.
Room version 12 is supported from widget version 1.7.2 and bot version 2.8.4.
This project is licensed under Apache 2.0 license.
The disclaimer for other OSS components can be accessed via the /NOTICE.txt
endpoint.
The list of dependencies and their licenses are also available in a machine readable format at /usr/share/nginx/html/licenses.json
in the container image.
This project is part of the dPhoenixSuite by Dataport and the openDesk Sovereign Workplace by BMI/ZenDiS.
