Yallapush Documentation

Prerequisites

• React Native CLI or Expo Bare Workflow.
• Firebase project with Android + iOS apps added.
• google-services.json (Android) and GoogleService-Info.plist (iOS).

Install Dependencies

npm install @react-native-firebase/app @react-native-firebase/messaging

Android Setup

Place google-services.json inside android/app/.

// android/build.gradle
buildscript {
  dependencies {
    classpath 'com.google.gms:google-services:4.3.15'
  }
}

// android/app/build.gradle
apply plugin: 'com.google.gms.google-services'

dependencies {
  implementation platform('com.google.firebase:firebase-bom:32.2.0')
  implementation 'com.google.firebase:firebase-messaging'
}

Add permission for Android 13+:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

iOS Setup

• Add GoogleService-Info.plist to Xcode project.
• Enable Push Notifications + Background Modes (Remote notifications).
• Install pods:

cd ios && pod install

Request Permission & Get Token

import React, { useEffect } from "react";
import { Platform } from "react-native";
import messaging from "@react-native-firebase/messaging";

async function registerDevice() {
  const authStatus = await messaging().requestPermission();
  const enabled =
    authStatus === messaging.AuthorizationStatus.AUTHORIZED ||
    authStatus === messaging.AuthorizationStatus.PROVISIONAL;

  if (!enabled) {
    console.log("Push permission not granted");
    return;
  }

  const token = await messaging().getToken();
  console.log("FCM Token:", token);

  await fetch("https://api.yallapush.com/device/register", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      device_token: token,
      platform: Platform.OS,
      user_id: "12345"
    })
  });
}

export default function App() {
  useEffect(() => {
    registerDevice();
  }, []);

  return null;
}

Handle Foreground & Background Messages

// Foreground
useEffect(() => {
  const unsubscribe = messaging().onMessage(async remoteMessage => {
    console.log("Message in foreground:", remoteMessage);
  });
  return unsubscribe;
}, []);

// Background & quit state
messaging().setBackgroundMessageHandler(async remoteMessage => {
  console.log("Message in background:", remoteMessage);
});

Handle Token Refresh

messaging().onTokenRefresh(token => {
  fetch("https://api.yallapush.com/device/register", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ device_token: token, platform: Platform.OS })
  });
});

Testing

1. Run on a physical Android/iOS device.
2. Check console for FCM token.
3. Send test notification from Firebase Console → Cloud Messaging.
4. Verify push received & token in YallaPush dashboard.

Best Practices

• Always handle onTokenRefresh to keep YallaPush updated.
• Use data payloads for deep links/custom actions.
• On iOS, ensure APNs is enabled with correct certificates/keys.
• On Android 13+, request runtime notification permission.

Prerequisites

• Firebase project with iOS app registered.
• Add GoogleService-Info.plist to your Xcode project.
• Enable Push Notifications and Background Modes → Remote notifications in Xcode.
• Physical iOS device (simulators don’t support push).

Install Dependencies

cd ios && pod install

AppDelegate Setup

import UIKit
import Firebase
import UserNotifications

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    FirebaseApp.configure()
    UNUserNotificationCenter.current().delegate = self
    application.registerForRemoteNotifications()
    return true
  }
}

extension AppDelegate: UNUserNotificationCenterDelegate {
  func userNotificationCenter(_ center: UNUserNotificationCenter,
    willPresent notification: UNNotification,
    withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    completionHandler([.alert, .sound, .badge])
  }
}

Get FCM Token

Messaging.messaging().token { token, error in
  if let error = error {
    print("Error fetching FCM token: \(error)")
  } else if let token = token {
    print("FCM Token: \(token)")
    // Send token to YallaPush
  }
}

Testing

1. Run on a physical iPhone/iPad (not simulator).
2. Check Xcode logs for FCM token.
3. Send test push from Firebase Console → Cloud Messaging.
4. Verify delivery & token in YallaPush dashboard.

Best Practices

• Ensure APNs keys/certificates are correctly configured in Firebase.
• Handle Messaging.messaging().token refresh to update backend.
• Always test on physical devices.