@talkjs/expo

Official TalkJS SDK for React Native (Expo)

Usage no npm install needed!

<script type="module">
  import talkjsExpo from 'https://cdn.skypack.dev/@talkjs/expo';
</script>

README

TalkJS React Native SDK (Expo)

Official TalkJS SDK for React Native (Expo)

Note: This module is identical to @talkjs/react-native, except it has push notification support disabled. If you need push notifications, you can send them from your own backend using TalkJS webhooks or you can switch to @talkjs/react-native and create a development build for your project using EAS Build or eject to the bare workflow.

Expo's push notification support is rather limited which means that ejecting is the only option if you need advanced push notification UX features offered in Android, such as images in the notifications, making notifications appear as conversations, or grouping notifications per conversation.

What is TalkJS?

TalkJS lets you add user-to-user chat to your marketplace, on-demand app, or social platform. For more information, visit talkjs.com.

Screenshots of TalkJS running on various devices

Don't hesitate to let us know if you have any questions about TalkJS.

Installation

npm install @talkjs/react-native react-native-webview react-native-push-notification

Usage

You can import the library in one of the following ways:

ES6 / TypeScript:

import * as TalkjsRn from '@talkjs/react-native';

CommonJS:

const TalkjsRn = require('@talkjs/react-native');

Then follow our React Native guide to start using TalkJS in your project.

TalkJS is fully forward compatible

We promise to never break API compatibility. We may at times deprecate methods or fields, but we will never remove them. If something that used to work stops working, then that's a bug. Please report it and we'll fix it asap.

The package is being released in a beta state. The reason for this is that there are things that one can do with the TalkJS JavaScript SDK that aren't possible with the React Native SDK. We will release v1.0.0 of this package once the two SDKs are similar in terms of features. This however does not take away from our commitment to always maintain backward compatibility. So you can be assured that the package is stable for production use.

Changelog

Note: These are only the changes that have an effect on the React Native package and its interface. TalkJS gets many improvements and fixes all the time. Consider subscribing to our changelog if you want to stay updated.

0.3.0

New Features

  • Improved Error Reporting.
  • Add support for Guest Access through the addition of asGuest prop in Chatbox.
  • Enable capturing of keyup events in Chatbox through the captureKeyboardEvents and onKeyup props.
  • Added the methods: getText and typeText to MessageField.

Changes

Fixes

  • Fix bug when user and/or conversation synchronization were disabled.

Deprecated

  • The following props in ConversationList: feedConversationTitleMode, thirdParties, onBlur and onFocus.
  • The following props in Chatbox: chatSubtitleMode, chatTitleMode, thirdParties, translateConversations, onBlur and onFocus.

0.2.1

  • Fix bug in Chatbox when conversation synchronization was disabled.

0.2.0

  • Added a ConversationList component.
  • Added the messageField property to the Chatbox component
  • Fix bug in ConversationBuilder.setAttributes that prevented setting a value to null or undefined after previously having given it a value.
  • (iOS): Fix push notification registration token not getting received.
  • (iOS): Fix zooming when messageField is clicked.

0.1.0

  • Added the following components: Session, Chatbox and HtmlPanel.
  • First release