Hawcx React Native SDK with Smart Connect

1. Add the package to your React Native project (pin to the latest published version):

npm install @hawcx/[email protected]

2. Declare the pod dependency in your ios/Podfile so native builds stay in sync with the npm package:

pod 'HawcxReactNative', '1.0.2'   # or use '~> 1.0' for minor updates

3. Install iOS pods so the bundled HawcxFramework.xcframework links correctly:

cd ios && pod install

4. Open the ios/*.xcworkspace in Xcode and build once so the native module is registered.
5. Keep your project API key and tenant base URL handy—you'll pass both to initialize() during app bootstrap. The base URL is the host we provisioned for your environment (example: https://hawcx-api.hawcx.com). Do not append /hc_auth; the native SDK adds all endpoint paths automatically.

The Podspec included in the package automatically embeds the latest Hawcx framework; no manual framework copying is required. CocoaPods will pick up the right pod when you run pod install.

1. Install the package: npm install @hawcx/[email protected].
2. Ensure your Android project targets minSdkVersion 26 or higher.
3. Add the Hawcx Maven repository so Gradle can download the native SDK (no more local .aar copies):

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://raw.githubusercontent.com/hawcx/hawcx_android_sdk/main/maven")
    }
  }
}

repositories {
  google()
  mavenCentral()
  maven { url "https://raw.githubusercontent.com/hawcx/hawcx_android_sdk/main/maven" }
}

dependencies {
  api "api.hawcx:hawcx:5.1.0"
  // ...existing dependencies
}

• If your project still contains android/libs/hawcx-*.aar or flatDir { dirs 'libs' }, remove them—Gradle now resolves the SDK entirely through Maven.

4. Sync/clean once so Gradle resolves the dependency:

cd android && ./gradlew clean assembleDebug --refresh-dependencies

5. Rebuild with npm run android (or Android Studio). React Native autolinking registers the Kotlin module automatically—no manual edits to MainApplication are needed.
6. Keep the same Hawcx project API key and tenant base URL available; the TypeScript initialization call is identical on Android.

import { useEffect } from 'react';
import { initialize, addAuthListener } from '@hawcx/react-native-sdk';

export async function bootstrapHawcx() {
  await initialize({
    projectApiKey: 'YOUR_API_KEY',
    baseUrl: 'https://your-tenant.hawcx-api.hawcx.com',
  });

  const subscription = addAuthListener((event) => {
    if (event.type === 'auth_error') {
      console.warn('Hawcx error', event.payload);
    }
  });

  return () => subscription.remove();
}

Call bootstrapHawcx() once (e.g., inside your root provider). All subsequent API calls—authenticate, hooks, or helper clients—reuse the same native singleton.

The same initialization code runs on Android. The Kotlin bridge proxies every call to the Hawcx Android SDK, so call initialize() once during app bootstrap (e.g., inside your root component or Redux saga), passing the same projectApiKey + baseUrl, and reuse hooks/listeners across screens just like iOS.