@expofp/react-native-efp-crowdconnected

React Native Turbo Module for CrowdConnected location tracking and indoor positioning services. Provides cross-platform access to GPS, IPS (Indoor Positioning System), and Bluetooth-based positioning on iOS and Android.

Features

• 📍 Multi-positioning support: GPS, Indoor Positioning (IPS), and Bluetooth
• 📱 Cross-platform: Native iOS (Swift) and Android (Kotlin) implementations
• ⚡ React Native New Architecture: Built as a Turbo Module for optimal performance
• 🔔 Event-based: Real-time location updates via event listeners
• 🔄 Background support: Optional background location updates
• 🎯 Heading tracking: Compass/bearing information
• 📦 TypeScript first: Full type safety with generated type definitions

Requirements

• React Native 0.71+
• React 18+
• iOS 12.0+ (CrowdConnected SDK v2.2.1)
• Android 7+ (API 24+)

Installation

npm install @expofp/react-native-efp-crowdconnected
# or
yarn add @expofp/react-native-efp-crowdconnected

iOS

cd ios && pod install

Android

No additional setup required. CocoaPods/Gradle will handle dependencies.

Quick Start

import { CrowdConnectedLocationProvider } from '@expofp/react-native-efp-crowdconnected';

// Initialize
await CrowdConnectedLocationProvider.setup({
  appKey: 'your-app-key',
  token: 'your-token',
  secret: 'your-secret',
  navigationType: 'all', // 'all' | 'GEO' | 'IPS'
  isBackgroundUpdateEnabled: false,
  isBluetoothEnabled: true,
  isHeadingEnabled: true,
});

// Listen to location updates
const unsubscribe = CrowdConnectedLocationProvider.onLocationChange((position) => {
  console.log('Location:', position);
  // { lat: number, lng: number, x?: number, y?: number, z?: string | number, angle?: number }
});

// Listen to errors
const unsubscribeError = CrowdConnectedLocationProvider.onError((error) => {
  console.error('Location error:', error);
});

// Start tracking
CrowdConnectedLocationProvider.startUpdatingLocation();

// Check if location tracking is active
const isUpdating = await CrowdConnectedLocationProvider.isLocationUpdating();

// Stop tracking
CrowdConnectedLocationProvider.stopUpdatingLocation();

// Cleanup
unsubscribe();
unsubscribeError();

API Reference

setup(settings: ExpoFpLocationSettings): Promise<string>

Initializes the CrowdConnected SDK with configuration.

Parameters:

• appKey - CrowdConnected application key
• token - Authentication token
• secret - Authentication secret
• navigationType - Positioning type: 'all' (GPS + IPS), 'GEO' (GPS only), 'IPS' (indoor only)
• isBackgroundUpdateEnabled - Enable background location updates
• isBluetoothEnabled - Enable Bluetooth-based positioning
• isHeadingEnabled - Enable compass/heading tracking
• aliases? - Custom location aliases (optional)

Returns: Promise resolving to initialization status

startUpdatingLocation(): void

Starts location tracking.

stopUpdatingLocation(): void

Stops location tracking.

isLocationUpdating(): Promise<boolean>

Checks if location tracking is currently active.

onLocationChange(callback: (position: ExpoFpPosition) => void): Unsubscribe

Subscribes to location updates.

Position object:

{
  lat?: number;      // Latitude
  lng?: number;      // Longitude
  x?: number;        // X coordinate (indoor)
  y?: number;        // Y coordinate (indoor)
  z?: string|number; // Z coordinate (floor/level)
  angle?: number;    // Heading in degrees
}

Returns: Unsubscribe function

onError(callback: (error: Error) => void): Unsubscribe

Subscribes to location errors.

Returns: Unsubscribe function

Development

Setup

yarn install
yarn prepare

Commands

• yarn lint - Run ESLint
• yarn typecheck - Check TypeScript types
• yarn test - Run Jest tests
• yarn example ios - Run iOS example app
• yarn example android - Run Android example app
• yarn clean - Clean build artifacts

Support

• 📖 Documentation
• 🐛 Report Issues
• 💬 Discussions