Go to file
Steve Zhu 62956e3894
fix: externalize electron via ssr.external for Vite 8
In Vite 8, rollupOptions.external is not honored when rolldownOptions
exists separately. Use ssr.external to ensure electron is externalized
in both main and preload SSR builds, since ssr.external takes
precedence over ssr.noExternal for specified packages.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-04-04 19:32:00 -04:00
.github chore: add funding 2025-05-10 17:58:35 +08:00
.vscode chore: improve prettier config 2023-12-07 22:35:38 +08:00
bin fix(deps)!: update Vite to v7 and remove cjs build 2025-06-28 13:08:38 +08:00
scripts chore: allow breaking commit message 2025-06-27 23:07:33 +08:00
src fix: externalize electron via ssr.external for Vite 8 2026-04-04 19:32:00 -04:00
.editorconfig chore: init 2022-03-17 16:21:02 +08:00
.gitignore chore: move to eslint flat config 2025-01-22 00:47:48 +08:00
.prettierignore chore: init 2022-03-17 16:21:02 +08:00
.prettierrc.yaml chore: init 2022-03-17 16:21:02 +08:00
CHANGELOG.md release: v5.0.0 2025-12-07 22:26:56 +08:00
CODE_OF_CONDUCT.md chore: init 2022-03-17 16:21:02 +08:00
CONTRIBUTING.md chore: update contributing 2022-07-03 15:31:37 +08:00
eslint.config.js chore: replace tseslint.config with defineConfig 2025-10-17 21:29:48 +08:00
LICENSE chore: init 2022-03-17 16:21:02 +08:00
node.d.ts chore: update eslint config 2025-10-17 21:28:47 +08:00
package.json feat: add Vite 8 support 2026-04-04 17:05:17 -04:00
pnpm-lock.yaml chore(deps): update cac to v7 2026-03-29 15:20:31 +08:00
README.md docs: update 2025-11-09 23:31:08 +08:00
rollup.config.ts fix: Typescript compiler option 'outDir' must be located inside Rollup 'dir' option 2026-03-29 15:22:06 +08:00
tsconfig.json refactor!: bump required node version to 20.19+, 22.12+ 2025-06-27 23:10:23 +08:00

electron-vite

Next generation Electron build tooling based on Vite

license

Documentation | Getting Started | create-electron

中文文档



Features

  • ⚡️ Vite powered and use the same way.
  • 🛠 Pre-configure with sensible defaults optimized for Electron.
  • 💡 Optimize asset handling for Electron main process.
  • 🚀 Fast HMR & hot reloading.
  • 🔥 Isolated build for multi-entry application development.
  • ✨ Simplify multi-threading development.
  • 🔒 Compile code to v8 bytecode to protect source code.
  • 🔌 Easy to debug in IDEs such as VSCode or WebStorm.
  • 📦 Out-of-the-box support for TypeScript, Vue, React, Svelte, SolidJS and more.

Usage

Install

npm i electron-vite -D

Development & Build

In a project where electron-vite is installed, you can use electron-vite binary directly with npx electron-vite or add the npm scripts to your package.json file like this:

{
  "scripts": {
    "start": "electron-vite preview",
    "dev": "electron-vite dev",
    "prebuild": "electron-vite build"
  }
}

Configuration

When running electron-vite from the command line, electron-vite will automatically try to resolve a config file named electron.vite.config.js inside project root. The most basic config file looks like this:

// electron.vite.config.js
export default {
  main: {
    // vite config options
  },
  preload: {
    // vite config options
  },
  renderer: {
    // vite config options
  }
}

Getting Started

Clone the electron-vite-boilerplate or use the create-electron tool to scaffold your project.

npm create @quick-start/electron@latest

Currently supported template presets include:

JavaScript TypeScript
vanilla vanilla-ts
vue vue-ts
react react-ts
svelte svelte-ts
solid solid-ts

Contribution

See Contributing Guide.

License

MIT © alex.wei