Installation

You must create a free NativeNotify.com account to get your App ID and App Token. You need an App ID and App Token for Native Notify push notifications to work.

You must create a free https://Expo.dev account for Native Notify push notifications to work.

• Node.js: Make sure you have Node.js installed. The project uses npm, which comes with Node.js. Install Node.js from here.
• NPM or Yarn: Since the project uses npm commands, ensure that npm is installed with Node.js. Alternatively, you can use Yarn if preferred.

To verify installation, run:

node -v
npm -v

Run the following commands in your Expo project terminal:

npm install native-notify
npx expo install expo-device expo-notifications expo-constants

• expo-constants is a required peer dependency — native-notify imports it to resolve your EAS projectId.
• expo-notifications also needs its config plugin in your app.json — it is required for push notifications in development builds and EAS builds:

{
  "expo": {
    "plugins": ["expo-notifications"]
  }
}

In your App.js or index.js file (for Expo 50+), include this import at the top of the screen:

import registerNNPushToken from 'native-notify';

Make sure your App.js or index.js file (for Expo 50+) is a Hook function. Here is an example:

export default function AppPage() {
    ...
}

• This link explains Hooks in detail: https://react.dev/reference/react/hooks

• If you are using a class component, this link shows how to wrap a class component inside of a hook function allowing you to still use Native Notify in a class component: https://github.com/NativeNotify/wrap-class-in-hook

Inside of your App function, at the top of your App function, paste this code:

registerNNPushToken(app-id-number, 'app-token-string');

Here is a complete example:

import React, { useState, useEffect } from 'react';
import registerNNPushToken from 'native-notify';

export default function AppPage() {
    registerNNPushToken(app-id-number, 'app-token-string');

    return (
      ...
    )
}

Instead of passing appId and appToken to every call, you can set them once — with a provider:

import { NativeNotifyProvider } from 'native-notify';

export default function App() {
  return (
    <NativeNotifyProvider appId={yourAppId} appToken="yourAppToken">
      <Root />
    </NativeNotifyProvider>
  );
}

or at module scope (works for the plain, non-React functions):

import { NativeNotify } from 'native-notify';

NativeNotify.init({ appId: yourAppId, appToken: 'yourAppToken' });

Every function still accepts explicit ids, so nothing changes if you keep passing them — when the ids are omitted, they are resolved from NativeNotify.init() / <NativeNotifyProvider>. Inside a component you can read the active config with useNativeNotify().

Run the following commands in your Expo project terminal:

npm install -g eas-cli

If you have not logged into your eas account, run the following command in your terminal and follow the instructions:

eas login

Run the following command in your terminal and follow the instructions to ensure your project has a projectId (your app requires an eas projectId for push notifications to work):

eas init

This writes extra.eas.projectId into your app.json. Native Notify resolves it with Expo's recommended fallback chain:

Constants?.expoConfig?.extra?.eas?.projectId ?? Constants?.easConfig?.projectId

If neither value is present, registration fails with a clear "no EAS projectId found" message — see Expo's Configure projectId docs.

Run the following command in your terminal to start the dev server:

npx expo start

Then open the app — in Expo Go on iOS, or in a development build on Android (npx expo run:android or an EAS dev build).

Open your app on your iOS phone or Android phone. If you have not downloaded the Expo Go app yet, here is the link:

https://expo.dev/go