Skip to content
Electrobun Docs

Electrobun

Everything you need to build ultra fast, tiny, cross-platform desktop applications with TypeScript.
Quick Start View on GitHub
Terminal window
hutch electrobun init
import { BrowserWindow } from "electrobun/main";


const win = new BrowserWindow({
  title: "My App",
  url: "views://mainview/index.html",
});

Why Electrobun

Tiny and fast

System webviews and the Cottontail runtime instead of a bundled Chromium and Node — apps measured in megabytes, not hundreds of them. CEF stays available as an option when you want a pinned browser engine.

One build tool

Hutch handles scripts, devkits, bundling, pinned toolchains, signing, and releases. Its built-in resolver handles JavaScript dependencies by default; external package managers remain an explicit option.

TypeScript first, native when you want it

Write your main process in TypeScript on Cottontail — or swap in Bun, Zig, Rust, Go, or Odin and keep the same workflow.

Native bindings

Windows, menus, trays, dialogs, and GPU surfaces implemented in C++, Objective-C, and Zig across macOS, Windows, and Linux.

Built-in updates

Verified updates served from static storage, with transactional replacement and rollback across Windows, macOS, and Linux.

Independent channels

Build stable and canary releases side by side, each with its own installers and update line.

Start here

Quick Start Install Hutch, scaffold a template, and run your first app in minutes.
What is Electrobun? The framework, the 2.x stack, and why it's shaped this way.
Hello World Build the smallest possible app from scratch and see what every file is for.
Migrate to 2.x Move an existing app to the Hutch and Cottontail project model.

Go deeper

Hutch Scripts, devkit sync, builds, toolchains, channels, and project pins.
Cottontail Electrobun's default TypeScript runtime and how it relates to Node and Bun.
Main Process Runtimes Cottontail, Bun, Zig, Rust, Go, and Odin — and how to choose.
Creating UI Host pages, the webview tag, and embedding isolated content.
Architecture Overview How Hutch, runtimes, Electrobun Core, and webviews fit together.
Bundling & Distribution Installers, update archives, delta patches, and release hosting.

Community & support

Electrobun is open source and built in the open.