mirror of
https://github.com/alex8088/electron-vite.git
synced 2026-07-03 02:08:10 +08:00
4f18a50382
Add Electron 42 to the node/chrome build target tables and lazily download the electron binary when path.txt is missing on Electron 42+, since the upstream package no longer downloads itself via postinstall (supply-chain hardening). This mirrors the behavior of `npx electron`, so users do not need to add a manual `install-electron` postinstall script. close #904
108 lines
4.5 KiB
Markdown
108 lines
4.5 KiB
Markdown
<p align="center">
|
|
<img src="https://alex8088.github.io/assets/electron-vite.svg" width="150px" height="150px">
|
|
</p>
|
|
|
|
<div align="center">
|
|
<h1>electron-vite</h1>
|
|
</div>
|
|
<p align="center">Next generation Electron build tooling based on Vite</p>
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/npm/v/electron-vite?color=6988e6&label=version">
|
|
<img src="https://img.shields.io/github/license/alex8088/electron-vite?color=blue" alt="license" />
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://electron-vite.org">Documentation</a> |
|
|
<a href="https://electron-vite.org/guide">Getting Started</a> |
|
|
<a href="https://github.com/alex8088/quick-start/tree/master/packages/create-electron">create-electron</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://cn.electron-vite.org">中文文档</a>
|
|
</p>
|
|
|
|
<br />
|
|
<br />
|
|
|
|
## Features
|
|
|
|
- ⚡️ [Vite](https://vitejs.dev) 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
|
|
|
|
```sh
|
|
npm i electron-vite -D
|
|
```
|
|
|
|
> **Note:** Starting with [Electron 42](https://www.electronjs.org/blog/electron-42-0), the `electron` package no longer downloads its binary via `postinstall`. You do not need to add an `install-electron` postinstall script — `electron-vite` will download the binary on demand the first time you run `dev`, `build`, or `preview`, mirroring the behavior of `npx electron`.
|
|
|
|
### 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:
|
|
|
|
```json
|
|
{
|
|
"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:
|
|
|
|
```js
|
|
// 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](https://github.com/alex8088/electron-vite-boilerplate) or use the [create-electron](https://github.com/alex8088/quick-start/tree/master/packages/create-electron) tool to scaffold your project.
|
|
|
|
```bash
|
|
npm create @quick-start/electron@latest
|
|
```
|
|
|
|
Currently supported template presets include:
|
|
|
|
| JavaScript | TypeScript |
|
|
| :--------------------------------------------------------------------------------------------------------: | :--------------------------------------------------------------------------------------------------------------: |
|
|
| [vanilla](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vanilla) | [vanilla-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vanilla-ts) |
|
|
| [vue](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vue) | [vue-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/vue-ts) |
|
|
| [react](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/react) | [react-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/react-ts) |
|
|
| [svelte](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/svelte) | [svelte-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/svelte-ts) |
|
|
| [solid](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/solid) | [solid-ts](https://github.com/alex8088/quick-start/tree/master/packages/create-electron/playground/solid-ts) |
|
|
|
|
## Contribution
|
|
|
|
See [Contributing Guide](CONTRIBUTING.md).
|
|
|
|
## License
|
|
|
|
[MIT](./LICENSE) © alex.wei
|