JzwOnly/WorkStation

electron-vue-vite

English | 简体中文

🥳 Very simple Electron + Vue3 + Vite2 boilerplate.

Overview

This is an Electron category integration template that pursues simplification.
This contains only the most basic files, the most basic dependencies, and the most basic functions. Instead of large and complex design.
The purpose of this is to ensure that the template is flexible enough.

For all that, I still hope that you have a basic understanding for Electron Vite. Because in addition to the simple structure of the project, the README also appears too simplify.

You can learn more details by looking at the source code. Trust me, this template is the simple enough. 😋

Run Setup

# clone the project
git clone https://github.com/caoxiemeihao/electron-vue-vite.git

# enter the project directory
cd electron-vue-vite

# install dependency
npm install

# develop
npm run dev

Directory

Once dev or build npm-script executed will be generate named dist folder. It has children dir of same as packages folder, the purpose of this design can ensure the correct path calculation.

├
├── dist                      After build, it's generated according to the "packages" directory
├   ├── main
├   ├── preload
├   ├── renderer
├
├── scripts
├   ├── build.mjs             Develop script -> npm run build
├   ├── watch.mjs             Develop script -> npm run dev
├
├── packages
├   ├── main                  Main-process source code
├       ├── vite.config.ts
├   ├── preload               Preload-script source code
├       ├── vite.config.ts
├   ├── renderer              Renderer-process source code
├       ├── vite.config.ts
├

Use Electron, NodeJs API

🚧 By default, Electron don't support the use of API related to Electron and NodeJs in the Renderer-process, but someone still need to use it. If so, you can see the template 👉 electron-vite-boilerplate

All Electron, NodeJs API invoke passed Preload-script

• packages/preload/index.ts

  import fs from 'fs'
  import { contextBridge, ipcRenderer } from 'electron'
  
  // --------- Expose some API to Renderer-process. ---------
  contextBridge.exposeInMainWorld('fs', fs)
  contextBridge.exposeInMainWorld('ipcRenderer', ipcRenderer)

• packages/renderer/src/global.d.ts

  // Defined on the window
  interface Window {
    fs: typeof import('fs')
    ipcRenderer: import('electron').IpcRenderer
  }

• packages/renderer/src/main.ts

  // Use Electron, NodeJs API in Renderer-process
  console.log('fs', window.fs)
  console.log('ipcRenderer', window.ipcRenderer)

Use SerialPort, SQLite3 or other node-native addons in Main-process

• First, yout need to make sure the deps in "dependencies". Because the project still needs it after packaged.

• Main-process, Preload-script are also built with Vite, and they are just built as build.lib.
  So they just need to configure Rollup.

Click to see more 👉 packages/main/vite.config.ts

export default {
  build: {
    // built lib for Main-process, Preload-script
    lib: {
      entry: 'index.ts',
      formats: ['cjs'],
      fileName: () => '[name].js',
    },
    rollupOptions: {
      // configuration here
      external: [
        'serialport',
        'sqlite3',
      ],
    },
  },
}

dependencies vs devDependencies

• First, you need to know if deps(npm package) are still needed after packaged.

• Like serialport, sqlite3 they are node-native module and should be placed in dependencies. In addition, Vite will not build them, but treat them as external modules.

• Like vue, react they are pure javascript module and can be built with Vite, so they can be placed in devDependencies. This reduces the volume of the built project.

Main window

Wechat