Files

@native-sdk/cli

The command line for Native SDK: the complete toolkit for building native desktop applications.

Views are declarative markup in .native files, logic is plain Zig, and Native SDK's own engine draws every pixel into real OS windows — no browser, no WebView, no interpreter in the binary.

Install

npm install -g @native-sdk/cli

The install runs no scripts: the native binary arrives as a per-platform optional dependency (@native-sdk/cli-<platform>), and this package carries the SDK source your apps build against, so native init and native dev work offline after install. The pinned Zig toolchain is fetched into ~/.native/toolchains/ on first build unless a compatible zig is already on your PATH.

Use

native init my_app
cd my_app
native dev

A native window opens with a working counter. The scaffold is a native-rendered markup app with no build files — native dev|build|test own the build — and src/app.native hot-reloads while the app runs, keeping your state. native check validates every view in milliseconds without building.

When part of your product is the web, WebView surfaces coexist with the native canvas; web-frontend scaffolds (--frontend next, --frontend vite, and more) install their generated frontend dependencies automatically on first run.

Read the full guide at native-sdk.dev/quick-start.

Commands

Command Description
native init [path] [--frontend <native|next|vite|react|svelte|vue>] [--full] Scaffold a new Native SDK app
native dev [dir] Build and run the app (markup hot reload; managed frontend dev server when configured)
native build [dir] Build a ReleaseFast binary into zig-out/bin/
native test [dir] Run the app's test suite
native check [dir] Validate src/**.native markup and app.zon against the model contract
native markup check|lsp Check individual markup files, or serve diagnostics, completion, and hover to your editor
native eject [dir] Write an owned build.zig/build.zig.zon into the app
native doctor Check host environment, WebView, manifest, and CEF
native validate Validate app.zon against the manifest schema
native package Package the app for distribution
native bundle-assets Copy frontend assets into the build output
native automate Drive a running app: snapshots, widgets, assertions, screenshots, record/replay
native skills list|get <name> List or print the built-in AI agent skills
native version Print the native version

More

The full documentation is at native-sdk.dev — the app model, native UI authoring, components, testing, automation, capabilities, packaging, and platform support.

Native SDK is pre-1.0 and Apache-2.0 licensed; the source lives at github.com/vercel-labs/native.