skills.rest
rubrical-works
rubrical-worksOFFICIAL
Explore all skills by this author →
GitHub

electron-cross-build

Cross-compile Electron apps from Linux to produce Windows executables and NSIS installers.

Updated Mar 30, 2026
Search Tags:#electron#linux#windows#wine#cross-compile#code-signing#nsis
One-click install
npx skills add https://github.com/rubrical-works/idpf-praxis-skills --skill electron-cross-build-rubrical-works
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: electron-cross-build
Source: https://github.com/rubrical-works/idpf-praxis-skills/tree/main/Skills/electron-cross-build
Command: npx skills add https://github.com/rubrical-works/idpf-praxis-skills --skill electron-cross-build-rubrical-works

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building Windows Electron packages normally requires a Windows machine, but this Skill provides the toolchain knowledge to cross-compile Windows executables, NSIS installers, and signed binaries directly from a Linux host or CI runner. ## Core Features & Use Cases - Toolchain Setup: Configure Wine, NSIS, and Docker (electronuserland/builder images) for Linux-to-Windows builds with electron-builder or Electron Forge. - Native Module Handling: Resolve node-gyp cross-compilation issues using prebuild-install or electron-rebuild with target platform flags. - Code Signing & CI/CD: Sign Windows executables from Linux via Wine signtool, osslsigncode, or cloud signing services, with ready GitHub Actions pipeline examples. - Use Case: A team developing on Ubuntu needs to ship a signed Windows installer from their Linux-only GitHub Actions pipeline; this Skill provides the exact configuration and commands to do it. ## Quick Start Ask Claude to read the electron-cross-build skill and help you configure electron-builder to produce a signed Windows NSIS installer from your Linux machine.

Frequently Asked Questions about electron-cross-build

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

FAQPage Schema
How do I build a Windows Electron app from Linux?▼

Install Wine and NSIS on your Linux host, then run npx electron-builder --win --x64. Alternatively, use the electronuserland/builder:wine Docker image, which ships with all cross-compilation dependencies preconfigured.

electron-builder vs Electron Forge for cross-compilation?▼

electron-builder with NSIS is more reliable for generating Windows installers from Linux. Electron Forge's Squirrel.Windows maker requires Wine and has limited Linux support, though its ZIP maker works without Wine.

Can I sign Windows executables from Linux?▼

Yes, three approaches work: signtool.exe running under Wine, the Linux-native osslsigncode tool, or cloud signing services like SSL.com eSigner and Azure SignTool. electron-builder supports PFX certificates via CSC_LINK environment variables.

Why do native Node modules fail in cross-compiled builds?▼

Native modules compiled with node-gyp are platform-specific, so a Linux-compiled binary will not run on Windows. Use modules with prebuild-install support, or rebuild with electron-rebuild --platform=win32 --arch=x64.

Why does NSIS fail with makensis not found on Linux?▼

The NSIS package is not installed on your system. Install it with apt install nsis, or use the electronuserland/builder:wine Docker image which bundles NSIS and Wine together.

Related Skills

Explore More Software Engineering Skills→
Auto-PluginAuto-Plugin
920

moai-framework-electron

Develop Electron 33+ desktop apps with IPC and packaging.

Official
Advanced
codjeremias-cellcodjeremias-cell
1

desktop-packaging

Packages Tauri v2 desktop apps into signed installers with auto-update via GitHub Releases.

Community
Intermediate
tddworkstddworks
1.4k

github-actions

Manage GitHub Actions CI/CD pipelines for building, testing, and releasing a macOS app.

Official
Intermediate
ortus-docsortus-docs
16

boxlang-runtime-compiled-native-binaries

Compile BoxLang source into standalone native executables with a Rust runner stub.

Official
Advanced