Installation

Building for the web?

This page covers the React Native SDK. For web apps (React, Vue, Svelte, or vanilla), see the Web SDK.

SDK

# npm
npm install @appilots/sdk

# yarn
yarn add @appilots/sdk

# pnpm
pnpm add @appilots/sdk

Peer dependencies

The SDK requires the following as peer dependencies:

{
  "react": ">=18.0.0",
  "react-native": ">=0.72.0",
  "react-native-safe-area-context": ">=4.0.0",
  "react-native-svg": ">=13.0.0"
}

react-native-safe-area-context and react-native-svg are used by the chat UI's layout and iconography — most React Native apps already have them installed, but add them if you don't.

react-native-safe-area-context is not just an install: AppilotsChat calls useSafeAreaInsets(), so a SafeAreaProvider has to be rendered above it. See Quick Start, Step 2.

MCP Generator CLI

# Global (recommended)
npm install -g @appilots/cli

# Or use with npx
npx appilots sync

TypeScript support

Both packages ship with full TypeScript declarations. No additional @types/* packages needed.