Matterbridge accessory platform example plugin

August 11, 2026 · View on GitHub

npm version npm downloads Docker Version Docker Pulls Node.js CI CodeQL codecov tested with Vitest styled with Oxc linted with Oxc TypeScript Native ESM matterbridge.io

powered by powered by powered by powered by


Matterbridge accessory platform example plugin is a template to develop your own plugin using the accessory platform.

It exposes a cover device that continuously moves position and shows how to use the command handlers (you can control the device).

If you want to write your plugin, the easiest way to start create a new plugin is to clone the Matterbridge Plugin Template which has Dev Container support for instant development environment and all tools and extensions (like Node.js, npm, TypeScript, ESLint, Prettier, Jest and Vitest) already loaded and configured.

If you like this project and find it useful, please consider giving it a star on GitHub and sponsoring it.

Buy me a coffee

Prerequisites

Matterbridge

See the guidelines on Matterbridge for more information.

Style guide

See also the Style Guide for JSDoc, naming, and logging conventions used in this repository.

Repository toolchain

Note: This repository uses a new toolchain. It replaces the traditional TypeScript / ESLint / Prettier / Jest stack with a faster and lighter setup.

  • No typescript 6.x package — replaced by TypeScript Native 7.x.
  • No ESLint, no Prettier — replaced by the oxc stack: oxlint for linting and oxfmt for formatting.
  • No Jest — replaced by Vitest, which is much faster and natively supports ESM without extra configuration.
  • Far fewer development dependencies — the number of installed packages drops from ~600 to ~75. A clean install is much faster.
  • Much faster linting and formatting — oxlint and oxfmt run in a fraction of the time required by the ESLint / Prettier pipeline.
  • Much faster builds — tsgo compiles the project in a fraction of the time required by the standard tsc build.
  • Editor support — use the VS Code extensions for tsgo and oxc to get the same experience in the editor.

Copilot instructions

FileNotes
.github/copilot-instructions.mdMain project instructions — always loaded
.github/instructions/chip-tests/chip-tests.instructions.mdCHIP conformance test harness — scoped to CHIP test files
.github/instructions/matterbridge/matterbridge.instructions.mdMatterbridge endpoint guide — dedicated Copilot instruction file
.github/instructions/plugin-frontend/plugin-frontend.instructions.mdPlugin frontend SPA and custom REST API guide — scoped to frontend and plugin code
.github/instructions/testing/unit-tests.instructions.mdTesting standards — scoped to **/*.test.ts

Claude instructions

FileNotes
CLAUDE.mdMain project instructions — always loaded
.claude/rules/chip-tests/chip-tests.instructions.mdCHIP conformance test harness — scoped to CHIP test files
.claude/rules/matterbridge/matterbridge.instructions.mdMatterbridge endpoint guide — loaded for all contexts
.claude/rules/plugin-frontend/plugin-frontend.instructions.mdPlugin frontend SPA and custom REST API guide — scoped to frontend and plugin code
.claude/rules/testing/unit-tests.instructions.mdTesting standards — scoped to **/*.test.ts

Codex/Agents instructions

FileNotes
AGENTS.mdMain project instructions
.agents/chip-tests.mdCHIP conformance test harness
.agents/matterbridge.mdMatterbridge endpoint guide
.agents/plugin-frontend.mdPlugin frontend SPA and custom REST API guide
.agents/testing.mdTesting and validation expectations
.codex/config.tomlCodex project permissions, approvals, and profile
.codex/rules/default.rulesCodex command allow, prompt, and deny rules

Development guide

Refer to the Matterbridge Development guide for other guidelines.