Skip to content

CLI Overview

The SilverOTA CLI is your primary tool for managing over-the-air updates from the command line. It provides an intuitive interface for authentication, project setup, and deployment management.

Available Commands

Authentication

login - Authenticate with your SilverOTA account

bash
silverbullet-ota login

Uses device authorization flow with browser-based confirmation. Stores credentials securely in your system keyring.

Learn more →

Project Management

project list - List all projects in your account

bash
silverbullet-ota project list

project init - Initialize SilverOTA in your React Native project

bash
silverbullet-ota project init

Interactive wizard that installs dependencies, creates configuration, and sets up deployment scripts.

Learn more →

Channel Management

channel - Display current active channel

bash
silverbullet-ota channel

Shows the configured channel for both iOS and Android platforms.

channel set <channel> - Set the active channel

bash
silverbullet-ota channel set staging

Updates native configuration files (Info.plist for iOS, strings.xml for Android).

Learn more →

Deployment

deploy - Deploy a new OTA update

bash
silverbullet-ota deploy --platform ios --target-app-version 1.0.0

Builds, packages, and uploads your JavaScript bundle and assets to the SilverOTA platform.

Learn more →

Command Structure

All commands follow the pattern:

bash
silverbullet-ota <command> [subcommand] [options]

Global Patterns

Interactive Mode: Most commands support an --interactive or -i flag for guided prompts:

bash
silverbullet-ota deploy --interactive

Help: Get help for any command:

bash
silverbullet-ota --help
silverbullet-ota deploy --help

Version: Check the CLI version:

bash
silverbullet-ota --version

Common Workflows

Initial Setup

bash
# 1. Authenticate
silverbullet-ota login

# 2. Initialize project
silverbullet-ota project init

# 3. Set channel
silverbullet-ota channel set production

# 4. Deploy first update
silverbullet-ota deploy --platform ios --target-app-version 1.0.0

Daily Development

bash
# Check current channel
silverbullet-ota channel

# Deploy to staging
silverbullet-ota deploy --platform ios --channel staging

# Deploy to production
npm run silverbullet:deploy:ios

Multi-Channel Workflow

bash
# Deploy to staging for testing
silverbullet-ota deploy --platform android --channel staging

# After testing, deploy to production
silverbullet-ota deploy --platform android --channel production

Configuration

The CLI uses an ota.config.ts file in your project root for configuration. This file is automatically created during project init.

Learn more about configuration →

Next Steps