Update Commands

norrix update

Publish over-the-air (OTA) updates to deployed apps.

Synopsis

norrix update [platform] [version] [options]

Arguments

Options

How OTA Updates Work

1. The CLI bundles your JavaScript, CSS, and assets
2. The bundle is uploaded to Norrix storage
3. Devices running your app check for updates on launch
4. Compatible updates are downloaded and applied automatically
5. The update takes effect on the next app restart

Examples

Basic Updates

# Publish iOS update
norrix update ios 1.0.1
 
# Publish Android update
norrix update android 1.0.1
 
# Publish visionOS update
norrix update visionos 1.0.1

With App ID

# Specify bundle ID explicitly
norrix update ios 1.0.1 --app-id com.example.myapp

With Build Number

# Set explicit build number
norrix update ios 1.0.1 --build-number 42

Nx Workspace Updates

# Update specific project from workspace root
norrix update ios 1.0.1 --project my-mobile-app
 
# With configuration
norrix update ios 1.0.1 --project my-app --config prod

CI/CD Updates

# Non-interactive mode for CI
norrix update ios 1.0.1 -n --org $ORG_ID

What Can Be Updated

✅ Can be updated via OTA:

• JavaScript/TypeScript code
• CSS/SCSS styles
• Assets (images, fonts, etc.)
• Non-native npm packages

❌ Requires a new store build:

• NativeScript platform version changes
• Native plugin version changes
• App_Resources folder contents
• Custom native code (NativeSource)

See OTA Compatibility for details.

Alternative: Web Interface

You can also publish OTA updates directly from the Norrix dashboard.

When to Use the Web Interface

• Quick updates without CLI setup
• Team members who don’t have the CLI installed
• Publishing from any browser-equipped device

How It Works

1. Navigate to /update in the Norrix dashboard
2. Build your JavaScript bundle locally using NativeScript CLI
3. Zip the compiled bundle files
4. Upload the zip file (uploads directly to S3)
5. Fill in app ID, platform, version, and optional settings
6. Add release notes if desired
7. Publish the update

The web form supports:

• iOS, Android, and visionOS platforms
• Version and build number configuration
• Nx workspace project and configuration
• Release notes

See Web Interface for detailed instructions.

norrix update-status

Check the status of an update.

Synopsis

norrix update-status <updateId> [options]

Arguments

Options

Example

norrix update-status update-1234567890

Update Status Values

Output

The command outputs update details including:

• Update ID
• App ID (bundle ID)
• Platform
• Version
• Build Number
• Status
• Release notes
• Error message (if failed)