# Vue3 Admin Electron 脚手架

**Repository Path**: darkwinoom/vue3-admin-electron-scaffold

## Basic Information

- **Project Name**: Vue3 Admin Electron 脚手架
- **Description**: Vue3 Admin 前端脚手架的 Electron 版本
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-07-04
- **Last Updated**: 2025-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Electron, TypeScript, vue3

## README

# Vue3 Admin Electron脚手架

在 [Vue3 Admin 前端脚手架](https://gitee.com/darkwinoom/vue3-admin-scaffold) 的基础上开发的 Electron 版本，完整保留原有功能，核心部分代码基本一致。

基于 [electron-pure-admin](https://github.com/pure-admin/electron-pure-admin) 二次开发。

![登录界面](./docs/login.png)

![内部界面](./docs/inner.png)

## 安装使用

本项目推荐使用 yarn 工具进行安装使用，Node.js 22 LTS

```sh
# 安装
yarn install

# 运行：桌面端 & 浏览器端
yarn dev

# 运行：仅浏览器端
yarn browser:dev

# 打包：桌面端
yarn build

# 打包：浏览器端
yarn browser:build

# 打包分析
yarn report
```

### 安装问题

若无法正常完成安装，可尝试以下解决方案：

```sh
# 设置镜像源
npm config set registry https://registry.npmmirror.com/
yarn config set registry https://registry.npmmirror.com/

# 调整超时时间
yarn config set network-timeout 60000

# 解决 electron 安装卡住问题
yarn config set electron_mirror https://npmmirror.com/mirrors/electron/
```

## 升级指引

本项目基于 [vue3-admin-scaffold](https://gitee.com/darkwinoom/vue3-admin-scaffold)，并针对桌面端进行了部分适配。

同时，本项目也会同步与 `vue3-admin-scaffold` 保持更新。您可以非常方便快捷的将原版移植为 Electron 版本。

## 开发方向

- [x] 实现项目 vue3-admin-scaffold 中全部功能，并持续同步更新
- [x] 适配多种分辨率（最底 1024 x 768）
- [x] 优化加载画面、异常处理与部分离线访问机制
- [x] 调整部分页面与功能，使其更适配桌面端操作习惯
- [ ] 支持应用内更新功能

待加入...

## Git 提交规范

- feat 增加新的业务功能
- fix 修复业务问题/BUG
- perf 优化性能
- style 更改代码风格, 不影响运行结果
- refactor 重构代码
- revert 撤销更改
- test 测试相关, 不涉及业务代码的更改
- docs 文档和注释相关
- chore 更新依赖/修改脚手架配置等琐事
- workflow 工作流改进
- ci 持续集成相关
- types 类型定义文件更改
- wip 开发中

## 附：参考文档

- [Vue3 Admin 前端脚手架](https://gitee.com/darkwinoom/vue3-admin-scaffold)
- [electron-pure-admin](https://github.com/pure-admin/electron-pure-admin)
- [Electron 官方文档](https://www.electronjs.org/zh/docs/latest/)