stream_chat_flutter 0.1.6+2 copy "stream_chat_flutter: ^0.1.6+2" to clipboard
stream_chat_flutter: ^0.1.6+2 copied to clipboard

outdated

Stream Chat official Flutter SDK. Build your own chat experience using Dart and Flutter.

Flutter Chat Components #

Flutter Chat

The official Flutter components for Stream Chat, a service for building chat applications.

Pub CI codecov

Quick Links

Flutter Chat Tutorial #

The best place to start is the Flutter Chat Tutorial. It teaches you how to use this SDK and also shows how to make common changes.

Example App #

This repo includes a fully functional example app with setup instructions. The example is available under the example folder.

Add dependency #

dependencies:
 stream_chat_flutter: ^0.1.5

You should then run flutter packages get

Docs #

Business logic components #

We provide 2 Widgets dedicated to business logic and state management:

UI Components #

These are the available Widgets that you can use to build your application UI. Every widget uses the StreamChat or StreamChannel widgets to manage the state and communicate with Stream services.

Customizing styles #

The Flutter SDK comes with a fully designed set of widgets which you can customize to fit with your application style and typography. Changing the theme of Chat widgets works in a very similar way that MaterialApp and Theme do.

Out of the box all chat widgets use their own default styling, there are two ways to change the styling:

  1. Initialize the StreamChatTheme from your existing MaterialApp style
class MyApp extends StatelessWidget {
  final Client client;

  MyApp(this.client);

  @override
  Widget build(BuildContext context) {
    final theme = ThemeData(
      primarySwatch: Colors.green,
    );

    return MaterialApp(
      theme: theme,
      home: Container(
        child: StreamChat(
         streamChatThemeData: StreamChatThemeData.fromTheme(theme),
          client: client,
          child: ChannelListPage(),
        ),
      ),
    );
  }
}
  1. Construct a custom theme and provide all the customizations needed
class MyApp extends StatelessWidget {
  final Client client;

  MyApp(this.client);

  @override
  Widget build(BuildContext context) {
    final theme = ThemeData(
      primarySwatch: Colors.green,
    );

    return MaterialApp(
      theme: theme,
      home: Container(
        child: StreamChat(
          streamChatThemeData: StreamChatThemeData.fromTheme(theme).copyWith(
            ownMessageTheme: MessageTheme(
              messageBackgroundColor: Colors.black,
              messageText: TextStyle(
                color: Colors.white,
              ),
              avatarTheme: AvatarTheme(
                borderRadius: BorderRadius.circular(8),
              ),
            ),
          ),
          client: client,
          child: ChannelListPage(),
        ),
      ),
    );
  }
}

Contributing #

We welcome code changes that improve this library or fix a problem, please make sure to follow all best practices and add tests if applicable before submitting a Pull Request on Github. We are very happy to merge your code in the official repository. Make sure to sign our Contributor License Agreement (CLA) first. See our license file for more details.