Getting Started with Patch Updates

Step-by-step guide to enable and use React Native Stallion's Patch Updates. Learn requirements, how to request access, and how to start using differential updates.

Getting Started with Patch Updates

Getting started with Patch Updates is straightforward. This guide walks you through the requirements, access request process, and how to start using Patch Updates.

Requirements

  • SDK Version: React Native Stallion SDK 2.4.0 or above
  • No Code Changes: Your existing codebase requires no modifications
  • Same Workflow: Continue using React Native Stallion exactly as you always have

SDK Requirement:

Patch Updates is available for React Native Stallion SDK version 2.4.0 and above. Make sure you're running the latest version. Check the SDK Installation guide if you need to update.

Requesting Access

Patch Updates is currently in beta and available on an invite-only basis. The feature is absolutely free while in beta.

How to Request Access

  1. Visit stalliontech.io/contact
  2. Request early access to Patch Updates
  3. Provide your organization name and use case
  4. Wait for approval

Beta Program:

Patch Updates is in beta and available to early adopters. Request access to start experiencing the most advanced OTA update technology available for React Native.

Using Patch Updates

Once you have access, Patch Updates works automatically—no additional configuration required.

Step 1: Upload Your Bundle

Upload your bundle as usual using the Stallion CLI:

npx stallion publish-bundle \
  --upload-path=<orgname>/<project-name>/<bucket-name> \
  --platform=<android/ios> \
  --release-note="Your release notes"

Step 2: Promote the Release

Promote the release through the Stallion Console:

  1. Navigate to your bucket
  2. Select the bundle you want to promote
  3. Click "Promote Bundle"
  4. Fill in the target app version and release notes
  5. Save the promotion

Step 3: Automatic Patch Generation

When you promote a release, the system automatically:

  • Detects the previous version
  • Generates an optimized patch containing only changes
  • Signs the patch for security
  • Distributes the patch to eligible users

Step 4: Users Receive Patches

  • Users on the previous version receive the patch update
  • Users on older versions or new installations receive full bundles
  • Patches download automatically in the background

Verifying Patch Updates

In the Console:

  1. Navigate to the Releases section
  2. Select your promoted release
  3. View the Patch Metrics:
    • Patch size vs full bundle size
    • Number of users receiving patches vs full bundles

Troubleshooting

Patch Not Generated

  • Ensure there's a previous release for the same app version
  • Verify you have access to Patch Updates
  • Confirm you're running SDK 2.4.0 or above

Users Not Receiving Patches

  • Users must be on the previous version to receive patches
  • Users must have SDK 2.4.0 or above
  • Verify patch was generated in the Console

Next Steps

Conclusion

Getting started with Patch Updates is simple—just request access and start promoting releases as usual. The system handles everything automatically.

Request early access to Patch Updates and start experiencing the benefits of 98% smaller updates.