Widget Example
Reference widget demonstrating the core Matrix Widget API capabilities
About this app
A developer reference, not an end-user app: a small gallery of examples that each exercise one part of the Widget API — reading room members, reading and setting the room name, listing messages, sending a message, redacting an event, reading reactions, and using widget storage.
Useful as a conformance and learning sample when building or testing a host: open it against a driver and step through each capability in isolation.
Built by Beeper to accompany their widget SDK. It runs against Beeper's fork
of the Matrix Widget API (@beeper/matrix-widget-api). It is fully
client-side (no backend), but the repo carries no license and ships as a
Next.js app without static export configured, so Marcade does not build or
host it — it is listed here only, pointing at Beeper's own deployment.
Add to a room
Paste this into any room you may configure — Element and most clients understand /addwidget:
/addwidget https://example.beeper.vercel.appMarcade does not build or host this app — the URL is the deployment run by Beeper, and it can change under you at any time.
Name and icon in Element
/addwidget can carry only the URL: Element lists the app as “Custom” without an icon. Add the Marcade Store once per room and it gives every Marcade app pasted in there its name and icon, and tells you when an update is out.
/addwidget https://marcade.store/apps/de.minagawa.marcade-store/0.1.4/Permissions
Capabilities this widget may request. The Marcade Player asks for your consent before granting any of them.
- Read room state events of type “m.room.member”
org.matrix.msc2762.receive.state_event:m.room.member - Read room state events of type “m.room.name”
org.matrix.msc2762.receive.state_event:m.room.name - Send room state events of type “m.room.name”
org.matrix.msc2762.send.state_event:m.room.name - Read messages in the room
org.matrix.msc2762.receive.event:m.room.message - Send messages to the room
org.matrix.msc2762.send.event:m.room.message - Read room events of type “m.reaction”
org.matrix.msc2762.receive.event:m.reaction - Send room events of type “m.room.redaction”
org.matrix.msc2762.send.event:m.room.redaction
Information
- Section
- Unverified — Listed only. Marcade builds and hosts nothing; the link goes to the author’s own deployment.
- License
- NOASSERTION
- Author
- Beeper
- Source code
- https://github.com/beeper/widget-example
- Issue tracker
- https://github.com/beeper/widget-example/issues
- Encrypted rooms
- Not declared
- Widget ID
com.beeper.example