App Management

Creating an App

Before you can deploy any updates, you need to register an app with the Turbopush service using the following command:

npx turbopush app add <appName> --appSlug <appSlug>

The appSlug identifies your app in CLI commands and deployment keys. If omitted, it's derived from the app name.

iOS & Android

Create separate apps per platform (e.g., MyApp-iOS, MyApp-Android). Mixing platforms causes installation issues due to different bundle contents.

Every new app comes with Staging and Production deployments. The CLI outputs their deployment keys for SDK configuration.

Other commands:

npx turbopush app rm <appSlug>   # Delete app (use with caution)
npx turbopush app ls             # List all apps

Deployments

Deployments are release channels within an app. Default: Staging and Production.

npx turbopush deployment add <appSlug> <deploymentName>  # Create
npx turbopush deployment rm <appSlug> <deploymentName>   # Delete
npx turbopush deployment ls <appSlug> [-k]               # List (use -k to show keys)

Metrics

Metric	Description
Active	Users currently running this release
Total	All successful installs ever
Pending	Downloaded but not yet installed
Rollbacks	Automatic client rollbacks (crash detection)
Rollout	% of users eligible for this update
Disabled	If true, update isn't downloadable

"No installs recorded" means no telemetry received yet.