matrix-dart-sdk/doc/get-started.md

Follow these steps to get started with your first Matrix Client.

Step 1: Add dependencies

In your pubspec.yaml file add the following dependencies:

  matrix: <latest-version>
  # If you plan to use the SDK in a Flutter application on IO:
  sqflite: <latest-version>
  # For end to end encryption:
  flutter_olm: <latest-version>
  flutter_openssl_crypto: <latest-version>

Step 2: Create the client

final client = Client(
    '<Your Client Name>',
    databaseBuilder: (client) => MatrixSdkDatabase(
        '<Database Name>',
        database: await openDatabase('<path-to-store-database>'),
    ),
);

Step 3: Login

// Connect to a homeserver before login:
final homeserver = Uri.parse('https://matrix.org');
await client.checkHomeserver(homeserver);

await client.login(
    LoginType.password,
    user: AuthenticationUserIdentifier(user: '<your-username>'),
    password: '<your-password>',
);

Step 4: Create a new room

// Start a new DM room or return an existing room with a user
final roomId = await client.startDirectChat('<user-id>');

// Start a new group chat
final roomId = await client.createGroupChat(name: '<group-name>');

Step 5: Send messages

// Get a specific room by room ID or iterate over `client.rooms`:
final room = client.getRoomById('<room-id>');
// Or get the DM room for a user:
final dmRoom = client.getDirectChatFromUserId('<user-id>');

// Send a normal text message into the room:
await room.sendTextEvent('<your-message>');

Step 6: Receive messages

// Load the timeline of a room:
final timeline = await room.getTimeline(
    onUpdate: reloadYourGui(),
    onInsert: (i) => print('New message!'),
);

// Print all messages in the timeline to the console
for(final event in timeline.events) print(event.calcLocalizedBodyFallback());