> ## Documentation Index
> Fetch the complete documentation index at: https://docu.truemetrics.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native Integration

> Start the integration in less than 5 minutes.

You can find the detailed inscruption
[here](https://github.com/TRUE-Metrics-io/truemetrics_android_demo_react_app_p)

## Prerequisites

* Node.js (v18 or later)
* Java Development Kit (JDK) 17
* Android Studio
* Android SDK Platform Tools
* React Native CLI

## Setup

1. Clone the repository:

```bash theme={null}
git clone https://github.com/TRUE-Metrics-io/truemetrics_android_demo_react_app_p
cd truemetrics_android_demo_react_app_p
```

2. Install dependencies:

```bash theme={null}
npm install
```

3. If needed, configure Android SDK path in your environment:

```bash theme={null}
# Add to your ~/.bashrc or ~/.zshrc
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
```

4. Run the application:

```bash theme={null}
npm run android
```

or

```
npx react-native start
```

## Usage

### SDK Initialization

1. Launch the app and enter your Truemetrics SDK API key in the input field

### Recording Management

Once initialized, you can:

* Start recording by tapping "Start recording"
* Stop recording by tapping "Stop recording"
* View current SDK state at the top of the screen
* Monitor any SDK errors that appear below the state

### Metadata Logging

When the SDK is initialized:

1. Tap "Log metadata"
2. Enter key and value in the respective fields
3. Tap "Log metadata" to save

### Permissions

The app will request the following permissions as needed:

* Phone state
* Activity recognition
* Location (both foreground and background)

## Project Structure

* `App.tsx`: Main application component
* `HomeScreen`: Primary screen for SDK control
* `LogMetadataScreen`: Screen for metadata management
* Android native module integration for Truemetrics SDK

## SDK States

The application handles the following SDK states:

* `UNINITIALIZED`: Uninitialized state
* `INITIALIZED`: SDK is ready for use
* `RECORDING_IN_PROGRESS`: Currently recording
* `RECORDING_STOPPED`: Recording has been stopped

## Error Handling

* SDK errors are displayed in red below the status
* Errors include both error codes and messages from the SDK

## Dependencies

* React Native
* @react-navigation/native
* @react-navigation/native-stack
* Truemetrics SDK for Android