github-featured/vercel-labs--zero-native

Files

T

History

Chris Tate b47111069c Native SDK: the complete toolkit for building native desktop apps (#67 )

zero-native becomes the Native SDK. Apps are authored as native markup plus Zig on a deterministic runtime and rendered by the toolkit's own engine into real OS windows — no browser, no WebView, no interpreter in the binary.

- Desktop is complete on macOS, Windows, and Linux: native rendering with per-platform titlebar fidelity, audio playback with streaming, a verified track cache, and real spectrum analysis, native context menus, packaging with sealed code signing, and a deterministic automation and record-replay story.
- Experimental iOS and Android host tiers ship behind the same app manifest: simulator and emulator dev loops, archive-ready packaging, real platform tab bars and push navigation, with embedding over the C ABI underneath.
- The docs site, component catalog, theme packs, showcase apps, and CHANGELOG carry the full account.

2026-07-08 18:51:43 -05:00

src

Native SDK: the complete toolkit for building native desktop apps (#67 )

2026-07-08 18:51:43 -05:00

app.zon

Native SDK: the complete toolkit for building native desktop apps (#67 )

2026-07-08 18:51:43 -05:00

README.md

Native SDK: the complete toolkit for building native desktop apps (#67 )

2026-07-08 18:51:43 -05:00

README.md

Native SDK split-collapse example

The smallest honest pane-collapse animation harness: a two-pane split whose sidebar collapses and expands over 180 ms, built to measure frame pacing during a layout tween and to demonstrate the runtime layout-tween primitive against the manual idiom it replaces.

Three driving modes, selected by environment variable:

Default (runtime tween): the model owns only the resting collapsed flag; the layout_tweens hook declares the split's target fraction and the runtime eases the rendered fraction toward it, one step per presented frame — no per-frame Msgs, and reduced-motion appearances snap.
SPLIT_COLLAPSE_MARKUP=1 (markup tween): the same primitive declared entirely in markup — resize-duration="180" (and resize-easing) on the split element in src/split_collapse.native makes the bound value a tween target, so the view file is the whole animation and no Zig hook exists.
SPLIT_COLLAPSE_MANUAL=1 (manual ticks): the historical idiom — on_frame returns a tick Msg carrying the presented frame's timestamp, update eases the fraction, and every tick is a full rebuild.

Every tween step logs its arrival cadence on stderr (tween-frame dt_ms=... in manual mode, tween-echo fraction=... in the runtime and markup modes), so a driver can count the visible steps of the 180 ms collapse and read the real deltas between frames.

Extra knobs:

SPLIT_COLLAPSE_AUTO_MS=<interval> arms a repeating auto-toggle so the tween runs without automation.
SPLIT_COLLAPSE_WEB=1 snaps a live webview to the content pane, so the tween reflows real web content beside the collapsing sidebar.

Run with the macOS system backend:

native dev

Run the model-contract tests headless:

native test -Dplatform=null