drupal/matrix_recipes

Drupal recipes for Matrix API integration demos and starter configurations.

1.0.x-dev 2026-06-24 00:40 UTC

Requires

• drupal/matrix_api: ^3.0@alpha

GPL-2.0-or-later

README

A collection of Drupal recipes for integrating Matrix with Drupal sites. Built on top of the matrix_api module.

Requirements

• Drupal 11.2+
• A Matrix homeserver (e.g. meatball.zone running Synapse)
• A bot user account and access token

Installation

composer require freelock/matrix_recipes

Then apply individual recipes as needed:

drush recipe vendor/freelock/matrix_recipes/matrix_api_demo

Available recipes

Recipe	Description
matrix_api_demo	Node/comment ↔ Matrix thread sync on Article nodes
matrix_poll_endpoint	ECA endpoint at /eca/matrix/poll for htmx-triggered polling
matrix_identity	Link Drupal users to Matrix IDs; "whoami" bot command demo

Development

Each recipe lives in its own directory at the repo root. To add a new recipe, create a directory with a recipe.yml and optionally a config/ subdirectory for config entities.

See Drupal recipe documentation for the recipe authoring guide.