electrobun 1.14.4 → 1.14.5-beta.0

package/README.md

@@ -0,0 +1,117 @@
+<p align="center">
+  <a href="https://electrobun.dev"><img src="https://github.com/blackboardsh/electrobun/assets/75102186/8799b522-0507-45e9-86e3-c3cfded1aa7c" alt="Logo" height=170></a>
+</p>
+
+<h1 align="center">Electrobun</h1>
+
+<div align="center">
+  Get started with a template <br />
+  <code><strong>npx electrobun init</strong></code>   
+</div>
+
+
+
+## What is Electrobun?
+
+Electrobun aims to be a complete **solution-in-a-box** for building, updating, and shipping ultra fast, tiny, and cross-platform desktop applications written in Typescript.
+Under the hood it uses <a href="https://bun.sh">bun</a> to execute the main process and to bundle webview typescript, and has native bindings written in <a href="https://ziglang.org/">zig</a>.
+
+Visit <a href="https://blackboard.sh/electrobun/">https://blackboard.sh/electrobun/</a> to see api documentation, guides, and more.
+
+**Project Goals**
+
+- Write typescript for the main process and webviews without having to think about it.
+- Isolation between main and webview processes with fast, typed, easy to implement RPC between them.
+- Small self-extracting app bundles ~12MB (when using system webview, most of this is the bun runtime)
+- Even smaller app updates as small as 14KB (using bsdiff it only downloads tiny patches between versions)
+- Provide everything you need in one tightly integrated workflow to start writing code in 5 minutes and distribute in 10.
+
+## Apps Built with Electrobun
+- [Audio TTS](https://github.com/blackboardsh/audio-tts) - desktop text-to-speech app using Qwen3-TTS for voice design, cloning, and generation
+- [Co(lab)](https://blackboard.sh/colab/) - a hybrid web browser + code editor for deep work
+
+### Video Demos
+
+[![Audio TTS Demo](https://img.youtube.com/vi/Z4dNK1d6l6E/maxresdefault.jpg)](https://www.youtube.com/watch?v=Z4dNK1d6l6E)
+
+[![Co(lab) Demo](https://img.youtube.com/vi/WWTCqGmE86w/maxresdefault.jpg)](https://www.youtube.com/watch?v=WWTCqGmE86w)
+
+## Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=blackboardsh/electrobun&type=date&legend=top-left&cache=1)](https://www.star-history.com/#blackboardsh/electrobun&type=date&legend=top-left)
+
+## Contributing
+Ways to get involved:
+
+- Follow us on X for updates <a href="https://twitter.com/BlackboardTech">@BlackboardTech</a> or <a href="https://bsky.app/profile/yoav.codes">@yoav.codes</a>
+- Join the conversation on <a href="https://discord.gg/ueKE4tjaCE">Discord</a>
+- Create and participate in Github issues and discussions
+- Let me know what you're building with Electrobun
+
+## Development Setup
+Building apps with Electrobun is as easy as updating your package.json dependencies with `npm add electrobun` or try one of our templates via `npx electrobun init`.
+
+**This section is for building Electrobun from source locally in order to contribute fixes to it.**
+
+### Prerequisites
+
+**macOS:**
+- Xcode command line tools
+- cmake (install via homebrew: `brew install cmake`)
+
+**Windows:**
+- Visual Studio Build Tools or Visual Studio with C++ development tools
+- cmake
+
+**Linux:**
+- build-essential package
+- cmake
+- webkit2gtk and GTK development packages
+
+On Ubuntu/Debian based distros: `sudo apt install build-essential cmake pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev`
+
+### First-time Setup
+
+```bash
+git clone --recurse-submodules https://github.com/blackboardsh/electrobun.git
+cd electrobun/package
+bun install
+bun dev:clean
+```
+
+### Development Workflow
+
+```bash
+# All commands are run from the /package directory
+cd electrobun/package
+
+# After making changes to source code
+bun dev
+
+# If you only changed kitchen sink code (not electrobun source)
+bun dev:rerun
+
+# If you need a completely fresh start
+bun dev:clean
+```
+
+### Additional Commands
+
+All commands are run from the `/package` directory:
+
+- `bun dev:canary` - Build and run kitchen sink in canary mode
+- `bun build:dev` - Build electrobun in development mode
+- `bun build:release` - Build electrobun in release mode
+
+### Debugging
+
+**macOS:** Use `lldb <path-to-bundle>/Contents/MacOS/launcher` and then `run` to debug release builds
+
+## Platform Support
+
+| OS | Status |
+|---|---|
+| macOS 14+ | Official |
+| Windows 11+ | Official |
+| Ubuntu 22.04+ | Official |
+| Other Linux distros (gtk3, webkit2gtk-4.1) | Community |

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "electrobun",
-	"version": "1.14.4",
+	"version": "1.14.5-beta.0",
 	"description": "Build ultra fast, tiny, and cross-platform desktop apps with Typescript.",
 	"license": "MIT",
 	"author": "Blackboard Technologies Inc.",
@@ -35,8 +35,8 @@
 		"dev:canary": "bun install && bun build:release && cd ../kitchen && bun install && bun build:canary",
 		"dev:stable": "bun install && bun build:release && cd ../kitchen && bun install && bun build:stable",
 		"build:docs:release": "cd ../documentation && bun run build",
-		"npm:publish": "bun build:release && cp ../README.md . && npm publish && rm README.md",
-		"npm:publish:beta": "bun build:release && cp ../README.md . && npm publish --tag beta && rm README.md",
+		"npm:publish": "bun build:release && npm publish",
+		"npm:publish:beta": "bun build:release && npm publish --tag beta",
 		"typecheck": "bunx tsc --noEmit && cd ../kitchen && bunx tsc --noEmit",
 		"push:beta": "bun run typecheck && bun scripts/push-version.js beta",
 		"push:patch": "bun run typecheck && bun scripts/push-version.js patch",

package/src/cli/index.ts

@@ -3640,6 +3640,8 @@ Categories=Utility;Application;
 		let lastChangedFile = "";
 		let debounceTimer: ReturnType<typeof setTimeout> | null = null;
 		let shuttingDown = false;
+		let isBuilding = false;
+		let rebuildPending = false;
 		let watchers: ReturnType<typeof watch>[] = [];
 
 		function startWatchers() {
@@ -3674,9 +3676,25 @@ Categories=Utility;Application;
 		async function triggerRebuild() {
 			if (shuttingDown) return;
 
+			// Guard against concurrent builds — if already building, mark
+			// that another rebuild is needed and let the current one finish.
+			if (isBuilding) {
+				rebuildPending = true;
+				return;
+			}
+			isBuilding = true;
+			rebuildPending = false;
+
 			// Stop watching during build so build output doesn't trigger more events
 			stopWatchers();
 
+			// Cancel any lingering debounce timer that may have been queued
+			// before stopWatchers took effect.
+			if (debounceTimer) {
+				clearTimeout(debounceTimer);
+				debounceTimer = null;
+			}
+
 			const changedDisplay = lastChangedFile
 				? lastChangedFile.replace(projectRoot + "/", "")
 				: "unknown";
@@ -3712,10 +3730,17 @@ Categories=Utility;Application;
 				console.log("[electrobun dev --watch] Waiting for file changes...");
 			}
 
+			isBuilding = false;
+
 			// Resume watching after build + hooks are done
 			if (!shuttingDown) {
 				startWatchers();
 			}
+
+			// If a file change came in while we were building, rebuild again.
+			if (rebuildPending && !shuttingDown) {
+				triggerRebuild();
+			}
 		}
 
 		function cleanup() {