CLI Overview

The SwiftPatch CLI bundles your JavaScript, uploads it, and creates a live release -- all in one command.

Releases deployed via CLI appear instantly in the dashboard

Quick Start

npm install -g @swiftpatch/cli

swiftpatch login

swiftpatch deploy -p ios --hermes

First deploy?

Run swiftpatch init in your project root first. It creates a config file and links your project to an app in the dashboard.

Hermes is required for most apps

React Native enables Hermes by default since 0.70+. Always add --hermes to compile to bytecode before uploading.

Command	What it does
`swiftpatch deploy`	Bundle, upload, and release an OTA update
`swiftpatch init`	Set up SwiftPatch in your project
`swiftpatch login`	Authenticate via browser
`swiftpatch logout`	Clear stored credentials
`swiftpatch rollback`	Roll back the latest release on a channel
`swiftpatch doctor`	Diagnose configuration issues
`swiftpatch generate-key-pair`	Generate RSA keys for bundle signing
`swiftpatch ci-tokens create`	Generate a CI token for pipelines

info

See the full command reference for subcommands covering apps, releases, channels, and configuration.

swiftpatch login

Opens a browser login flow. Your session persists across terminal sessions.

export SWIFTPATCH_CI_TOKEN=sp_ci_your-token

Or pass it directly:

swiftpatch deploy -p android --hermes --ci-token sp_ci_your-token

Generate tokens with swiftpatch ci-tokens create or from App Settings > API Keys in the dashboard.

tip

Each CI token is scoped to one app, limiting the impact if a token is exposed.