https://github.com/blackboardsh/electrobun
Build ultra fast, tiny, and cross-platform desktop apps with Typescript.
https://github.com/blackboardsh/electrobun
Last synced: about 15 hours ago
JSON representation
Build ultra fast, tiny, and cross-platform desktop apps with Typescript.
- Host: GitHub
- URL: https://github.com/blackboardsh/electrobun
- Owner: blackboardsh
- License: mit
- Created: 2024-02-28T03:18:15.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-03-03T07:30:19.000Z (13 days ago)
- Last Synced: 2026-03-03T10:55:00.414Z (13 days ago)
- Language: TypeScript
- Homepage: http://blackboard.sh/electrobun
- Size: 129 MB
- Stars: 7,674
- Watchers: 37
- Forks: 173
- Open Issues: 113
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome - blackboardsh/electrobun - Build ultra fast, tiny, and cross-platform desktop apps with Typescript. (TypeScript)
- stars - electrobun - platform desktop apps with Typescript. | blackboardsh | 7956 | (TypeScript)
- awesome-starred - blackboardsh/electrobun - Build ultra fast, tiny, and cross-platform desktop apps with Typescript. (TypeScript)
- AiTreasureBox - blackboardsh/electrobun - 02-24_6829_193](https://img.shields.io/github/stars/blackboardsh/electrobun.svg)|Build ultra fast, tiny, and cross-platform desktop apps with Typescript.| (Repos)
- awesome-random-stuff - blackboardsh/electrobun - platform desktop apps with Typescript. - blackboardsh/electrobun (Uncategorized / Uncategorized)
- awesome - blackboardsh/electrobun - Build ultra fast, tiny, and cross-platform desktop apps with Typescript. (<a name="TypeScript"></a>TypeScript)
README
Electrobun
Get started with a template
npx electrobun init
## 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 bun to execute the main process and to bundle webview typescript, and has native bindings written in zig.
Visit https://blackboard.sh/electrobun/ 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
- [DOOM](https://github.com/blackboardsh/electrobun-doom) - DOOM implemented in 2 ways: bun -> (c doom -> bundled wgpu) and (full ts port bun -> bundled wgpu)
### Video Demos
[](https://www.youtube.com/watch?v=Z4dNK1d6l6E)
[](https://www.youtube.com/watch?v=WWTCqGmE86w)
[](https://x.com/YoavCodes/status/2028499038148903239?s=20)
## Star History
[](https://www.star-history.com/#blackboardsh/electrobun&type=date&legend=top-left)
## Contributing
Ways to get involved:
- Follow us on X for updates @BlackboardTech or @yoav.codes
- Join the conversation on Discord
- 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 /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 |