Skip to main content

​
Get Started with Muta

Follow these steps to add beautiful, dynamic flows to your mobile app. Currently, we support React Native and Swift, with more SDKs coming soon.
Setting up for the first time? Use the Copy AI Context button (bottom right) to get comprehensive SDK documentation you can paste into Claude, Cursor, or other AI coding assistants for guided help.
  • React Native
  • Swift

​
Installation

Choose your package manager:
# Using npm
npm install @mutalabs/react-native-muta react-native-webview

# Using yarn
yarn add @mutalabs/react-native-muta react-native-webview
For React Native CLI projects, install iOS dependencies:
cd ios && pod install
Using Expo?
  • The pod install step is not required
  • You cannot use Expo Go - you must create a fresh development build
  • Follow the official Expo guide to create a development build: Creating Development Builds

​
Create Your First Flow

Design Your Flow

First, log in or sign up at Muta Dashboard. Then choose your path:
  1. Start from scratch:
    • Click the ”+” button next to Flows
    • Design your flow using drag & drop
    • Hit “Save” when you’re done
  2. Start with a template:
    • Navigate to Templates in the left panel
    • Select a template you like
    • Click “Create Flow” - the template becomes your base flow
    • Edit the flow to match your needs
    • Hit “Save” when you’re done

Create a Placement

  1. Click “Placements” in the left panel
  2. Click the ”+” button to create a placement
  3. Give it a memorable name
  4. Choose an ID (e.g., “welcome.flow”)
  5. Select the flow you want to display
  6. Click “Create”

Add to Your App

  1. Add the MutaRoot component to your app:
import { MutaRoot, Muta } from '@mutalabs/react-native-muta';

function App() {
  return (
    <>
      <MutaRoot apiKey="your-api-key" />
      {/* Your app content */}
    </>
  );
}
  1. Display your flow where needed:
Muta.displayPlacement({
  placementId: 'your-placement-id',
  bgColor: '#000000', // Match your first screen's background
  presentationType: 'fade' // 'slide' | 'fade' | 'none'
});
The bgColor should match your first screen’s background color for a seamless transition.

Test and Deploy

  1. Run your app in development mode
  2. Trigger your flow where implemented
  3. Verify the flow appears and works as expected
  1. Return to the Muta Dashboard
  2. Edit your flow
  3. Hit save - changes are ready instantly!
  4. Refresh your app to see the changes
Updates affect new app downloads - if you switch from Flow A to Flow B, users who download your app after the switch will see Flow B. Users currently in Flow A will complete their existing flow uninterrupted.

​
What’s Next?

Collect User Input

Learn how to gather text inputs and multiple choice responses from your users.

Track Analytics

Integrate with your analytics provider to measure flow performance.

Handle Errors

Implement proper error handling for a robust user experience.

API Reference

Explore the complete SDK API documentation.
Need help? We offer white glove support for SDK installation and implementation. Contact us anytime!
⌘I