@ingestia/react-native

React Native SDK for Ingestia — behavioral event analytics.

Requirements

• React Native 0.74+
• iOS 15+
• Android API 24+

Installation

npm install @ingestia/react-native
# or
yarn add @ingestia/react-native

iOS

cd ios && pod install

Android

No additional steps required.

Setup

Create a client and wrap your app with IngestiaProvider:

import { IngestiaClient, IngestiaProvider } from '@ingestia/react-native';

const client = new IngestiaClient({
  apiKey: 'your-api-key',
  endpoint: 'https://your-ingestia-backend:50051',
});

export default function App() {
  return (
    <IngestiaProvider client={client}>
      <YourApp />
    </IngestiaProvider>
  );
}

Usage

Use useIngestia() anywhere inside IngestiaProvider:

import { useIngestia } from '@ingestia/react-native';

function HomeScreen() {
  const { track, identify, initialize, flush, destroy } = useIngestia();

  useEffect(() => {
    initialize();
  }, []);

  return (
    <Button
      title="Buy"
      onPress={() => track('purchase_clicked', { item: 'pro_plan' })}
    />
  );
}

API

IngestiaClient

new IngestiaClient(config: IngestiaConfig)

Option	Type	Default	Description
apiKey	string	required	Project API key
endpoint	string	http://localhost:50051	Backend gRPC endpoint
flushInterval	number	5000	Auto-flush interval in ms
batchSize	number	10	Events per batch before auto-flush

useIngestia()

Returns an object with the following methods:

Method	Signature	Description
initialize	() => Promise<void>	Load or generate anonymous user ID, send identify event
track	(event: string, properties?: Record<string, unknown>) => void	Queue a track event
identify	(userId: string, traits?: Record<string, unknown>) => void	Queue an identify event
flush	() => Promise<void>	Flush queued events immediately
destroy	() => void	Stop auto-flush timer

useIngestiaClient()

Returns the raw IngestiaClient instance for direct access:

import { useIngestiaClient } from '@ingestia/react-native';

const client = useIngestiaClient();

License

MIT