Skip to content
Rin Nguyen edited this page Jun 18, 2026 · 2 revisions

Matterbridge Roborock Vacuum Plugin — Wiki

Plugin integrating Roborock vacuum cleaners into the Matter ecosystem via Matterbridge. Enables control through Apple Home and other Matter-compatible apps.


Architecture & Reference

  • Code Structure — Full architecture overview, directory layout, module responsibilities, data flow, and design patterns
  • Authentication Flow — Roborock auth flow with diagram (login, token refresh, 2FA)
  • Service Area Update — Logic for handleServiceAreaUpdate, Matter attribute mapping, Apple Home display behavior

Refactoring & Design Notes


Completed Implementation Plans

Plan Status Description
Fire-and-Forget Architecture ✅ Done Replace PendingResponseTracker with push-pipeline pattern — overview
Fire-and-Forget V2 (Detailed) ✅ Done Phase-by-phase implementation guide with exact code changes
Fire-and-Forget Tasks ✅ Done Task checklist tracking all 3 phases (Phases 1–3)
PlatformRunner Split ✅ Done Extract private handler methods to src/runtimes/handlers/
CleanModeConfig Split ✅ Done Split cleanModeConfig.ts into focused submodules

Feature Plans

Clone this wiki locally