Skip to main content
​
New ReleasesImprovements

​
🚀 New Features

​
Standalone Chat Pages

All 16 chat pages are now exported from the package root under the same names as the Web UIKit, so you can render any one of them inside AmityPageRenderer. For example, render <AmityChatPage channelId="..." /> to open a conversation straight from a push notification. Each page that takes input exports a <PageName>Props type, such as AmityChatPageProps. From a rendered page, users can still move on to the other chat pages. See Chat Components.

​
Localization API

AmityUiKitProvider takes a localization prop (localeBundle, overrides, localeMap), the same shape as the Web UIKit. useLocale and useString are exported from the package root. When you pass a localeMap, the UIKit picks a bundle from the device language. Without one, chat stays in English as before. See Localization.

​
✨ Improvements

  • Removed the built-in Thai string bundle. English is the only built-in language, as on the other platforms. Add Thai or any other language with your own bundle through localization.

​
🧩 Compatibility

​
New ReleasesImprovements

​
🚀 New Features

​
Chat UIKit

The React Native UIKit now includes in-app messaging. Render the new AmityUiKitChat entry point inside AmityUiKitProvider to mount the chat experience. It needs no extra package. See Add Chat.
  • Chat list: browse, search, and archive conversations, with unread and mention badges.
  • One-to-one and group chats: send text, images, and videos, reply to messages, mention members, and see link previews.
  • Message actions: react, copy, edit, delete (with confirmation), report, and save photos or videos to the gallery. Failed messages can be resent from the message bubble.
  • Search: find chats and messages from the chat list, and jump straight to a matching message.
  • Group management: create groups, edit the group name and avatar, add and remove members, and manage banned users.
  • Moderation: moderators can delete any message. Users can report, unreport, and block other users. Chats with blocked users are hidden from search.
  • Notifications: chat notification settings, plus a banner when push notifications have been disabled by an admin.
  • Brand and moderator badges are shown throughout chat.

​
Chat Navigation Behaviors

Handle avatar and @mention taps in your own app through AmityChatPageBehavior and AmityMessageBubbleBehavior. See Message Bubble Behavior.

​
✨ Improvements

  • Bottom sheets across the UIKit now open, resize, and drag more smoothly.
  • Chat strings ship in English. The package has no API to change them until 4.3.1 — see Localization.
  • Upgraded the social.plus SDK dependency (@amityco/ts-sdk-react-native) to ^7.28.0.

​
🚨 Compatibility Changes

  • iOS: add NSPhotoLibraryAddUsageDescription to your app’s Info.plist before upgrading. Saving a photo or video from chat asks iOS for permission to add to the photo library, and iOS terminates an app that asks without this key.
  • Android: declare WRITE_EXTERNAL_STORAGE with android:maxSdkVersion="28" in your app’s AndroidManifest.xml. Android 9 and below need it to save to the gallery; without it, saving always fails with a permission error.
  • New peer dependencies: react-native-reanimated ~4.3.4, react-native-worklets ~0.8.3, and @react-native-camera-roll/camera-roll ^7.10.2. Add 'react-native-worklets/plugin' as the last plugin in your app’s babel.config.js.
  • @react-native-community/netinfo must now be >=11.5.0. react-native-netinfo is no longer required.
See Installation for the full setup.

​
🧩 Compatibility

​
New ReleasesImprovements

​
🚀 New Features

Posts with two or more images or videos now render as a swipeable media carousel, in both the feed and the composer preview.

​
✨ Improvements

  • Upgraded the social.plus SDK dependency (@amityco/ts-sdk-react-native) to 7.27.0.

​
🐞 Bug Fixes

  • Media carousel: reset to the first frame on a feed reload and when the feed regains focus, and keep the index in range when frames are removed.
  • Post composer: fixed media upload failures, per-item gating and retry, stable media identity for de-duplication, and edit-mode media resolution.
  • Media viewer: carry the sound setting across carousel frames, and inset the header by the top safe area.
  • Stopped showing the default avatar as a video thumbnail.
  • Fixed the carousel play icon and the video frame ratio.
  • Gate pending-post accept/decline and the author banner on the community moderator role.
  • Reject an offline upload up front instead of leaving it pending.

​
🧩 Compatibility

​
New ReleasesImprovements

​
🚀 New Features

​
Visitor Mode

Added visitor mode with enhanced daily usage-limit handling, including a VisitorUsageLimit page exported from the public API. Non-members now see an engagement bar with gated like and comment actions that prompt a sign-in toast.

​
Login Configuration

Added support for applying login behavior from configuration.

​
✨ Improvements

  • Upgraded the social.plus SDK dependency (@amityco/ts-sdk-react-native) to 7.23.0.

​
🐞 Bug Fixes

  • Show action controls on story comments.
  • Fixed the tab navigation and divider showing when Explore is the only tab.
  • Fixed long user profile descriptions overflowing on iOS.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed image upload failing in the post composer.

​
🧩 Compatibility

​
New ReleasesImprovements

​
🚀 New Features

​
React Native UIKit v4.0.0 — General Availability

The React Native UIKit v4 is now generally available, graduating from the release-candidate series to a stable release. This release ships the refreshed v4 component architecture, live streaming powered by LiveKit, deep linking and push notification support, notification settings, and user profile screens.

​
Post Link Validation

Added link validation in the post composer, preventing invalid URLs from being submitted.

​
✨ Improvements

  • Switched Android post video playback to HLS streaming for more reliable playback.
  • Added video compression for stories to reduce upload size.

​
🐞 Bug Fixes

  • Fixed an Android story crash caused by oversized camera capture, by capping the video capture resolution.
  • Fixed black story footer and draft background, and the incorrect delete (trash) icon color.
  • Fixed a duplicate live badge appearing on the Android livestream player.
  • Fixed Android poll duration not updating when tapped.
  • Fixed reply count not being pluralized in comment “view more” labels.
  • Fixed a nested “view replies” affordance incorrectly appearing in the reply list.
  • Fixed long brand user names overflowing their layout.
  • Fixed avatar tap not navigating to the user profile.
  • Fixed post menu share options being shown to non-members.
  • Fixed mentioning members of a private community.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed story ring incorrectly showing when the user has no active stories.
  • Fixed incorrect permission check blocking story creation.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed livestream player displaying in wrong aspect ratio.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed user search being case-sensitive by adding matchType set to partial for search queries.
  • Fixed community search crash caused by duplicate keys and undefined slice operation.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed page re-rendering issue during pagination on social home page.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed story comment behavior to align with community settings.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed custom avatar URL not displaying correctly for followings and followers.
  • Fixed performance issues on social home page.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed incorrect permission check on create Post button.

​
🧩 Compatibility

​
Improvements

​
Breaking Behaviour

  • User search result contains only displayname matches.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed Comment composer appears behind the keyboard.
  • Fixed Post header not fully visible when navigating to Post details

​
🧩 Compatibility

​
New Releases

​
🚀 New Features

  • Upgraded Livestream service

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed incorrect participant count when there is a single poll vote.

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fixed nested navigation issue by upgrading navigation lib.
  • Fixed absolute import issue by migrating to relative import internally.

​
🚨 Compatibility Changes

​
RN 0.8x Compatibility

  • Replaced react-native-create-thumbnail with react-native-compressor for local video thumbnail generation.
  • Removed unusedreact-native-rsa-native dependency.

​
🧩 Compatibility

​
New ReleasesImprovements

​
🚀 New Features

​
Community feature parity

  • Introduce key community features; Profile, Settings, Membership, Pending Posts, Featured/Pinned Posts.

​
🚨 Compatibility Changes

​
Support 16 KB page sizes

  • Bumped React Native version to 0.77

​
🧩 Compatibility

​
New Releases

​
🚀 New Features

  • Support Redux store isolation, enables isolation of storage between UIKit and application.

​
🧩 Compatibility

​
New Releases

​
🚨 Dependency Changes

​
React Native New Architecture

  • Bumped React Native version to 0.76.9

​
🧩 Compatibility

​
Improvements

​
🐞 Bug Fixes

  • Fix global feed content loading.

​
🧩 Compatibility

​
New Releases

​
🚀 New Features

​
Post Engagement

  • Introduce new post engagement component.

​
🧩 Compatibility

​
New Releases

​
🚀 New Features

​
Story

  • Support rendering stories on newsfeed.

​
🧩 Compatibility

​
New Releases

​
🚀 New Features

​
Poll post

  • Support poll post rendering and poll post creation.

​
🚨 Dependency Changes

  • Added new peer dependency: @react-native-community/datetimepicker (v7.1.0)

​
🧩 Compatibility