⚠️ Please note that SyncManager along with Sendbird’s SDK v3 will be deprecated by July 2023. You may still use SyncManager at your choice, but no new updates or bug fixes will be made to SDK v3 and SyncManager.

We recommend clients to plan their migration to SDK v4 and Local caching embeded in v4 as early as possible as there are breaking changes. We also provide prioritized support for migration and any issues related to v4. SDK v4 provides far richer and robust features in Websocket, Polls, Scheduled Messages, Pinned Message, and many more. So try it out now! (Chat SDK v4 react samples)

1. Introduction
2. Before getting started
3. Getting started

Sendbird SyncManager for JavaScript is a Chat SDK add-on that optimizes the user caching experience by interlinking the synchronization of the local data storage with the chat data in Sendbird server through an event-driven structure.

SyncManager leverages local caching and synchronizes the chat data between the local storage and Sendbird server. By handling the operations in an event-driven structure, the add-on provides a simplified Chat SDK integration and a better user experience.

• Background sync occurs whenever there is a connection and automatically stores data fetched from Sendbird server into the local cache.
• Real time sync occurs all the time; it identifies, stores, and delivers the real-time events received from WebSocket connection.
• Offline mode ensures your client app is operational during offline mode, meaning that even without background sync, the view can display cached data.

Find out more about Sendbird SyncManager for JavaScript on SyncManager for JavaScript doc. If you have any comments or questions regarding bugs and feature requests, visit Sendbird community.

This section shows the prerequisites you need to check to use Sendbird SyncManager for JavaScript.

The minimum requirements for SyncManager for Javascript are:

• Node.js v10+
• NPM v6+
• Sendbird Chat SDK for JavaScript v3.0.115+

Apart from browsers that don’t provide IndexDB, SyncManager supports all browsers that Sendbird Chat SDK for JavaScript also supports. Since access to local storage is restricted during private browsing in Firefox or InPrivate in Edge, SyncManager automatically detects the browsing mode and uses memory-based cache instead.

This section gives you information you need to get started with Sendbird SyncManager for JavaScript.

Download the sample app to test the core features of SyncManager for Javascript.

• https://github.com/sendbird/SendBird-JavaScript/tree/master/web-basic-sample-syncmanager

Note: The fastest way to test our SyncManager is to build your chat app on top of our sample app. Make sure to change the application ID of the sample app to your own. Go to the Create a Sendbird application from your dashboard section to learn more.

A Sendbird application comprises everything required in a chat service including users, message, and channels. To create an application:

1. Go to the Sendbird Dashboard and enter your email and password, and create a new account. You can also sign up with a Google account.
2. When prompted by the setup wizard, enter your organization information to manage Sendbird applications.
3. Lastly, when your dashboard home appears after completing setup, click Create + at the top-right corner.

Regardless of the platform, only one Sendbird application can be integrated per app; however, the application supports communication across all Sendbird’s provided platforms without any additional setup.

Note: All the data is limited to the scope of a single application, thus users in different Sendbird applications are unable to chat with each other.

Sendbird SyncManager currently supports iOS, Android, and JavaScript SDKs. You can download SyncManager for Javascript from our GitHub repository.

SyncManager for JavaScript is distributed through NPM.

Install using the following code:

~$ npm install `sendbird-syncmanager`