native
Toolkit for building native desktop apps
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/vercel-labs-native)HTML
<a href="/listings/vercel-labs-native"><img src="/api/listings/vercel-labs-native/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](https://native-sdk.dev/docs/quick-start) for platform prerequisites and the complete workflow.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 78 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Native SDK
- <p>
- <a href="https://vercel.com/labs#active-experiments"><img alt="Vercel Labs Experiment" src="https://img.shields.io/badge/LABS-EXPERIMENT-0a0a0a.svg?style=for-the-badge&logo=Vercel&labelColor=000000" height="28"></a>
- <a href="https://www.npmjs.com/package/@native-sdk/cli"><img alt="npm version: @native-sdk/cli" src="https://img.shields.io/npm/v/%40native-sdk%2Fcli.svg?style=for-the-badge&labelColor=000000" height="28"></a>
- <a href="https://github.com/vercel-labs/native/blob/main/LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/github/license/vercel-labs/native.svg?style=for-the-badge&labelColor=000000" height="28"></a>
- <a href="https://www.npmjs.com/package/@native-sdk/cli"><img alt="npm downloads per month: @native-sdk/cli" src="https://img.shields.io/npm/dm/%40native-sdk%2Fcli.svg?style=for-the-badge&labelColor=000000&label=npm%20downloads" height="28"></a>
- </p>
- 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](https://native-sdk.dev/docs/platform-support) for current support.
- ## Quick start
- Install the CLI with Node.js 24 or later:
- ```bash
- npm install -g @native-sdk/cli
- ```
- Create and run an app:
- ```bash
- 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](https://native-sdk.dev/docs/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](https://native-sdk.dev/docs/app-model) and [TypeScript Cores](https://native-sdk.dev/docs/typescript).
- ## Examples
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset=".github/assets/soundboard-dark.webp">
- <img src=".github/assets/soundboard-light.webp" alt="The Soundboard example app rendered by the Native SDK engine: a music library with album cover art, search, and a playback bar" width="100%">
- </picture>
- The Soundboard example rendered by the Native SDK engine. More apps are in [examples/](./examples):
- - [Chatbot](./examples/chatbot): streaming responses, text editing, and TypeScript effects.
- - [Soundboard](./examples/soundboard): audio playback, search, assets, and context menus.
- - [System monitor](./examples/system-monitor): subprocess effects, tables, charts, and timers.
- - [Calculator](./examples/calculator): markup, keyboard input, and theming.
- See the [example catalog](./examples/README.md) for additional apps and their authoring languages.
- ## Documentation
- - [Quick Start](https://native-sdk.dev/docs/quick-start): installation and your first app.
- - [Native UI](https://native-sdk.dev/docs/native-ui): markup, layout, and bindings.
- - [Components](https://native-sdk.dev/docs/components): the built-in component catalog.
- - [TypeScript Services](https://native-sdk.dev/docs/typescript/services): external work outside the core.
- - [Testing](https://native-sdk.dev/docs/testing): headless app tests and runtime integration.
- - [Automation](https://native-sdk.dev/docs/automation): inspect and drive a running app.
- - [Packaging](https://native-sdk.dev/docs/packaging): create distributable packages.
- ## Contributing
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for repository setup and local checks. For larger changes, open an issue to discuss the design first.
- ## License
- [Apache-2.0](./LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.