Skip to Content

Installation

Tynd is a Bun-first framework. The CLI, the dev server, and the full runtime all run on Bun — Node.js is not a supported replacement for app developers.

Install Bun

curl -fsSL https://bun.sh/install | bash

Verify:

bun --version

OS-level WebView dependencies

Tynd uses the system WebView — Edge WebView2 on Windows, WKWebView on macOS, WebKitGTK 4.1 on Linux. End users of a built binary need nothing extra on Windows and macOS; Linux users may need the runtime WebKitGTK package.

WebView2 is pre-installed on Windows 11 and most Windows 10 versions.

Missing the runtime? Download the Evergreen Bootstrapper from developer.microsoft.com/microsoft-edge/webview2 .

Install the CLI

You don’t have to install anything globally — use bunx:

bunx @tynd/cli create my-app

Or add it to a project:

bun add -d @tynd/cli @tynd/core @tynd/host

@tynd/host’s postinstall downloads the pre-built tynd-full and tynd-lite binaries for your OS/arch from GitHub Releases. Bun blocks postinstall scripts by default — tynd init / tynd create auto-add @tynd/host to your package.json trustedDependencies so the download runs on the next bun install.

If the postinstall was skipped or failed (old @tynd/host version, network glitch), tynd dev / start / build / validate fall back to fetching the matching release asset on demand and cache it under node_modules/@tynd/host/bin/<platform>-<arch>/. If that also fails, see Troubleshooting.

Verify the install

bunx tynd info

Prints Bun version, Rust toolchain (if present), WebView2 status (Windows), OS info, and detected cache paths.

No Rust toolchain required. Unless you’re building the native host from source, you don’t need Rust — @tynd/host ships pre-built binaries.

Editor setup

Any TypeScript-capable editor works. The project’s tsconfig.json points at ES2023 + Bun’s type declarations (for full) or pure Web standards (for lite). No special language-server setup needed.

Next

Last updated on
Overview