• English

      • Compatibility

      Describes Rselectron compatibility-related content.

      Electron versions

      Rselectron freezes an Electron support window per release: a fixed floor at Electron 28 (the first ESM-capable major) and a rolling top at the three stable majors current at release time (today: 43). The window is 28–43, and the optional peer range is >=28 <44. Release metadata, docs, and CI use the same frozen window; it does not drift after publication. The frozen window is maintained as a compatibility matrix with CI-gated evidence.

      You can also read it from the package:

      import { ELECTRON_SUPPORT_SNAPSHOT } from '@rselectron/core';

      Rsbuild versions

      @rsbuild/core is a required project peer (^2.0.0 install contract) that the application declares. npm 7+ and pnpm 8+ auto-install required peers, so a manual declaration is only needed for other package managers (for example yarn classic or bun, or any layout where auto-install is disabled).

      Each Rselectron release also freezes an Rsbuild tested window: the minor line of the @rsbuild/core version that release was tested against (tested 2.1.7 → window >=2.1.0 <2.2.0). Patch updates within the tested minor line are presumed safe and produce no output. A project-local @rsbuild/core outside the window produces a warn-only RSELECTRON_RSBUILD_UNTESTED diagnostic across dev, build, inspect, and preview — never a hard error, because the application owns its build tool. This contrasts with the Electron versions window above, where out-of-window versions are hard-rejected because Rselectron derives compiler targets from per-major Electron metadata.

      electron-Vite

      Rselectron does not align its API; it is not a drop-in replacement for electron-vite. It targets best-effort capability parity against the electron-vite 6 baseline to ease migration for electron-vite users.

      Compared with electron-vite, these capabilities are intentionally out of scope:

      CapabilityRselectron stance
      Vite pluginsNot accepted or translated — use Rsbuild / Rspack plugins
      V8 bytecode compilationNot implemented — no silent fallback
      electron-vite SWC helpersNot exported — configure SWC via Rsbuild / Rspack

      See Migration for a semantic mapping checklist.

      Hosts and packaging

      Hosts cover macOS, Linux, and Windows (x64 / arm64) where CI hardware exists. Host support does not mean native addons can be cross-compiled.

      Rselectron covers development and source builds only. Consuming outputs with electron-builder, Electron Forge, and similar tools is expected; Rselectron does not produce installers.

      Frontend frameworks

      Vanilla and React are the official examples under examples/. Other UI frameworks work through normal Rsbuild plugins.