Skip to content

docs(rn): unify React Native push notifications into a single guide - #486

Open
suraj-chauhan-cometchat wants to merge 2 commits into
mainfrom
docs/rn-push-notifications-unified
Open

docs(rn): unify React Native push notifications into a single guide#486
suraj-chauhan-cometchat wants to merge 2 commits into
mainfrom
docs/rn-push-notifications-unified

Conversation

@suraj-chauhan-cometchat

Copy link
Copy Markdown
Contributor

What

Replaces the split React Native (Android) and React Native (iOS) push guides with a single unified guide at notifications/react-native-push-notifications.mdx, documenting the JS-first @cometchat/push-notifications-react-native package.

Mirrors the Flutter restructure in #440.

Why

The RN push story is now one drop-in package (FCM on Android, APNs + PushKit/VoIP on iOS) with a JS-first design — native only shows UI and captures tokens; every CometChat action (register token, accept/reject/end call) runs in JS through the Chat SDK the app already ships. A single guide reflects that instead of two platform-split pages that duplicated setup.

Changes

  • Add notifications/react-native-push-notifications.mdx — unified guide: credentials, package install + platform config (npx cometchat-pn setup for iOS PushKit; zero app-side code on Android), init after login, permissions/tokens, notification taps + call events, killed-state decline via registerBackgroundCallTask, Android OEM permissions, badges, testing checklist, troubleshooting.
  • Delete notifications/react-native-push-notifications-android.mdx and -ios.mdx.
  • docs.json — collapse the two nav entries into one; redirect the old split paths (and /extensions/react-native-push-notifications) to the unified page.
  • Repoint cross-links in notifications.mdx, notifications/push-overview.mdx, calls/v4/react-native/overview.mdx, and sdk/react-native/push-notification-html-stripping.mdx.

Every code sample, config field, method name, provider-platform value, CLI command, and native setup step was verified against the shipped package source and the reference master-app integration.

🤖 Generated with Claude Code

Replace the split android/ios RN push guides with one unified
notifications/react-native-push-notifications.mdx documenting the
JS-first @cometchat/push-notifications-react-native package (FCM +
APNs/VoIP, CallKit/lock-screen call UI, killed-state handling).

Mirrors the Flutter restructure (#440):
- delete react-native-push-notifications-{android,ios}.mdx
- docs.json: collapse the two nav entries into one; redirect the old
  split paths (and /extensions/... ) to the unified page
- repoint cross-links in notifications.mdx, push-overview.mdx,
  calls/v4/react-native/overview.mdx, and the SDK html-stripping guide

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Aug 28, 2026

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cometchat 🟢 Ready View Preview Aug 28, 2026, 7:09 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

The push-getting-started page is introduced by the still-open Flutter PR
#440; until it merges, link the shared setup prerequisite
to the existing notifications/push-overview page so the RN guide has no
dead links on main.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant