Amity Social UIKit — React Native sample app

A minimal React Native CLI app (RN 0.82, React 19) that mounts the Amity Social UIKit so you can test/customize it. The UIKit is installed from the local tarball amityco-react-native-social-uikit-4.0.0-beta-2.tgz.

This is a stripped-down version of the UIKit repo's example/ app — it drops the Firebase push-notification wiring (which requires google-services.json / GoogleService-Info.plist credentials) so it runs out of the box.

What's set up

• @amityco/react-native-social-uikit@4.0.0-beta-2 installed from the local .tgz
• All UIKit peer dependencies (LiveKit, vision-camera pinned to 4.7.3, gesture-handler, svg, video, etc.)
• babel.config.js — adds @babel/plugin-transform-export-namespace-from
• App.tsx — wraps AmityUiKitSocial in AmityUiKitProvider, themed by uikit.config.json
• ios/Podfile — adds SPTPersistentCache, DVAssetLoaderDelegate, $RNVideoUseVideoCaching
• iOS Info.plist — camera / microphone / photo-library usage descriptions
• Android AndroidManifest.xml — CAMERA + RECORD_AUDIO permissions
• CocoaPods installed (96 pods)

Configure credentials

The Amity API credentials live at the top of App.tsx. They are reused from the reference example (region us). Replace them with your own to point the app at your network:

const API_KEY = '...';
const API_REGION = 'us';
const API_ENDPOINT = 'https://api.us.amity.co';
const USER_ID = 'sample-app-user';
const DISPLAY_NAME = 'Sample App User';

Run

Dependencies are already installed (npm install). Start Metro and the app:

# Terminal 1 — Metro bundler
npm start

# Terminal 2 — iOS
npm run ios

# …or Android
npm run android

Re-installing native pods (iOS)

If you change native dependencies, re-run CocoaPods. This machine's RVM ruby shadows the working CocoaPods, so call the Homebrew pod directly:

cd ios && /opt/homebrew/bin/pod install

Customization

Theme and per-page/component appearance are driven by uikit.config.json. For example, switch dark mode with:

"preferred_theme": "dark"

See the UIKit repo's README for the full customization reference.

Notes

• vision-camera is pinned to 4.7.3 on purpose — newer 4.x/5.x releases migrated to Nitro Modules and break the Android build.
• Push notifications (Firebase) are intentionally not wired up. The UIKit treats fcmToken as optional. To add push, install @react-native-firebase/app + @react-native-firebase/messaging and supply your Firebase credentials.