This is a skeleton template for easily creating React-based Electron projects.
It is configured to experience fast development and build speed using Vite bundler. As a bonus, it includes several React utilities and layout configurations.
- β You can build immediately without any presets, so you can develop quickly.
- β
It is being maintained quickly to be compatible with the latest
ReactandElectron, as well as many modules. - β There is no need to worry about layout and data management by using various additional templates.
- β‘οΈ Rapid development through hot-reload
- β‘οΈ Cross-platform development and build support
- β‘οΈ Support for automated application testing
- β‘οΈ TypeScript support
- β‘οΈ Multilingual support
- β‘οΈ Support for themes (dark & light)
- β‘οΈ Basic layout manager
- β‘οΈ Global state management through the Redux store
- β‘οΈ Quick support through the GitHub community
-
For compile & build
viteelectronelectron-builder(Package builder)
-
For web development framework
reactreact-domreact-router-dom@redux/toolkit&react-redux(Global state management)typescript
-
For CSS Design
@mui/material(Material Design CSS Framework)@emotion/react
-
For Multilingual language support
i18next(Multilingual translation)
-
For development utils
eslint(Code syntax checking)eslint-plugin-react-hooksprettier
-
For testing
playwright
You can easily clone a repository with just the npm command. (Recommend)
$ npm init retronOR, Click Use this template to instantly create your own project.
OR, Clone this repo using below command.
$ git clone https://github.com/jooy2/retron <PROJECT_NAME>Then, install the dependency module.
# via npm
$ npm i
# via yarn (https://yarnpkg.com)
$ yarn install
# via pnpm (https://pnpm.io)
$ pnpm iYou can test your project in the development environment using the following command:
$ npm run devRetron can build targeting Windows 10 or later, macOS 14.x or later, and major Linux distributions.
# For Windows (.exe, .appx)
$ npm run build:win
# For macOS (.dmg)
$ npm run build:mac
# For Linux (.rpm, .deb, .snap)
$ npm run build:linuxThe built packages can be found in release/{version} location.
For projects that use the Native Node Module, add the following script to your package.json: When installing dependencies, electron-builder will take care of any modules that require rebuilding.
{
"scripts": {
"postinstall": "electron-builder install-app-deps"
}
}macOS is recommended if you want to build multiple platforms simultaneously on one platform. Because it can be configured with just a few very simple settings.
You can perform multi-platform builds at once with the following command. Alternatively, you can just do it for the OS you want via the individual build commands above.
$ npm run buildAlso check out the Vutron project, which consists of Vite + Vue 3 + Vuetify + Electron.
https://github.com/jooy2/vutron
Anyone can contribute to the project by reporting new issues or submitting a pull request. For more information, please see CONTRIBUTING.md.
Please see the LICENSE file for more information about project owners, usage rights, and more.