RootPush CLI

A CLI tool for bundling and uploading React Native updates. It also supports Expo projects.

Installation

npm i -g @rootpush/cli

Authentication

You have two options to authenticate with RootPush:

Option 1: Login Command (Recommended)

rootpush login

This will:

1. Guide you to https://rootpush.com/org/account/ to generate a token
2. Securely store your credentials
3. Validate your authentication

To logout:

rootpush logout

Option 2: Environment Variable

You can also use an environment variable if you prefer:

export ROOTPUSH_AUTH_TOKEN=your_token_here

Usage

1. Install RootPush Updates in your project:

rootpush install --product updates

2. Deploy an update:

rootpush updates --app 0194793c-fca2-71f0-af50-6075edd3c1c9

Commands

login

Log in to RootPush and store your credentials securely.

logout

Log out and remove stored credentials.

install

Install and configure RootPush products in your React Native project.

Options:

• --product <name> (required): Product name

updates

Bundle and upload a new update of your React Native app.

Options:

• --app <id> (required): Your app identifier (available in app settings)
• --target <version>: Target binary version (will auto-detect if not provided)
• --branch <branch>: Target branch (will use current git branch if not provided)
• --hermesEnabled: Enable/disable Hermes (defaults to true)

Run rootpush updates -h to see all available options.

Project Structure

The CLI tool supports both Expo and bare React Native projects. It automatically:

• Detects project type (Expo or bare)
• Detects current branch
• Detects target version
• Handles Hermes compilation when enabled

Security

When using the login command, your authentication token is stored securely using:

• Keychain on macOS
• Credential Manager on Windows
• Encrypted configuration on Linux

Contributing

See CONTRIBUTING.md for guidelines on contributing to this project.