Skip to Content
CLI ReferenceBuild Commands

Build Commands

norrix build

Build your NativeScript app in the cloud.

Synopsis

norrix build [platform] [buildType] [distribution] [options]

Arguments

ArgumentDescription
platformTarget platform: ios, android, or visionos
buildTypeBuild type: debug or release
distributioniOS distribution type: appstore, adhoc, or enterprise

If arguments are omitted in interactive mode, you’ll be prompted to select them.

Options

FlagDescription
-p, --project <name>Project name (for Nx workspace builds from root)
-c, --config <config>Configuration/deployment target (e.g., prod, stg, dev)
--org <orgId>Target organization ID
-t, --team-id <id>Apple Developer Team ID (for iOS signing)
-v, --version <version>App version (e.g., 1.0.0)
-b, --build-number <number>Build number (auto-incremented if omitted)
-n, --non-interactiveRun without prompts (use defaults/config file)

iOS Signing Options

FlagDescription
--p12 <path>Path to iOS .p12 certificate
--p12-password <password>Password for .p12 certificate
--profile <path>Path to iOS .mobileprovision file
--asc-key-id <id>App Store Connect API Key ID
--asc-issuer-id <id>App Store Connect Issuer ID
--asc-key <path>Path to App Store Connect .p8 private key

Android Options

FlagDescription
--apkBuild APK instead of AAB (overrides distributionType)
--aabBuild AAB for Android (default for appstore)

Examples

iOS Builds

# iOS debug build norrix build ios debug # iOS release for App Store norrix build ios release appstore # iOS enterprise distribution with Team ID norrix build ios release enterprise --team-id ABC123XYZ0 # iOS with manual certificates norrix build ios release appstore \ --p12 ./certs/dist.p12 \ --p12-password $P12_PASSWORD \ --profile ./profiles/AppStore.mobileprovision # iOS with App Store Connect API norrix build ios release appstore \ --asc-key-id ABC123DEF4 \ --asc-issuer-id 12345678-1234-1234-1234-123456789012 \ --asc-key ./AuthKey.p8

Android Builds

# Android debug build norrix build android debug # Android release AAB (default) norrix build android release # Android release APK norrix build android release --apk

visionOS Builds

# visionOS release build norrix build visionos release appstore

Nx Workspace Builds

# Build specific project from workspace root norrix build ios release --project my-mobile-app # With configuration norrix build ios release --project my-app --config prod

CI/CD Builds

# Non-interactive mode for CI norrix build ios release -n --org $ORG_ID

Build Number Auto-Increment

If --build-number isn’t provided, Norrix automatically increments the build number based on the highest existing build number for that project and platform.


Alternative: Web Interface

You can also kick off builds directly from the Norrix dashboard without using the CLI.

When to Use the Web Interface

  • Quick one-off builds without CLI setup
  • Team members who don’t have the CLI installed
  • Building from a machine without a local development environment

How It Works

  1. Navigate to /build in the Norrix dashboard
  2. Zip your NativeScript project locally
  3. Upload the zip file (uploads directly to S3)
  4. Fill in platform, configuration, and signing credentials
  5. Submit the build

The web form supports all the same options as the CLI:

  • iOS, Android, and visionOS platforms
  • Debug and release configurations
  • Manual certificates or App Store Connect API signing
  • Android keystore configuration
  • Nx workspace project and configuration

See Web Interface for detailed instructions.


norrix build-status

Check the status of a build.

Synopsis

norrix build-status <buildId> [options]

Arguments

ArgumentDescription
buildIdBuild ID to check (e.g., build-1234567890)

Options

FlagDescription
--org <orgId>Target organization ID

Example

norrix build-status build-1234567890

Build Status Values

StatusDescription
scheduledBuild job has been scheduled
buildingBuild is in progress
successBuild completed successfully
failedBuild failed

Output

The command outputs build details including:

  • Build ID
  • Project name
  • Platform
  • Configuration
  • Status
  • Build artifacts path (when complete)
  • Error message (if failed)