This guide takes you from an empty screen to a working chat launcher in your app. You will deploy the Mobile app profile, install the SDK, and render the launcher.

Prerequisites

  • react >= 18 and react-native >= 0.73
  • A teammate (or you) has configured an agent in the dashboard
  • The Mobile app deploy profile is set up, as described in the React Native deploy guide
1

Deploy the Mobile app profile

In the dashboard, open Deploy > Mobile app, configure the Content, Style, and AI tabs, then click Deploy and confirm the profile shows Live. The SDK loads all branding and copy from this profile at startup.
2

Copy your publishable key

On Deploy > Mobile app, open the Embed tab and copy the publishable key (prefix cpk_live_). This key is scoped to widget runtime calls and is safe to ship in app code.
3

Install the SDK

For local chat history, also install the optional storage package:
4

Render the launcher

5

Send a test message

Run your app, tap the launcher, and ask a question your agent’s knowledge can answer. The reply should be grounded in the documents your team uploaded.

What success looks like

  • The launcher opens with your configured welcome message, colors, and suggested prompts
  • A knowledge question returns a grounded answer
  • The conversation appears in the dashboard under Chat logs
The SDK connects to the Chatropic production host automatically. You do not configure an API host, and you should never embed workspace API keys or other server credentials in app code. The publishable key is the only credential the app needs.

Next steps

React Native SDK guide

Full-screen chat, signed-in users, and every prop.

Authentication & identity

Connect conversations to signed-in users.

Messages & sessions

How conversations persist across turns.

SDK reference

Components, props, and callbacks.