Get the SDK

The Nerja SDK is a small library you add to your own mobile app. With it, push notifications use your Firebase project and your users' devices register themselves with Nerja automatically.

Download#

1. Give it your Firebase file#

In the Firebase console open Project settings → Your apps and download google-services.json (Android) or GoogleService-Info.plist (iOS). This file only identifies your app; it is not the service-account key you paste into Nerja.

2. Android in five minutes#

1. 1

   Add the module

   Unzip, copy the nerja-sdk folder next to your app folder, then:

   settings.gradle / app/build.gradleCopy

   include ':nerja-sdk'
   
   dependencies {
       implementation project(':nerja-sdk')
   }

2. 2

   Initialise it

   Application.onCreate()Copy

   Nerja.init(this, new NerjaConfig.Builder()
       .baseUrl("https://api.nerja.ai")
       .appKey("nak_pk_live_…")   // from AI Connectors → Firebase → your app
       .build());

   If you already use the google-services Gradle plugin nothing else is needed. Without the plugin, put the JSON in res/raw and pass it with .firebaseJson(json, getPackageName()).

3. 3

   Ask for notification permission (Android 13+)

   javaCopy

   Nerja.requestNotificationPermission(activity);

3. iOS in five minutes#

1. 1

   Add the package

   Xcode → File → Add Package Dependencies → Add Local… and choose the unzipped folder. Add Firebase's FirebaseMessaging package and your GoogleService-Info.plist.

2. 2

   Enable capabilities

   Turn on Push Notifications and Background Modes → Remote notifications. This needs a paid Apple Developer account.

3. 3

   Configure

   swiftCopy

   Nerja.shared.configure(baseURL: "https://api.nerja.ai", appKey: "nak_pk_live_…")
   // after Firebase gives you the FCM token:
   Nerja.shared.registerPushToken(token)

4. Connect the Firebase project in Nerja#

Open AI Connectors → Firebase, paste your service-account JSON and create the app. The dialog shows the app key to use above. See Push setup for the full flow.

5. Check it works#

1. Run the app and accept the notification prompt.
2. In Nerja open a recipient — the FCM token appears on their profile within a few seconds.
3. Send a push campaign to that audience and look for the delivered and opened counters.