Compatibility
Supported targets
Section titled “Supported targets”| Operating system | Architecture | System webview | Bundled webview |
|---|---|---|---|
| macOS | arm64 | WKWebView | CEF |
| Windows | x64 | WebView2 | CEF |
| Windows | arm64 (beta) | WebView2 | CEF |
| Linux | x64 | WebKitGTK 4.1 | CEF |
| Linux | arm64 | WebKitGTK 4.1 | CEF |
Windows ARM64 is available in Electrobun beta releases with Hutch and Cottontail canary releases. Existing x64 installations continue to run under emulation; install the ARM64 build explicitly to switch architectures.
Hutch builds for the current host operating system and architecture. Produce a cross-platform release with native CI runners; native main-process compilers do not currently cross-compile Electrobun apps.
Main process runtimes
Section titled “Main process runtimes”| Runtime | Status | Notes |
|---|---|---|
| Cottontail | Default | Node.js and Bun-compatible TypeScript runtime |
| Bun | Optional | Actual Bun runtime, built and packaged by Hutch |
| Zig | Supported | Pinned Zig 0.16.0 toolchain |
| Rust | Supported | Pinned Rust 1.88.0 toolchain |
| Go | Supported | Pinned Go 1.26.4 toolchain |
| Odin | Supported | Pinned pre-1.0 Odin dev-2026-07a toolchain |
Odin does not support the Windows ARM64 target. Cottontail on Windows ARM64 supports JavaScriptCore’s Baseline, DFG, and FTL JIT tiers and WebAssembly.
Hutch accepts an exact matching system compiler. Otherwise it downloads the pinned compiler into its shared global toolchain store.
Webview engines
Section titled “Webview engines”System webviews produce the smallest bundles and receive browser updates from
the operating system. Set bundleCEF: true and select the CEF renderer when an
application needs a pinned Chromium implementation.
Electrobun pins and tests one CEF release with each framework release. Hutch does not currently expose a per-project CEF version override.
Linux requires GTK 3, WebKitGTK 4.1, Ayatana AppIndicator, and librsvg runtime packages even when CEF is bundled. See Cross-Platform Development for package names.
JavaScript compatibility
Section titled “JavaScript compatibility”Cottontail targets practical Node.js and Bun compatibility and is exercised
against copied upstream conformance tests on macOS, Windows, and Linux. Runtime
compatibility is separate from package management. Hutch’s built-in resolver
owns the JavaScript dependency graph and hutch.lock by default; a project may
explicitly select npm, pnpm, Yarn, or Bun to own them instead. Hutch also owns
Electrobun builds, versioned devkits, and compiler toolchains.
Native addons and code that depends on undocumented runtime internals can still be platform- or runtime-specific. Test the application on every target before a production release.
Cottontail’s optional standard-library APIs are packaged as capability modules.
Hutch detects recognized references in the bundled main process and includes
their dependencies. Dynamic usage may need additive
build.cottontail.capabilities entries; runtime API support does not by itself
guarantee that a module is included in a particular app bundle. See the
modular runtime guide.