Package Distribution
The Native SDK is distributed as a Zig codebase plus npm packages for the CLI. The former primitive modules (geometry, assets, app_dirs, trace, app_manifest, diagnostics, and platform_info) are now internal Native SDK modules and are available through the main native_sdk import instead of standalone Zig packages.
Install
npm install -g @native-sdk/cliSee the Quick Start for the full flow.
How the npm install works
@native-sdk/cli installs the native command and declares one optional dependency per supported platform; your package manager resolves exactly the one that matches your machine, so the install runs no scripts and downloads a single prebuilt binary.
The same package carries the SDK source your apps build against, so native init and native dev work offline right after install — the CLI resolves the SDK from its own install location, and NATIVE_SDK_PATH overrides it when you want to build against a checkout.
The only thing fetched later is the pinned Zig toolchain: on first native dev|build|test, the CLI uses a compatible zig from your PATH or offers to download the pinned version into ~/.native/toolchains/ (checksum-verified).
All packages share one version, and the binary packages are pinned exactly, so a given @native-sdk/cli version always runs the binary built from the same commit.
Packages
| Package | Description |
|---|---|
@native-sdk/cli | Installs the native command, carries the SDK source apps build against, and selects the right binary package for your platform |
@native-sdk/cli-darwin-arm64 | Prebuilt native binary for macOS on Apple silicon |
@native-sdk/cli-darwin-x64 | Prebuilt native binary for macOS on Intel |
@native-sdk/cli-linux-arm64-gnu | Prebuilt native binary for Linux arm64 (glibc) |
@native-sdk/cli-linux-x64-gnu | Prebuilt native binary for Linux x64 (glibc) |
@native-sdk/cli-linux-arm64-musl | Prebuilt native binary for Linux arm64 (musl) |
@native-sdk/cli-linux-x64-musl | Prebuilt native binary for Linux x64 (musl) |
@native-sdk/cli-win32-x64 | Prebuilt native binary for Windows x64 |
@native-sdk/cli-win32-arm64 | Prebuilt native binary for Windows on ARM |
The wrapper scripts and packaging metadata live in packages/native-sdk/ in the repository, and every binary is also published as a checksummed GitHub release asset for use outside npm.