Electron & Vite Template

Language: 🇨🇳 中文 | 🇷🇺 Russian | ✅ 🇺🇸 English (current)

---

• Electron & Vite Template
  • Installation
  • Build Configuration
    • Linux
    • Windows
    • Main Steps
    • Build for Windows
      • NSIS Options Explanation:
  • Feature List
  • Included

Installation

You can clone the project or fork the repository, or download it as a ZIP archive. Cloning is recommended so you can receive updates.

To run the project you need Node.js version 22+ and use npm as the dependency manager.

Documentation (Chinese only)

Build Configuration

Linux

• Install package manager

apt install npm

• Update Node.js to latest LTS (recommended >=18):

via NodeSource (Debian/Ubuntu/Kali)

# remove old node
sudo apt remove -y nodejs npm libnode-dev
sudo apt autoremove -y

# install new Node.js
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# check version (>=22)
node -v

# cleanup before reinstall
rm -rf node_modules package-lock.json
npm cache clean --force

# install snap build (not fully tested)
sudo snap install build/electron-vite-template-ru_1.0.0_amd64.snap --dangerous

# remove snap build
sudo snap remove electron-vite-template-ru

# build Debian package
npm run build:linux

# install Debian package
sudo dpkg -i build/electron-vite-template-ru_1.0.0_amd64.deb

# remove Debian package
sudo dpkg -r electron-vite-template-ru

# diagnostics
journalctl -xe | grep electron-vite-template-ru

Windows

• Install latest Node.js

Main Steps

Clone repository

git clone https://github.com/Dvurechensky-Templates/electron-vite-template-ru.git

Enter directory

cd electron-vite-template-ru

Install dependencies

npm i

Run dev server (auto reload) at http://localhost:9080

npm run dev

Build production app

npm run build

Build for Windows

1. Explanation of build.json parameters

NSIS Options Explanation:

• oneClick: false → user sees installation steps
• perMachine: false → install for current user only (set true for all users)
• allowElevation: true → request admin rights if needed
• allowToChangeInstallationDirectory: true → user can choose install path
• createDesktopShortcut / createStartMenuShortcut → create shortcuts

---

Feature List

• Auto update
• Incremental updates
• Loading animation before startup
• Localization — i18n

Included

• vue-router Routing module for Vue that allows navigation between pages and URL state management in SPA.

• pinia Modern state management for Vue — lightweight, type-safe, and scalable.

• electron Framework for building cross-platform desktop applications using web technologies (HTML, CSS, JS).

• electron-updater Auto-update tool for Electron apps: checks for updates, downloads, and installs them.

• typescript Superset of JavaScript with static typing, making code more reliable and maintainable.