This is the Kabelwerk SDK for Dart.


Add kabelwerk as a dependency in your pubspec.yaml.



The entry point is to create and configure an instance of the Kabelwerk class, which opens and maintains the websocket connection to the Kabelwerk backend.

final kabelwerk = Kabelwerk();

kabelwerk.config(url: url, token: token);

kabelwerk.on('ready', (KabelwerkReady event) {
  // this event is fired once when the initial connection is established
  final inbox = kabelwerk.openInbox();
  final room = kabelwerk.openRoom();

kabelwerk.on('error', (ErrorEvent event) {
  // e.g. when the token is invalid


A Kabelwerk instance takes care of automatically re-connecting when the connection drops, opening inboxes and rooms (see below), retrieving and updating user info.

Read more about the Kabelwerk class in the docs.


An inbox is a view on the rooms the user has access to; it maintains a list of rooms ordered by recency of their latest message.

final inbox = kabelwerk.openInbox();

inbox.on('ready', (InboxReady event) {
  // this event is fired once when the initial list of inbox items is loaded

inbox.on('updated', (InboxUpdated event) {
  // whenever a new message is posted, the list of inbox items is updated
  // accordingly and this event is fired


Read more about the Inbox class in the docs.


A room object handles posting and retrieving messages in a chat room.

final room = kabelwerk.openRoom(roomId);

room.on('ready', (RoomReady event) {
  // this event is fired once when the room is loaded

room.on('message_posted', (MessagePosted event) {
  // this event is fired every time a new message is posted in this room


room.postMessage(text: text).then((message) {
  // you will also get the same message via the `message_posted` event

You can open as many rooms as you need. However, if you just want to listen for newly posted messages, then it is simpler to leverage the InboxUpdated event.

Read more about the Room class in the docs.


Licensed under the MIT licence.


Welcome to the documentation of the Kabelwerk SDK for Dart!