네이티브 SDK는 TypeScript와 네이티브 마크업을 사용해 네이티브 데스크톱 애플리케이션을 구축하는 툴킷입니다. 이 툴킷은 앱 로직과 뷰를 네이티브 실행 파일로 컴파일하고 OS 창에서 인터페이스를 렌더링합니다. Zig 코어와 선택적 임베디드 웹 콘텐츠도 지원됩니다.

네이티브 SDK는 실험적입니다. 플랫폼 기능은 다양하며, 모바일 지원은 여전히 진화 중입니다. 현재 지원은 플랫폼 지원 매트릭스를 참조하세요.

퀵 스타트

24 이상 Node.js 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