Find the Native SDK guidance needed to build desktop apps with TypeScript and Native markup, a declarative UI format. Covers getting started and locating instructions for interface development, packaging, embedded web content, and running-app automation.
中文简介正在准备中。当前显示英语简介。
Discovery skill for the Native SDK, the complete toolkit for building native desktop applications. Apps are authored in TypeScript + declarative Native markup (.native) by default and compiled to native code with no JS runtime in the binary; Zig cores are an explicit alternative, and WebViews are the optional web-content path. Use when the user asks what the Native SDK is, how to build a Native SDK app, author native UI, scaffold an app, configure app.json or legacy app.zon, add bridge commands, embed web content, package an app, test a running app, or automate a Native SDK app.
安装前可以查看交给 AI 代理的指令内容。
The Native SDK is the complete toolkit for building native desktop applications. The primary authoring path is TypeScript app logic in src/core.ts plus declarative Native markup in .native files. The TypeScript core is checked and compiled ahead of time to native code, so the shipped binary contains no browser, WebView, JS runtime, or interpreter. Zig is how the toolkit itself works and is a first-class, explicitly chosen app-core alternative (--template zig-core); it is not the default inferred from the SDK's implementation. Every app embeds a deterministic automation server, so agents can snapshot, drive, and screenshot the running window. Desktop is the mature surface (macOS deepest, Linux and Windows exercised in CI); mobile embedding is experimental. WebView surfaces coexist as the optional path for embedding web content or hosting an existing web frontend.
This file is a discovery stub for agents that installed the Native SDK once with a skills installer such as npx skills add native-sdk. Before implementing or explaining Native SDK app work, use the installed CLI to discover and load the current skill content:
native skills list
native skills get core
native skills get native-ui
native skills get ts-core
Use native skills get core for initial orientation. For the default app-authoring path, load both native-ui (views, bindings, the app loop) and ts-core (the TypeScript subset, effects, subscriptions, and modules) before implementing. Load ts-services too when the tree has src/services/ or ordinary TypeScript needs filesystem/process/JSON/regex/Map/Date/class work behind Cmd.request. Use native skills get core --full when work reaches lower-level runtime wiring, WebViews, bridge/security, native capabilities, packaging, or debugging. Use native skills get automation when testing a running app, taking snapshots, requesting reloads, or using the built-in automation server. Use native skills get zig only for an existing Zig core, a toolkit extension, SDK implementation work, or a Zig 0.16 compile error.
npm install -g @native-sdk/cli
native init my_app
cd my_app
native dev
native init my_app generates the primary three-file app: app.json, src/app.native (the markup view), and src/core.ts (Model, Msg, update). Existing app.zon manifests remain supported. Inspect the tree before editing an existing app and preserve the core language it already uses. src/main.zig means the app explicitly uses the Zig-core template; web-frontend shells additionally carry frontend/ and usually owned build/runtime wiring.
还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Test running Native SDK apps by checking readiness, inspecting windows, driving widgets, and checking communication between JavaScript and Zig. Includes repeatable canvas screenshots and basic integration tests to confirm that key app features work.
中文简介正在准备中。当前显示英语简介。
Build and modify Native SDK apps with guidance on project structure, configuration, native features, packaging, and testing. Explains the default TypeScript and Native markup approach, plus WebViews, embedded web interfaces, and their permissions.
中文简介正在准备中。当前显示英语简介。
Create Native SDK interfaces with .native markup, connecting layouts, widgets, and user actions to app state and messages. Covers TypeScript core integration, explicit Zig alternatives, menus, scrolling, embedded web panes, and interface verification.
中文简介正在准备中。当前显示英语简介。
Build Native SDK app logic in TypeScript using explicit state, messages, and update functions. Explains the supported language subset, compiler diagnostics, module organization, and tests for logic that compiles directly into native code.
中文简介正在准备中。当前显示英语简介。
Guides development of Native SDK TypeScript services for file access, network requests, and other work outside the deterministic core. Covers typed calls, pinned npm dependencies, streaming, cancellation, replay, and process or thread execution.
中文简介正在准备中。当前显示英语简介。
Fix Native SDK build failures caused by older Zig APIs. Organized by compiler error, this guide shows Zig 0.16 patterns for file access, output, lists, processes, environment variables, clocks, networking, and build configuration.
中文简介正在准备中。当前显示英语简介。