SDK Documentation

Built for developers

Integrate Baseerh into your app in minutes. Our SDKs are designed to be simple, lightweight, and powerful—with full support for Arabic and RTL interfaces.

JavaScript

iOS

Android

Flutter

Installation

Add the Baseerh SDK to your JavaScript project

npm install @baseerh/sdk

Initialize the SDK

Configure Baseerh with your API key and preferred region

import { Baseerh } from '@baseerh/sdk';

// Initialize the SDK
const baseerh = new Baseerh({
  apiKey: 'your-api-key',
  region: 'me-central1', // Saudi Arabia
});

// Start tracking
baseerh.init();

Tip: Use me-central1 region for data residency in Saudi Arabia, ensuring PDPL compliance.

Track Events

Capture user behavior and custom events

// Track a custom event
baseerh.track('purchase_completed', {
  productId: 'SKU-12345',
  amount: 299.99,
  currency: 'SAR',
});

// Identify a user
baseerh.identify('user-123', {
  name: 'Ahmed Al-Rashid',
  email: 'ahmed@example.com',
  plan: 'premium',
});

User Engagement

Show in-app messages and trigger campaigns

// Show an in-app message
baseerh.engage.showMessage({
  type: 'modal',
  title: 'Welcome back!',
  body: 'Check out our new features.',
  cta: 'Learn More',
});

// Trigger a campaign
baseerh.engage.triggerCampaign('onboarding-flow');

API Reference

Analytics API

Track events, page views, and user properties

Engage API

In-app messages, push notifications, campaigns

REST API

Server-side integration and data export