App Management
Create and manage your Turbopush apps and deployments using the CLI.
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>yarn turbopush app add <appName> --appSlug <appSlug>pnpm 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.
Delete App
npx turbopush app rm <appSlug>yarn turbopush app rm <appSlug>pnpm turbopush app rm <appSlug>List All Apps
npx turbopush app lsyarn turbopush app lspnpm turbopush app lsDeployments
Deployments are release channels within an app. Default: Staging and Production.
Create Deployment
npx turbopush deployment add <appSlug> <deploymentName>yarn turbopush deployment add <appSlug> <deploymentName>pnpm turbopush deployment add <appSlug> <deploymentName>Delete Deployment
npx turbopush deployment rm <appSlug> <deploymentName>yarn turbopush deployment rm <appSlug> <deploymentName>pnpm turbopush deployment rm <appSlug> <deploymentName>List Deployments
Use -k to show deployment keys.
npx turbopush deployment ls <appSlug> -kyarn turbopush deployment ls <appSlug> -kpnpm turbopush deployment ls <appSlug> -kMetrics
| 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.
How is this guide?