TronbunDesktop Apps with TypeScript & Bun

Lightweight, fast, cross-platform desktop applications using native webviews. No Electron required.

⚡

Powered by Bun

Blazing-fast runtime and build tooling. No bundler config needed — Bun handles TypeScript, bundling, and compilation natively.

🪶

Truly Lightweight

Uses native platform webviews (WebKit on macOS, WebView2 on Windows) — no bundled Chromium. Your app stays small.

🔒

Type-Safe IPC

Decorator-based system auto-generates typed frontend APIs from your backend handlers. Full IntelliSense on both sides.

📦

Single Executable

Compile your entire app into a native .app bundle (macOS) or .exe (Windows) with all assets embedded.

🖥️

Native Features

System tray, native menus, dialogs, desktop notifications, and browser automation — all built in.

🌐

Cross-Platform

Write once in TypeScript. Build for macOS and Windows with platform-native look and feel.

Quick Start

bash

# Create a new project
npx tronbun init my-app
cd my-app && bun install

# Start developing with hot reload
npx tronbun dev

How It Works

Your backend runs in Bun. Your frontend runs in a native webview. They communicate over a type-safe IPC bridge.

Backend — src/main.tsFrontend — src/web/index.ts

typescript

import { WindowIPC, windowName, mainHandler } from "tronbun";

@windowName("MyApp")
class MainWindow extends WindowIPC {
  constructor() {
    super({ title: "My App", width: 800, height: 600 });
    this.navigate("public/index.html");
  }

  @mainHandler("greet")
  async handleGreet(name: string) {
    return `Hello, ${name}!`;
  }
}

new MainWindow();