# Native SDK Documentation

> Technical reference for the Native SDK toolkit: declarative .native markup, Zig app model, CLI workflows, automation, packaging, and platform hosts for building native desktop apps without a browser runtime.

This is a Grok-Wiki source-grounded repository documentation set. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown docs](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a.md)
- [Human interactive docs](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a)
- [GitHub repository](https://github.com/vercel-labs/native)

## Repository

- Repository: vercel-labs/native

- Generated: 2026-07-09T08:24:49.332Z
- Updated: 2026-07-09T08:25:27.078Z
- Runtime: Grok CLI
- Format: Documentation
- Pages: 27

## Pages

- [Overview](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/01-overview.md): What Native SDK exposes, who should use it, runtime assumptions, and the first docs routes from install to a running window.
- [Installation](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/02-installation.md): Install @native-sdk/cli, platform package layout, prerequisites, and success signals for a working native binary on each host OS.
- [Quickstart](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/03-quickstart.md): Create an app with native init, run native dev, edit .native markup and Zig Model/Msg/update, and verify the first live window.
- [Agent skills](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/04-agent-skills.md): Shipped skill packs for core authoring, Native UI, and automation, including how agents discover and apply them via the CLI.
- [App model](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/05-app-model.md): Model, Msg, and update loop wiring, hot reload boundaries, and how markup binds values without mutating state.
- [Native UI markup](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/06-native-ui-markup.md): Elements, attributes, flex layout, bindings, expressions, and editor/LSP support for .native views compiled into the binary.
- [State and data flow](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/07-state-and-data-flow.md): Derive-don't-store patterns, message dispatch, text editing paths, and effects as the only channel for side effects.
- [Theming](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/08-theming.md): Design tokens for color, radius, and typography, live theme re-resolution, chrome passes, and token-only restyles across apps.
- [Components](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/09-components.md): Built-in component catalog inventory, preview generation, eject workflows, and identity constraints for reusable widgets.
- [Windows and surfaces](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/10-windows-and-surfaces.md): Multi-window apps, native surface composition, OS window chrome, GPU surfaces, and host presentation on macOS and desktop peers.
- [Menus, dialogs, and tray](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/11-menus-dialogs-and-tray.md): App menus, context menus, system dialogs, tray status items, and how OS-owned UI coexists with engine-drawn widgets.
- [Commands and keyboard shortcuts](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/12-commands-and-keyboard-shortcuts.md): Single command routing across toolbar, menu, tray, shortcut, and bridge entry points with keyboard binding constraints.
- [Capabilities](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/13-capabilities.md): Guarded OS services for notifications, clipboard, credentials, dialogs, file drops, and effect-channel access boundaries.
- [Web engines](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/14-web-engines.md): WebView composition on desktop hosts, CEF tooling and hosts, engine flags, and when native-rendered UI coexists with web content.
- [Bridge and builtin commands](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/15-bridge-and-builtin-commands.md): Host-to-content bridge payloads, responses, async dispatch, builtin commands, and permission boundaries for WebView apps.
- [Frontend projects](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/16-frontend-projects.md): Managed React, Next, Svelte, and Vue shells, frontend asset pipeline, and native dev server integration for web frontends.
- [Embedded app](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/17-embedded-app.md): C embed ABI, host view controllers, mobile canvas libraries, and experimental iOS/Android host shims around the desktop-first runtime.
- [Automation](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/18-automation.md): Embedded automation server: accessibility snapshots, widget driving, record/replay, deterministic screenshots, and agent command surface.
- [Testing](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/19-testing.md): Full-loop UI tests via native test, headless truth drivers, effect tests, and frame-level verification without a display server dependency.
- [Testing in CI](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/20-testing-in-ci.md): CI workflows, gate scripts, platform truth drivers, and eval harness wiring for reproducible headless and hosted checks.
- [Packaging](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/21-packaging.md): From ReleaseFast binaries to distributable app bundles: assets, build graph outputs, and packaging layout expectations.
- [Code signing](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/22-code-signing.md): Codesign tooling, framework and native binary copy steps, and signing constraints for macOS and related package pipelines.
- [Updates and package distribution](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/23-updates-and-package-distribution.md): Update channels, npm multi-platform package layout, version sync checks, and binary distribution for @native-sdk packages.
- [CLI reference](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/24-cli-reference.md): native init, dev, check, test, build, automate, doctor, and skills commands with flags, outputs, and failure modes.
- [Runtime and effects](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/25-runtime-and-effects.md): Runtime API surface, effect kinds for spawn/fetch/file/audio/clipboard, cancellation, worker wakes, and deterministic frame limits.
- [Platform support and security](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/26-platform-support-and-security.md): Host capability matrix for macOS, Linux, Windows, and experimental mobile, plus bridge permission and capability security boundaries.
- [Contributing](https://grok-wiki.com/public/docs/vercel-labs-native-8ccc3580636a/pages/27-contributing.md): Local development setup, agent guidance, release and changelog merge process, and pre-1.0 contribution expectations.

## Source Files

- `.github/workflows/ci.yml`
- `AGENTS.md`
- `build.zig`
- `build/app.zig`
- `CHANGELOG.md`
- `CONTRIBUTING.md`
- `docs/src/app/dialogs/layout.tsx`
- `docs/src/app/embed/layout.tsx`
- `docs/src/app/frontend/layout.tsx`
- `docs/src/app/keyboard-shortcuts/layout.tsx`
- `docs/src/app/menus/layout.tsx`
- `docs/src/app/native-surfaces/layout.tsx`
- `docs/src/app/native-ui/layout.tsx`
- `docs/src/app/packages/layout.tsx`
- `docs/src/app/packaging/layout.tsx`
- `docs/src/app/packaging/signing/layout.tsx`
- `docs/src/app/quick-start/layout.tsx`
- `docs/src/app/runtime/layout.tsx`
- `docs/src/app/security/layout.tsx`
- `docs/src/app/skills/layout.tsx`
- `docs/src/app/state/layout.tsx`
- `docs/src/app/testing/ci/layout.tsx`
- `docs/src/app/testing/layout.tsx`
- `docs/src/app/theming/layout.tsx`
- `docs/src/app/tray/layout.tsx`
- `docs/src/app/updates/layout.tsx`
- `docs/src/app/web-engines/layout.tsx`
- `docs/src/app/windows/layout.tsx`
- `docs/src/components/component-preview.tsx`
- `docs/src/components/eject-section.tsx`
- `docs/src/components/home/install-toggle.tsx`
- `docs/src/lib/component-vocab.json`
- `docs/src/lib/components-pages.ts`
- `docs/src/lib/docs-navigation.ts`
- `editors/native-markup/extension.js`
- `editors/native-markup/README.md`
- `evals/README.md`
- `examples/browser/frontend/app.js`
- `examples/calculator/README.md`
- `examples/capabilities/build.zig`
- `examples/capabilities/README.md`
- `examples/command-app/build.zig`
- `examples/command-app/README.md`
- `examples/deck/README.md`
- `examples/deck/src/chrome.zig`
- `examples/effects-probe/README.md`
- `examples/hello/build.zig`
- `examples/ios/README.md`
- `examples/mobile-canvas/build.zig`
- `examples/next/build.zig`
- `examples/react/build.zig`
- `examples/README.md`
- `examples/soundboard/README.md`
- `examples/webview/README.md`
- `packages/native-sdk/npm/darwin-arm64/README.md`
- `packages/native-sdk/README.md`
- `packages/native-sdk/scripts/build-binaries.sh`
- `packages/native-sdk/scripts/check-version-sync.js`
- `packages/native-sdk/scripts/copy-framework.js`
- `packages/native-sdk/scripts/copy-native.js`
- `README.md`
- `RELEASING.md`
- `scripts/changelog-merge.sh`
- `scripts/gate.sh`
- `skill-data/automation/SKILL.md`
- `skill-data/core/references/app-model-runtime.md`
- `skill-data/core/references/bridge-security-native-capabilities.md`
- `skill-data/core/references/frontend-assets.md`
- `skill-data/core/SKILL.md`
- `skill-data/native-ui/SKILL.md`
- `skills/native-sdk/SKILL.md`
- `src/embed/c_api.zig`
- `src/embed/chrome.zig`
- `src/embed/host.zig`
- `src/platform/linux/cef_host.cpp`
- `src/platform/linux/gtk_host.h`
- `src/platform/macos/appkit_host.m`
- `src/platform/windows/cef_host.cpp`
- `src/primitives/canvas/themes/geist.zig`
- `src/runtime/api.zig`
- `src/runtime/async_bridge.zig`
- `src/runtime/automation_commands.zig`
- `src/runtime/automation_snapshot.zig`
- `src/runtime/automation_widget_dispatch.zig`
- `src/runtime/bridge_payload.zig`
- `src/runtime/bridge_responses.zig`
- `src/runtime/builtin_bridge.zig`
- `src/runtime/canvas_widget_context_menu.zig`
- `src/runtime/canvas_widget_runtime.zig`
- `src/runtime/core.zig`
- `src/runtime/effects_tests.zig`
- `src/runtime/effects.zig`
- `src/runtime/flow.zig`
- `src/runtime/gpu_surface_events.zig`
- `src/tooling/android.zig`
- `src/tooling/assets.zig`
- `src/tooling/buildgraph.zig`
- `src/tooling/cef.zig`
- `src/tooling/codesign.zig`
- `src/tooling/dev.zig`
- `src/tooling/doctor.zig`
- `src/tooling/eject_components.zig`
- `src/tooling/embedlib.zig`
- `src/tooling/ios.zig`
- `tests/README.md`
- `third_party/cef/README.md`
- `tools/linux-truth/drive.sh`
- `tools/linux-truth/README.md`
- `tools/native-sdk/automation.zig`
- `tools/windows-truth/README.md`