v2.0 is now available

jxpush

Unified push notifications for Expo and FCM.
Build, send, and track messages with zero friction.

$npm install jxpush

Get Started View GitHub

Expo + FCM

Seamlessly switch between Expo Push API and Firebase Cloud Messaging without changing your logic.

Fluent Builder

Construct complex notification payloads with an intuitive, chainable API designed for readability.

Bulk Sending

Optimized for high-throughput. Send thousands of notifications in a single batch request efficiently.

Metrics & Logging

Built-in transparency for delivery status. Know exactly when messages are received or dropped.

TypeScript Ready

First-class type definitions included out of the box. Enjoy full autocomplete and type safety.

Production Safe

Battle-tested reliability with robust error handling and automatic retry mechanisms for failed sends.

typescript

import { PushClient, ProviderType, MessagePriority, LogLevel } from 'jxpush';

async function main() {
  // Initialize client with Expo
  const client = new PushClient({
    provider: ProviderType.EXPO,
    expo: {
      // Option 1: Use access token (optional, for higher rate limits)
      // accessToken: process.env.EXPO_ACCESS_TOKEN,
    },
    logLevel: LogLevel.INFO,
  });

  // Initialize the client
  await client.initialize();

  const singleResult = await client.send({
    token: 'ExponentPushToken[xxxxxxxxxxxxxxxxxxxxxx]',
    notification: {
      title: 'Hello from jxpush!',
      body: 'This is a test notification via Expo',
    },
    data: {
      customKey: 'customValue',
    },
    priority: MessagePriority.HIGH,
  });

  console.log('Single send result:', singleResult);
}

Simple, type-safe API for all your notification needs.