Skip to main content

5-Minute Quickstart

Get from zero to a live deployment in 5 minutes. This is the condensed version -- see the full Quick Start guide for native setup code and troubleshooting.

Native setup required

This summary skips the native entry point changes (AppDelegate, MainApplication) that are required for OTA updates to work. Follow the full Quick Start or Installation guide for complete native setup.

Step 1: Install the CLI​

npm install -g @swiftpatch/cli

Step 2: Log In​

swiftpatch login

Step 3: Install the SDK​

npm install @swiftpatch/react-native
cd ios && pod install && cd ..

Step 4: Wrap Your App​

App.tsx
import { withSwiftPatch } from '@swiftpatch/react-native';

function App() {
  return <YourApp />;
}

export default withSwiftPatch(App);

Step 5: Add Your App ID​

iOS -- ios/YourApp/Info.plist:

<key>SwiftPatchAppId</key>
<string>YOUR_APP_ID</string>

Android -- android/app/src/main/res/values/strings.xml:

<string name="SwiftPatchAppId">YOUR_APP_ID</string>
info

Get your App ID from the dashboard after creating an app. You also need to update your native entry points to load SwiftPatch bundles -- see the full installation guide.

Step 6: Deploy​

swiftpatch init
swiftpatch deploy -p ios --hermes
Always pass --hermes if your app uses Hermes

React Native 0.70+ enables Hermes by default. Deploying without --hermes causes a crash loop.

You're all set. Users get the update on next app launch.

Need more detail?