electron-wrapper

Bundle a Bun-based web server into an Electron desktop app with electron-builder.

357|29|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/brianlovin/claude-config --skill electron-wrapper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: electron-wrapper
Source: https://github.com/brianlovin/claude-config/tree/main/skills/electron-wrapper
Command: npx skills add https://github.com/brianlovin/claude-config --skill electron-wrapper

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Wrap Bun-based web apps into native desktop experiences by combining Bun's server capabilities with Electron's window management, updates, and distribution, enabling a seamless cross-platform desktop deployment.

Core Features & Use Cases

  • Electron main process orchestration for desktop experiences
  • Bun server spawning with port management and cross-platform bundling
  • Cross-platform packaging for macOS/Windows via electron-builder
  • Auto-updates, code signing, and CI/CD pipelines for production readiness
  • UX refinements like drag regions and traffic lights with a safe preload setup

Quick Start

Scaffold the electron/ subproject and wire Electron to your Bun web app according to Phase 1.

Frequently Asked Questions about electron-wrapper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I bundle a Bun web server into an Electron desktop app?

Bundling a Bun web server into an Electron desktop app involves orchestrating an Electron main process that spawns the Bun server with port management, cross-platform binary bundling, and a safe preload environment for UI rendering.

What is the process for adding auto-updates and code signing to a desktop app?

Adding auto-updates and code signing to a desktop app uses electron-builder to configure CI/CD pipelines, generating production-ready cross-platform packages for macOS and Windows with automated update capabilities.

Can I use electron-builder for cross-platform packaging of a Bun server application?

Yes, you can use electron-builder for cross-platform packaging of a Bun server application by embedding platform-specific Bun binaries within the Electron main process to deploy native macOS and Windows desktop experiences.

How do I set up dev mode URL support when wrapping a web app with Electron?

Setting up dev mode URL support when wrapping a web app with Electron involves configuring the main process to load a local development server URL during development before transitioning to the bundled Bun server for production.

Do I need a preload script to safely run a Bun server inside Electron?

Yes, you need a preload script to safely run a Bun server inside Electron because it establishes a secure preload environment that bridges the main process and web app UI without exposing dangerous Node.js APIs.

How does cross-platform Bun binary bundling work for desktop deployment?

Cross-platform Bun binary bundling for desktop deployment works by embedding platform-specific Bun executables within the Electron app structure, allowing the main process to spawn the correct server binary on macOS or Windows.