Native SDKは、TypeScriptとNativeマークアップを用いたネイティブデスクトップアプリケーションを構築するためのツールキットです。このツールキットは、アプリのロジックやビューをネイティブ実行ファイルにコンパイルし、OSウィンドウでインターフェースをレンダリングします。Zigコアやオプションの組み込みウェブコンテンツもサポートされています。

ネイティブSDKは実験的な段階です。プラットフォームの機能は様々で、モバイルサポートも進化中です。現在のサポートについてはプラットフォームサポートマトリックスをご覧ください。

クイックスタート

Node.js 24以降のCLIをインストールしてください:

アプリを作成して実行する:

生成されたプロジェクトはカウンターアプリを開き、以下が含まれます:

• src/core.ts:アプリのモデル、メッセージ、更新機能。
• src/app.native:レイアウト、バインディング、メッセージ発送を含むビュー。
• app.json:アプリの識別、ウィンドウ、権限、セキュリティ設定。

native devはマークアップの変更を監視し、アプリの状態を保持しながらビューを更新します。TypeScriptのコア変更はアプリを再構築し再起動します。native dev --coreを使ってウィンドウを開かずにNode.jsのコアロジックを実行、native checkでプロジェクトを検証し、native buildでリリースバイナリを作成します。

CLIはあなたのPATHの互換性あるZigツールチェーンを使うか、ピン留めされたバージョンをダウンロードできます。

Native SDK

Native SDK is a toolkit for building native desktop applications with TypeScript and Native markup. The toolkit compiles app logic and views into a native executable and renders the interface in OS windows. Zig cores and optional embedded web content are also supported.

Native SDK is experimental. Platform capabilities vary, and mobile support is still evolving. See the platform support matrix for current support.

Quick start

Install the CLI with Node.js 24 or later:

npm install -g @native-sdk/cli

Create and run an app:

native init my_app
cd my_app
native dev

The generated project opens a counter app and includes:

• src/core.ts: the app’s model, messages, and update function.
• src/app.native: the view, with layout, bindings, and message dispatch.
• app.json: app identity, windows, permissions, and security settings.

native dev watches markup changes and updates the view while preserving app state. TypeScript core changes rebuild and restart the app. Use native dev --core to exercise core logic under Node.js without opening a window, native check to validate the project, and native build to create a release binary.

The CLI uses a compatible Zig toolchain from your PATH or offers to download the pinned version. See Quick Start for platform prerequisites and the complete workflow.

App model

Events dispatch typed messages to update, which returns the next model and any effects. The view derives its content from the model. Filesystem access, network requests, and other external work run through effects and TypeScript services.

App cores use a checked TypeScript subset and compile to native code. To write a Zig core instead, create the project with native init my_app --template zig-core. See App Model and TypeScript Cores.

Examples