Skip to content
Electrobun Docs

v1.18.0

Released 2026-05-03.

Highlights

  • Better docs site at docs.electrobunny.ai. Docs now live in the git repo as Markdown, built with Astro Starlight.
  • Bun bumped to 1.3.11; CEF bumped from 145 to 147 with a partition migration and clean cache reset.
  • WGPU and transparent-window perf wins on Windows via the new DirectComposition compositor (~48 FPS → ~1729 FPS on the bridged path).
  • 20 PRs merged from the community. Thank you to everyone who pitched in.
  • Stabilized lots of things — frameless windows on Windows, Linux WebKitGTK, BrowserView lifetimes, build tooling, error reporting.
  • New unofficial Raspberry Pi fork kortexa-ai/electrobun (linux-wpe) — follow @francip who’s leading the effort. If you want Electrobun on Pis across the world, go help out.

Migration Notes

CEF cache wipe on first launch after upgrade

First launch after upgrading silently wipes the CEF cache once. End users get logged out of any sites they were signed into via your app and client-side site data (cookies, localStorage, IndexedDB) is reset. WebView2 storage and your own app data are untouched.

New Features

  • DirectComposition for transparent windows on Windows, with a zero-copy WGPU bridge that brings the bridged path from ~48 to ~1729 FPS.
  • File associations via a new app.fileAssociations config — opened files arrive through the existing open-url event.
  • Native .icon support on macOS — point mac.icons at an Icon Composer .icon file to ship Liquid Glass icons on macOS 26+ (with .icns fallback for older versions).
  • BrowserWindow.hide() with native bindings on all three platforms.
  • Linux desktop integration — apps drop a .desktop file into the XDG applications directory so they appear in the system app menu and launcher.
  • Bumped Bun to 1.3.11 and CEF from 145 to 147.
  • Surface full error output when electrobun build or electrobun dev fails.
  • Renamed Updater.localInfo.getLocallocalInfo() → getLocalInfo() (old name kept as deprecation alias).
  • Exported RESOURCES_FOLDER from Electrobun.PATHS.
  • Moved Electrobun docs back into the main repo with a dedicated deploy workflow.

Bug Fixes

  • Fix hiddenInset frameless window on Windows — preserve resize borders and DWM shadow, and stop clipping content when maximized.
  • Fix fullscreen behaviour and traffic light positioning on macOS.
  • Use xcrun for macOS native builds.
  • Fix Windows tar handling and resolve rcedit explicitly.
  • Linux: persistent cookie storage now works under WebKitGTK; full-size BrowserViews render as a proper overlay instead of a 1×1 GtkFixed; CEF webviews stop opening in their own windows.
  • Unify CEF partition path handling.
  • Strip trailing slashes from views:// URL paths.
  • Allow null for BrowserView.ptr to avoid crashes on torn-down views.
  • Include template .gitignore files when scaffolding new projects.
  • Remove the spinner-thread deadlock in the Linux extractor and improve its progress UX.
  • Remove a duplicate makeSurfaceTexture definition in the WebGPU layer.