lixuechuan
/
electron-vite-react
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs: refactor text 

Decided to give it a fresh look and made a lot of stuff more understandable and user-friendly. Added debugger to the Overview. Added emojis to the
This commit is contained in:
Paul 2022-07-20 18:51:53 +03:00 committed by GitHub
parent b0876e1b2a
commit d8387de901
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 17 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
README.md
View File

@ -8,16 +8,17 @@
English | [简体中文](README.zh-CN.md) English | [简体中文](README.zh-CN.md)
## Overview ## 👀 Overview
📦 Out of the box 📦 Ready out of the box
🎯 Based on the official [react-ts](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) template, less invasive 🎯 Based on the official [react-ts](https://github.com/vitejs/vite/tree/main/packages/create-vite/template-react-ts) template, project structure will be familiar to you
🌱 Extensible, really simple directory structure 🌱 Easily extendable and customizable
💪 Support using Node.js API in Electron-Renderer 💪 Supports Node.js API in the renderer process
🔩 Support C/C++ native addons 🔩 Supports C/C++ native addons
🖥 It's easy to implement multiple windows 🪲 Debugger configuration included
🖥 Easy to implement multiple windows
## Quick start ## 🛫 Quick start
```sh ```sh
npm create electron-vite npm create electron-vite
@ -25,13 +26,14 @@ npm create electron-vite
![electron-vite-react.gif](https://github.com/electron-vite/electron-vite-react/blob/main/public/electron-vite-react.gif?raw=true) ![electron-vite-react.gif](https://github.com/electron-vite/electron-vite-react/blob/main/public/electron-vite-react.gif?raw=true)
## Debug ## 🪲 Debug
![electron-vite-react-debug.gif](https://github.com/electron-vite/electron-vite-react/blob/main/public/electron-vite-react-debug.gif?raw=true) ![electron-vite-react-debug.gif](https://github.com/electron-vite/electron-vite-react/blob/main/public/electron-vite-react-debug.gif?raw=true)
## Directory structure ## 📂 Directory structure
*🚨 By default, the files in `electron` folder will be built into the `dist/electron`* Familiar React application structure, just with `electron` folder on the top :wink:
*Files in this folder will be separated from your React application and built into `dist/electron`*
```tree ```tree
├── electron Electron-related code ├── electron Electron-related code
@ -54,7 +56,9 @@ npm create electron-vite
## 🚨 Be aware ## 🚨 Be aware
By default, this template integrates Node.js in the Renderer process. If you don't need it, you just remove the option below. [Because it will modify the default config of Vite](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#config-presets-opinionated). This template integrates Node.js API to the renderer process by default. If you want to follow **Electron Security Concerns** you might want to disable this feauture. You will need to expose needed API by yourself.
To get started, remove the option as shown below. This will [modify the Vite configuration and disable this feature](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#config-presets-opinionated).
```diff ```diff
# vite.config.ts # vite.config.ts
@ -64,7 +68,7 @@ electron({
}) })
``` ```
## FAQ ## ❔ FAQ
- [dependencies vs devDependencies](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#dependencies-vs-devdependencies) - [dependencies vs devDependencies](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#dependencies-vs-devdependencies)
- [Using C/C++ native addons in Electron-Renderer](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#load-nodejs-cc-native-modules) - [Using C/C++ native addons in Electron-Renderer](https://github.com/electron-vite/vite-plugin-electron/tree/main/packages/electron-renderer#load-nodejs-cc-native-modules)