SDK Documentation

npx expo install @exponotify/sdk expo-notifications expo-device

import { Push } from 'exponotify-sdk';

// 1. Initialize (call once at app startup)
Push.init('pk_live_your_api_key');

// 2. Identify user after login
await Push.identify('user-123', { name: 'John' });

// 3. Register for push when ready
const token = await Push.register();

// Identify user with optional attributes
await Push.identify('user-123', {
  name: 'John Doe',
  email: 'john@example.com',
  plan: 'premium'
});

// Or just the user ID
await Push.identify('user-123');

// Set a single attribute
await Push.set('onboardingComplete', true);
await Push.set('plan', 'premium');
await Push.set('age', 25);

// Add tags (stored as JSON array)
await Push.tag('vip', 'beta-user', 'early-adopter');

// Set multiple attributes at once
await Push.setUser({
  name: 'John',
  email: 'john@example.com',
  country: 'US',
  signupDate: '2024-01-15'
});

// Register for push notifications
// This will prompt the user for permission
const token = await Push.register();

if (token) {
  console.log('Push token:', token);
} else {
  console.log('Permission denied or not a physical device');
}

// Check if registered
if (Push.isReady()) {
  // Device is registered and ready
}

// Get the current token
const currentToken = Push.getToken();

// Logout current user (keeps device registered)
await Push.logout();

// Unsubscribe from push notifications entirely
await Push.unsubscribe();

import { 
  useExponotify,
  useNotificationOpened,
  useNotificationReceived 
} from 'exponotify-sdk';

function App() {
  const { 
    token, 
    isRegistered, 
    isLoading, 
    register, 
    identify 
  } = useExponotify();

  // Handle notification opens (taps)
  useNotificationOpened((data) => {
    console.log('User tapped notification:', data);
    // Navigate to deep link, etc.
  });

  // Handle foreground notifications
  useNotificationReceived((notification) => {
    console.log('Received in foreground:', notification);
  });

  return (
    <Button 
      onPress={() => register(userId)} 
      disabled={isLoading}
    >
      {isRegistered ? 'Registered ✓' : 'Enable Notifications'}
    </Button>
  );
}