RealTimeX
Sign inStart for free
RealTimeXMobile Package
Introduction5-minute overviewFeaturesHow the package worksGlossary
Requirements & dependenciesBackend credentialsInstallation step by stepTutorial — your first chat appProject config fileApp entry — index.jsQuick start — minimum working chatComplete ChatScreen example
Native configuration (iOS & Android)Firebase, APNs & backend setup
Navigation — embedding the chatSession, auth & Socket.IOPermissions & access controlAudio & video callingPush notificationsMentions viewRich-text messages (WebView editor)Total unread count
Customization — four waysDefault component fallback (important)Which slots are wiredCustomization examples (Case 1–4)UI feature flags & copy (ui)Chat info (group + DM)Style overrides (ui.styles)Render props (ChatProvider)Theme, fonts & appearance
ChatProvider props referenceconfigureChat options referenceHooks & storeCallbacks referenceAPI query paramsAll exports
Production integration pattern (Fieldr)Host app integration — providers, toasts, tab bars & navigationEnvironment variablesLocal package / monorepo (Metro)
TroubleshootingSetup checklistArchitectureDocumentation & file mapPackage development (maintainers)License
Mobile packageFeatures & Guides

Total unread count

Each conversation carries its own unreadCount (the row badge). There is no separate workspace-total API in the mobile package; derive a tab badge from the loaded conversations:

tsxsrc/navigation/ChatTabBadge.tsx
1// src/navigation/ChatTabBadge.tsx2import React from 'react';3import {Text} from 'react-native';4import {useConversations} from '@realtimexsco/live-chat-react-native';5 6export function ChatTabBadge() {7  const {conversations} = useConversations();8  const total = conversations.reduce((sum, c) => sum + (c.unreadCount || 0), 0);9  return total > 0 ? <Text>{total > 99 ? '99+' : total}</Text> : null;10}

This counts the conversations loaded so far (the list is paginated) and needs an active chat session.

PreviousRich-text messages (WebView editor)NextCustomization — four ways