Quickstart

A small native macOS app built with the Native SDK — no browser, no WebView. Install it in under a minute, and it tells you when an update is out.

Download latest ↓ Build from source

Requirements. macOS 11 or newer. The app is a single native binary — nothing else to install to run it.

Install & run

Download the .zip from the latest release.
Double-click the .zip to unzip it.
Right-click the app → Open (needed the first time, since the app isn't code-signed yet).

Prefer the terminal?

One line downloads, installs to /Applications, and opens it:

curl -fsSL https://raw.githubusercontent.com/quochuydev/native-desktop/main/install.sh | bash

Updates

The app checks automatically on launch and every 20 seconds. When a newer release exists, it shows “Update available: vX.Y.Z” in the bottom-left corner — the current version is always shown bottom-right.

To update, download the new release the same way. Releases are cut automatically with release-please.

Build from source

Install the Native SDK CLI, then:

npm install -g @native-sdk/cli

git clone https://github.com/quochuydev/native-desktop.git
cd native-desktop

native dev      # build and run (hot reload)
native check    # validate core + markup + app.zon
native build    # release binary

Logic lives in src/core.ts (Model / Msg / update), the view in src/app.native. Requires Node.js 22+ at build time; the shipped binary carries no JS runtime.

Next steps

Source & issues · Releasing · Auto-update design · Native SDK docs