Build Commands
norrix build
Build your NativeScript app in the cloud.
Synopsis
norrix build [platform] [buildType] [distribution] [options]Arguments
| Argument | Description |
|---|---|
platform | Target platform: ios, android, or visionos |
buildType | Build type: debug or release |
distribution | iOS distribution type: appstore, adhoc, or enterprise |
If arguments are omitted in interactive mode, you’ll be prompted to select them.
Options
| Flag | Description |
|---|---|
-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-interactive | Run without prompts (use defaults/config file) |
iOS Signing Options
| Flag | Description |
|---|---|
--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
| Flag | Description |
|---|---|
--apk | Build APK instead of AAB (overrides distributionType) |
--aab | Build 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.p8Android Builds
# Android debug build
norrix build android debug
# Android release AAB (default)
norrix build android release
# Android release APK
norrix build android release --apkvisionOS Builds
# visionOS release build
norrix build visionos release appstoreNx 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 prodCI/CD Builds
# Non-interactive mode for CI
norrix build ios release -n --org $ORG_IDBuild 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
- Navigate to
/buildin the Norrix dashboard - Zip your NativeScript project locally
- Upload the zip file (uploads directly to S3)
- Fill in platform, configuration, and signing credentials
- 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
| Argument | Description |
|---|---|
buildId | Build ID to check (e.g., build-1234567890) |
Options
| Flag | Description |
|---|---|
--org <orgId> | Target organization ID |
Example
norrix build-status build-1234567890Build Status Values
| Status | Description |
|---|---|
scheduled | Build job has been scheduled |
building | Build is in progress |
success | Build completed successfully |
failed | Build failed |
Output
The command outputs build details including:
- Build ID
- Project name
- Platform
- Configuration
- Status
- Build artifacts path (when complete)
- Error message (if failed)