Zalo KitZalo SDK for React Native

Sign users in with Zalo, keep their session fresh and read their profile. Works with React Native CLI apps and Expo development builds.

Login that never hangs

App or web login with automatic web fallback. Failures reject with an error code you can switch on.

Access tokens are refreshed before they expire, and concurrent calls share one refresh because Zalo refresh tokens are single-use.

Tokens and sessions

Tokens are encrypted with the Android Keystore and kept in the iOS Keychain. Sessions saved by older versions are migrated.

Storage

Read the signed-in user's ID, name and avatar with one call.

User profile

One line in app.json configures Android and iOS, including the AppDelegate URL handler. Safe to rerun on every prebuild.

Expo setup

No MainActivity or MainApplication changes on Android, ProGuard rules included, and the iOS app ID is read from Info.plist.

Android setup

npmyarnExpo

npm install react-native-zalo-kit
cd ios && pod install

yarn add react-native-zalo-kit
cd ios && pod install

npx expo install react-native-zalo-kit
# add the plugin to app.json, then
npx expo prebuild

Then create a Zalo app and follow the setup for Expo, iOS or Android.

import { getUserProfile, login } from 'react-native-zalo-kit';

await login();
const { id, name, picture } = await getUserProfile();