Electrobun Dev Mode

Commands

electrobun dev          # build (dev env) once, then launch app
electrobun dev --watch  # build, launch, then watch for changes and rebuild+relaunch

bun start               # → electrobun dev
bun run dev             # → electrobun dev --watch

What Happens on

electrobun dev

1. Reads

   electrobun.config.ts

2. Downloads any missing native binaries (Bun, launcher, WGPU/CEF if configured)
3. Bundles

   build.bun.entrypoint

   via

   Bun.build()

   in dev mode (no minify, sourcemaps inline)
4. Bundles each

   build.views.*

   entrypoint
5. Copies

   build.copy

   files to build output
6. Skips codesign and notarization
7. Writes app bundle to

   build/dev-<os>-<arch>/

8. Launches the app, streaming stdout/stderr to your terminal

Watch Mode (

--watch

)

• Dir containing

  build.bun.entrypoint

• Dir(s) containing each

  build.views.*

  entrypoint
• Dirs listed in

  build.watch

  (extra paths)
• Dirs of files listed in

  build.copy

build/

artifacts/

node_modules/

build.watchIgnore

Extra watch paths

// electrobun.config.ts
build: {
  watch: ["src/shared/", "assets/"],
  watchIgnore: ["src/**/*.test.ts", "src/**/*.spec.ts"],
}

CEF DevTools (Chromium inspector)

renderer: "cef"

defaultRenderer: "cef"

http://localhost:9222

dev

canary

stable

Native WebView Debugging (macOS)

renderer: "native"

// In src/bun/index.ts — call openDevTools() on the BrowserView instance
const view = new BrowserView({ ... });
view.openDevTools();  // Opens Safari Web Inspector (uses private WKWebView _inspector API)

Debugging Tips

1. Console output: All

   console.log

   from bun-side code appears in the terminal. Renderer-side

   console.log

   only appears in devtools (not terminal).
2. RPC tracing: Add

   console.log

   to request/message handlers to trace cross-process calls.
3. Source maps: Dev builds include inline source maps. Stack traces point to

   .ts

   source lines.
4. Slow reload? Add only changed dirs to

   build.watch

   rather than broad patterns.
5. App not relaunching? If the app process is holding a file lock, kill it manually:

   pkill -f "<AppName>"

Build Output (dev)

build/dev-macos-arm64/
└── <AppName>-dev.app/
    └── Contents/
        ├── MacOS/
        │   ├── launcher          # native launcher
        │   └── main.js           # bundled bun entrypoint
        ├── Resources/
        │   ├── <viewname>/       # bundled renderer
        │   └── bun               # bun runtime binary
        └── Info.plist