--- description: Looking for a maintained @capacitor-community/electron alternative? Learn how to migrate your Capacitor desktop app to the new Capacitor Electron Platform. title: Migrate Off Capacitor Community Electron - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/capacitor-community-electron-migration.png --- [Skip to content ](#migrate-off-capacitor-community-electron) [πŸ–₯️ Introducing the **Capacitor Electron Platform** β€” build desktop apps for macOS, Windows, and Linux. Free & open source. ](/blog/announcing-the-capacitor-electron-platform/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ Gyroscope ](/docs/sdks/capacitor/gyroscope/) * [ Haptics ](/docs/sdks/capacitor/haptics/) * [ Home Indicator ](/docs/sdks/capacitor/home-indicator/) * [ In-App Browser ](/docs/sdks/capacitor/in-app-browser/) * [ Install Referrer ](/docs/sdks/capacitor/install-referrer/) * [ Intercom ](/docs/sdks/capacitor/intercom/) * [ Intune ](/docs/sdks/capacitor/intune/) * [ Keep Awake ](/docs/sdks/capacitor/keep-awake/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Light Sensor ](/docs/sdks/capacitor/light-sensor/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Localization ](/docs/sdks/capacitor/localization/) * [ Mail Composer ](/docs/sdks/capacitor/mail-composer/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Maps Launcher ](/docs/sdks/capacitor/maps-launcher/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ Network ](/docs/sdks/capacitor/network/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ Node.js ](/docs/sdks/capacitor/nodejs/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Passkeys ](/docs/sdks/capacitor/passkeys/) * [ Password Autofill ](/docs/sdks/capacitor/password-autofill/) * [ PDF Generator ](/docs/sdks/capacitor/pdf-generator/) * [ PDF Viewer ](/docs/sdks/capacitor/pdf-viewer/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Permissions ](/docs/sdks/capacitor/permissions/) * [ Phone Dialer ](/docs/sdks/capacitor/phone-dialer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ Photo Manipulator ](/docs/sdks/capacitor/photo-manipulator/) * [ PixLive ](/docs/sdks/capacitor/pixlive/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Privacy Screen ](/docs/sdks/capacitor/privacy-screen/) * [ Proximity Sensor ](/docs/sdks/capacitor/proximity-sensor/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Root Detection ](/docs/sdks/capacitor/root-detection/) * [ Screen Brightness ](/docs/sdks/capacitor/screen-brightness/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screen Reader ](/docs/sdks/capacitor/screen-reader/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Settings Launcher ](/docs/sdks/capacitor/settings-launcher/) * [ Shake ](/docs/sdks/capacitor/shake/) * [ Silent Mode ](/docs/sdks/capacitor/silent-mode/) * [ SIM ](/docs/sdks/capacitor/sim/) * [ SMS Composer ](/docs/sdks/capacitor/sms-composer/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ System WebView ](/docs/sdks/capacitor/system-webview/) * [ Tauri ](/docs/sdks/capacitor/tauri/) * [ Text Interaction ](/docs/sdks/capacitor/text-interaction/) * [ Text Zoom ](/docs/sdks/capacitor/text-zoom/) * [ Thermal State ](/docs/sdks/capacitor/thermal-state/) * [ Toast ](/docs/sdks/capacitor/toast/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Volume ](/docs/sdks/capacitor/volume/) * [ Wallet ](/docs/sdks/capacitor/wallet/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ YouTube Player ](/docs/sdks/capacitor/youtube-player/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm, Yarn, or bun ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ What if a plugin has no Electron implementation? ](#what-if-a-plugin-has-no-electron-implementation) * [ FAQ ](#faq) * [ Conclusion ](#conclusion) * Related links # Migrate Off Capacitor Community Electron[ΒΆ](#migrate-off-capacitor-community-electron "Permanent link") If you have been searching for a maintained **capacitor community electron alternative**, this guide is for you. The [Capacitor Community Electron Platform](https://github.com/capacitor-community/electron) is no longer actively maintained, which leaves desktop apps pinned to aging Electron versions and a large generated project you have to babysit yourself. Here you will learn how to move your Capacitor desktop app to the maintained [Capacitor Electron Platform](/docs/sdks/capacitor/electron/), step by step. [ ![Build and deploy your Capacitor app with Capawesome Cloud](https://capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png?t=1) ](https://capawesome.io/) **Key takeaways:** * The `@capacitor-community/electron` platform is no longer actively maintained, so staying on it means falling further behind on security and Electron releases. * The maintained alternative is `@capawesome/capacitor-electron`, licensed under MIT and free to use. * Instead of owning a large generated Electron project, you own a minimal scaffold while the platform logic ships in a versioned npm package. * Plugins with a web implementation keep working through automatic fallback, so most apps migrate with little friction. * Security defaults such as a sandboxed renderer, context isolation, and a strict CSP are enabled out of the box and cannot be weakened. * The platform requires Capacitor 6 or later and Electron 28 or later. ## Why migrate away from the Capacitor Community Electron platform?[ΒΆ](#why-migrate-away-from-the-capacitor-community-electron-platform "Permanent link") The short version: the `@capacitor-community/electron` platform is no longer actively maintained. New releases have stalled, and that has a few concrete consequences you feel in day-to-day development. First, you are effectively pinned to older Electron versions. Electron ships frequent security patches, and Chromium vulnerabilities are disclosed regularly. When the platform that wires Electron into your Capacitor app stops keeping up, upgrading becomes your problem to solve by hand, and the gap only grows over time. Second, the community platform generates a full Electron project inside your repository. That generated `electron/` folder contains the main process, preload scripts, and build wiring, and all of it lives in your source tree. You own every line of it. When something needs to change, whether it is a security fix, a new Electron API, or a build tweak, there is no package update that carries the improvement to you. You edit the generated code yourself and hope you got the details right. For a desktop runtime that sits between the operating system and your web layer, that is a real risk. Security-sensitive defaults drift, bugs go unpatched, and the maintenance burden quietly shifts onto your team. Looking for a maintained capacitor community electron alternative is the sensible response, not a nice-to-have. ## What's different in the Capacitor Electron Platform?[ΒΆ](#whats-different-in-the-capacitor-electron-platform "Permanent link") The [Capacitor Electron Platform](/docs/sdks/capacitor/electron/) takes a different approach to almost every one of those pain points. The core idea is that you should own as little runtime code as possible, while the platform maintainers own the parts that need regular updates. The table below compares the two platforms across the aspects that matter most during a migration. | Aspect | Community Electron | Capacitor Electron Platform | | ------------------ | ------------------------------------------ | -------------------------------------------------------------------------------------------------------- | | Maintenance status | No longer actively maintained | Actively maintained, released under MIT | | Runtime ownership | You own a large generated Electron project | You own a minimal scaffold; platform logic lives in the versioned npm package and updates via npm update | | Security defaults | Configured manually in generated code | Sandboxed renderer, context isolation, strict CSP, and validated IPC enabled by default | | Live Updates | None | Built-in serving primitive with failed-boot rollback | | Electron version | Pinned to an older version | Tracks the latest Electron, with a floor of Electron 28 | The ownership row is the one that changes the most in practice. Because the heavy lifting lives inside `@capawesome/capacitor-electron`, a routine `npm update` pulls in security hardening, bug fixes, and support for newer Electron releases. You are no longer the sole maintainer of your desktop runtime. The security row matters just as much. The renderer runs sandboxed with context isolation, a strict Content Security Policy is applied, and IPC messages are validated. These defaults are mandatory and cannot be weakened, which removes a whole category of mistakes that were easy to make when you hand-edited a generated main process. There is also something genuinely new here. The Capacitor Electron Platform is the first Capacitor desktop platform with built-in Live Updates. It ships a provider-agnostic serving API together with a watchdog that rolls back to the last known-good bundle if a new one fails to boot. If you already deliver over-the-air updates on mobile, you can now extend the same idea to the desktop. ## How do you migrate to the Capacitor Electron Platform?[ΒΆ](#how-do-you-migrate-to-the-capacitor-electron-platform "Permanent link") Migrating is mostly a matter of removing the old platform, adding the new one, and moving any custom code into the new extension points. The steps below walk through the full path. To keep things focused, the install details are kept short and linked rather than repeated in full, since the migration path is the interesting part here. ### The fast path: AI-assisted migration[ΒΆ](#the-fast-path-ai-assisted-migration "Permanent link") If you would rather not do this by hand, there is a shortcut. The [Capawesome Skills](https://github.com/capawesome-team/skills) include a `capacitor-platforms` skill that adds and configures the Capacitor Electron Platform for you directly from your AI assistant. Add it to your tool of choice with a single command. `[](#%5F%5Fcodelineno-0-1)npx skills add capawesome-team/skills --skill capacitor-platforms ` Then prompt your assistant to add the `@capawesome/capacitor-electron` platform to your project, and it will scaffold and wire up the setup for you. It is the quickest way to get onto the maintained platform. The manual steps below are still worth reading so you understand what changes during the migration, and to handle anything the assistant leaves for you to review, such as porting a custom plugin implementation. ### Step 1 β€” Remove the old platform[ΒΆ](#step-1-remove-the-old-platform "Permanent link") Begin by uninstalling the community platform and deleting the project it generated. Removing the package first makes sure nothing tries to reference it afterwards. `[](#%5F%5Fcodelineno-1-1)npm uninstall @capacitor-community/electron ` After that, delete the generated `electron/` project from your repository. It contained runtime code you no longer need, since the new platform provides its own scaffold in the next step. If you made custom changes in that folder, note them down first, because Step 3 shows where they belong now. ### Step 2 β€” Add the new platform[ΒΆ](#step-2-add-the-new-platform "Permanent link") With the old platform gone, install the maintained alternative and add it as a Capacitor platform. The `cap add` command scaffolds a fresh `electron/` folder. `[](#%5F%5Fcodelineno-2-1)npm install @capawesome/capacitor-electron [](#%5F%5Fcodelineno-2-2)npx cap add @capawesome/capacitor-electron ` The new scaffold is intentionally minimal. It contains only what you are meant to own, while the platform logic stays in the npm package. For a full walkthrough of the initial setup, see [the getting-started guide](/blog/how-to-build-a-desktop-app-with-capacitor-and-electron/) and the [Installation](/docs/sdks/capacitor/electron/#installation) section in the SDK documentation. ### Step 3 β€” Move custom main-process code into config hooks[ΒΆ](#step-3-move-custom-main-process-code-into-config-hooks "Permanent link") With the community platform, any custom main-process behavior meant editing the generated main process directly. Trays, application menus, and window tweaks all lived in code you owned and maintained. The new platform replaces that pattern with dedicated hooks so your customizations survive updates. You configure these hooks under the `hooks` key in `capacitor.electron.config.ts`. There are three of them: `beforeReady` runs before the app is ready and receives the Electron `app`, `windowFactory` creates the browser window, and `onWindowCreated` runs after a window exists. A typical config looks like this. `[](#%5F%5Fcodelineno-3-1)import { defineConfig } from '@capawesome/capacitor-electron/config'; [](#%5F%5Fcodelineno-3-2) [](#%5F%5Fcodelineno-3-3)export default defineConfig({ [](#%5F%5Fcodelineno-3-4) hooks: { [](#%5F%5Fcodelineno-3-5) beforeReady: (app) => { [](#%5F%5Fcodelineno-3-6) // Set up trays, application menus, or other startup logic. [](#%5F%5Fcodelineno-3-7) }, [](#%5F%5Fcodelineno-3-8) onWindowCreated: (window) => { [](#%5F%5Fcodelineno-3-9) // Tweak the window after it has been created. [](#%5F%5Fcodelineno-3-10) }, [](#%5F%5Fcodelineno-3-11) }, [](#%5F%5Fcodelineno-3-12)}); ` If you provide a custom `windowFactory`, keep one rule in mind: it must not weaken the mandatory security options. Context isolation, the sandbox, and the strict CSP stay in place no matter what your factory returns. This is deliberate, and it is what keeps every app on the platform secure by default. ### Step 4 β€” Handle plugins[ΒΆ](#step-4-handle-plugins "Permanent link") Plugins are usually the part developers worry about most, and here the news is good for the majority of cases. Any plugin that has a web implementation works automatically through the platform's fallback mechanism, so you do not need to touch it at all. The plugins that need attention are the ones that shipped a custom Electron implementation for the community platform. That old approach is not compatible with the new one, so those plugins must be re-implemented against the new plugin contract. The contract is small: a plugin class exposes its public API through static `__capacitorElectronPlugin` metadata with a `name` and a list of `methods`. The optional `defineElectronPlugin(metadata, pluginClass)` helper sets that metadata for you. `[](#%5F%5Fcodelineno-4-1)import { defineElectronPlugin } from '@capawesome/capacitor-electron/plugin'; [](#%5F%5Fcodelineno-4-2) [](#%5F%5Fcodelineno-4-3)class EchoImpl { [](#%5F%5Fcodelineno-4-4) async echo(options: { value: string }) { [](#%5F%5Fcodelineno-4-5) return { value: options.value }; [](#%5F%5Fcodelineno-4-6) } [](#%5F%5Fcodelineno-4-7)} [](#%5F%5Fcodelineno-4-8) [](#%5F%5Fcodelineno-4-9)export const Echo = defineElectronPlugin( [](#%5F%5Fcodelineno-4-10) { name: 'Echo', methods: ['echo'] }, [](#%5F%5Fcodelineno-4-11) EchoImpl, [](#%5F%5Fcodelineno-4-12)); ` If you maintain plugins yourself, or you depend on one that needs porting, point the author to the plugin author guide in the [repository](https://github.com/capawesome-team/capacitor-electron). It covers the contract and packaging expectations in detail. ### Step 5 β€” Update packaging[ΒΆ](#step-5-update-packaging "Permanent link") Packaging moves into the scaffolded `electron/` folder. The `pack` script runs the full pipeline for you: it compiles TypeScript, vendors the runtime dependencies, and then hands off to electron-builder. `[](#%5F%5Fcodelineno-5-1)cd electron && npm run pack ` Your existing signing and notarization settings carry over cleanly. They live in `electron-builder.config.js`, so if you already configured code signing for macOS or Windows, you can bring that configuration across with minimal changes. ### Step 6 β€” Verify[ΒΆ](#step-6-verify "Permanent link") Finally, run the app to confirm everything is wired up. The Capacitor CLI can launch the Electron target directly. `[](#%5F%5Fcodelineno-6-1)npx cap run @capawesome/capacitor-electron ` Once the app is running, a quick sanity check is to confirm the platform name. Calling `Capacitor.getPlatform()` in your web layer should return `'electron'`, which tells you the platform is detected and your web code can branch on it just like it does for `'ios'` or `'android'`. ## What if a plugin has no Electron implementation?[ΒΆ](#what-if-a-plugin-has-no-electron-implementation "Permanent link") This comes up often enough to call out on its own. If a plugin has no dedicated Electron implementation, the platform falls back to the plugin's web implementation, and in most cases that is exactly what you want. A large share of Capacitor plugins are perfectly happy running their web code inside the Electron renderer. When the web fallback is not enough, for example when a plugin needs true native desktop APIs, you have two options. You can implement the plugin against the new contract described in Step 4, or you can open an issue in the [repository](https://github.com/capawesome-team/capacitor-electron) so the maintainers and community can help. Either way, you are not stuck. ## FAQ[ΒΆ](#faq "Permanent link") ### Is the Capacitor Electron Platform free?[ΒΆ](#is-the-capacitor-electron-platform-free "Permanent link") Yes. `@capawesome/capacitor-electron` is licensed under MIT and is free to use in both open source and commercial projects. ### Do my existing plugins work?[ΒΆ](#do-my-existing-plugins-work "Permanent link") Plugins with a web implementation work automatically through the platform's fallback mechanism. Only plugins that shipped a custom Electron implementation for the community platform need to be re-implemented against the new plugin contract. ### Which Capacitor and Electron versions are required?[ΒΆ](#which-capacitor-and-electron-versions-are-required "Permanent link") The platform requires Capacitor 6 or later and Electron 28 or later. It tracks recent Electron releases, so you stay closer to the latest security patches over time. ### Can I keep my electron-builder config?[ΒΆ](#can-i-keep-my-electron-builder-config "Permanent link") Yes. Packaging is handled by electron-builder, and your signing and notarization settings live in `electron-builder.config.js`. Existing configuration carries over with little to no change. ### How is this different from owning the generated project?[ΒΆ](#how-is-this-different-from-owning-the-generated-project "Permanent link") With the community platform you owned the entire generated Electron project. With the Capacitor Electron Platform you own only a minimal scaffold, while the runtime logic ships in the npm package and updates through `npm update`. Ready to move your desktop app onto a maintained platform and unlock Live Updates on the desktop? Give Capawesome Cloud a try and ship your Capacitor app with confidence. [Try Capawesome Cloud Free](https://capawesome.io) ## Conclusion[ΒΆ](#conclusion "Permanent link") Staying on an unmaintained desktop platform is a slow-moving risk: old Electron versions, unpatched security defaults, and a large generated project that only you can maintain. The Capacitor Electron Platform flips that around. You own a minimal scaffold, the platform logic updates through npm, security-first defaults are on by default, and you get built-in Live Updates on the desktop for the first time. Most apps migrate by swapping the package, moving custom code into config hooks, and re-implementing the handful of plugins that need it. If you are setting up desktop support for the first time or want a deeper look at the platform, read [Build a desktop app with Capacitor and Electron](/blog/how-to-build-a-desktop-app-with-capacitor-and-electron/). Questions are welcome on the [Capawesome Discord server](https://discord.gg/VCXxSVjefW), and you can follow along with new releases through the [Capawesome newsletter](https://capawesome.io/newsletter). July 17, 2026 Back to top ```json { "@context": "https://schema.org", "@type": "BlogPosting", "headline": "Migrate Off Capacitor Community Electron", "description": "Looking for a maintained @capacitor-community/electron alternative? Learn how to migrate your Capacitor desktop app to the new Capacitor Electron Platform.", "image": "https://capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.png", "datePublished": "2026-07-17T00:00:00+00:00", "dateModified": "2026-07-17T00:00:00+00:00", "author": [ { "@type": "Person", "name": "Robin Genz", "url": "https://github.com/robingenz" } ], "publisher": { "@type": "Organization", "name": "Capawesome", "url": "https://capawesome.io", "logo": { "@type": "ImageObject", "url": "https://capawesome.io/assets/images/logo.svg" } }, "articleSection": "Capacitor", "keywords": ["Capacitor", "Electron", "Guides"], "isPartOf": { "@type": "Blog", "@id": "https://capawesome.io/blog/#blog" }, "mainEntityOfPage": "https://capawesome.io/blog/capacitor-community-electron-migration/", "url": "https://capawesome.io/blog/capacitor-community-electron-migration/" } { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "Home", "item": "https://capawesome.io/" }, { "@type": "ListItem", "position": 2, "name": "Blog", "item": "https://capawesome.io/blog/" }, { "@type": "ListItem", "position": 3, "name": "Migrate Off Capacitor Community Electron", "item": "https://capawesome.io/blog/capacitor-community-electron-migration/" } ] } {"@context": "https://schema.org", "@type": "FAQPage", "mainEntity": [{"@type": "Question", "name": "Why migrate away from the Capacitor Community Electron platform?", "acceptedAnswer": {"@type": "Answer", "text": "The short version: the @capacitor-community/electron platform is no longer actively maintained. New releases have stalled, and that has a few concrete consequences you feel in day-to-day development. First, you are effectively pinned to older Electron versions. Electron ships frequent security patches, and Chromium vulnerabilities are disclosed regularly. When the platform that wires Electron into your Capacitor app stops keeping up, upgrading becomes your problem to solve by hand, and the gap only grows over time. Second, the community platform generates a full Electron project inside your repository. That generated electron/ folder contains the main process, preload scripts, and build wiring, and all of it lives in your source tree. You own every line of it. When something needs to change, whether it is a security fix, a new Electron API, or a build tweak, there is no package update that carries the improvement to you. You edit the generated code yourself and hope you got the details right. For a desktop runtime that sits between the operating system and your web layer, that is a real risk. Security-sensitive defaults drift, bugs go unpatched, and the maintenance burden quietly shifts onto your team. Looking for a maintained capacitor community electron alternative is the sensible response, not a nice-to-have."}}, {"@type": "Question", "name": "What's different in the Capacitor Electron Platform?", "acceptedAnswer": {"@type": "Answer", "text": "The Capacitor Electron Platform takes a different approach to almost every one of those pain points. The core idea is that you should own as little runtime code as possible, while the platform maintainers own the parts that need regular updates. The table below compares the two platforms across the aspects that matter most during a migration. Aspect Community Electron Capacitor Electron Platform Maintenance status No longer actively maintained Actively maintained, released under MIT Runtime ownership You own a large generated Electron project You own a minimal scaffold; platform logic lives in the versioned npm package and updates via npm update Security defaults Configured manually in generated code Sandboxed renderer, context isolation, strict CSP, and validated IPC enabled by default Live Updates None Built-in serving primitive with failed-boot rollback Electron version Pinned to an older version Tracks the latest Electron, with a floor of Electron 28 The ownership row is the one that changes the most in practice. Because the heavy lifting lives inside @capawesome/capacitor-electron, a routine npm update pulls in security hardening, bug fixes, and support for newer Electron releases. You are no longer the sole maintainer of your desktop runtime. The security row matters just as much. The renderer runs sandboxed with context isolation, a strict Content Security Policy is applied, and IPC messages are validated. These defaults are mandatory and cannot be weakened, which removes a whole category of mistakes that were easy to make when you hand-edited a generated main process. There is also something genuinely new here. The Capacitor Electron Platform is the first Capacitor desktop platform with built-in Live Updates. It ships a provider-agnostic serving API together with a watchdog that rolls back to the last known-good bundle if a new one fails to boot. If you already deliver over-the-air updates on mobile, you can now extend the same idea to the desktop."}}, {"@type": "Question", "name": "How do you migrate to the Capacitor Electron Platform?", "acceptedAnswer": {"@type": "Answer", "text": "Migrating is mostly a matter of removing the old platform, adding the new one, and moving any custom code into the new extension points. The steps below walk through the full path. To keep things focused, the install details are kept short and linked rather than repeated in full, since the migration path is the interesting part here."}}, {"@type": "Question", "name": "What if a plugin has no Electron implementation?", "acceptedAnswer": {"@type": "Answer", "text": "This comes up often enough to call out on its own. If a plugin has no dedicated Electron implementation, the platform falls back to the plugin's web implementation, and in most cases that is exactly what you want. A large share of Capacitor plugins are perfectly happy running their web code inside the Electron renderer. When the web fallback is not enough, for example when a plugin needs true native desktop APIs, you have two options. You can implement the plugin against the new contract described in Step 4, or you can open an issue in the repository so the maintainers and community can help. Either way, you are not stuck."}}, {"@type": "Question", "name": "Is the Capacitor Electron Platform free?", "acceptedAnswer": {"@type": "Answer", "text": "Yes. @capawesome/capacitor-electron is licensed under MIT and is free to use in both open source and commercial projects."}}, {"@type": "Question", "name": "Do my existing plugins work?", "acceptedAnswer": {"@type": "Answer", "text": "Plugins with a web implementation work automatically through the platform's fallback mechanism. Only plugins that shipped a custom Electron implementation for the community platform need to be re-implemented against the new plugin contract."}}, {"@type": "Question", "name": "Which Capacitor and Electron versions are required?", "acceptedAnswer": {"@type": "Answer", "text": "The platform requires Capacitor 6 or later and Electron 28 or later. It tracks recent Electron releases, so you stay closer to the latest security patches over time."}}, {"@type": "Question", "name": "Can I keep my electron-builder config?", "acceptedAnswer": {"@type": "Answer", "text": "Yes. Packaging is handled by electron-builder, and your signing and notarization settings live in electron-builder.config.js. Existing configuration carries over with little to no change."}}, {"@type": "Question", "name": "How is this different from owning the generated project?", "acceptedAnswer": {"@type": "Answer", "text": "With the community platform you owned the entire generated Electron project. With the Capacitor Electron Platform you own only a minimal scaffold, while the runtime logic ships in the npm package and updates through npm update. Ready to move your desktop app onto a maintained platform and unlock Live Updates on the desktop? Give Capawesome Cloud a try and ship your Capacitor app with confidence. Try Capawesome Cloud Free"}}], "url": "https://capawesome.io/blog/capacitor-community-electron-migration/"} ```