summaryrefslogtreecommitdiff
path: root/README.en.md
diff options
context:
space:
mode:
author韩丁康 <[email protected]>2024-01-08 08:25:16 +0000
committer韩丁康 <[email protected]>2024-01-08 08:25:16 +0000
commit364a34ebfd7a29f59230552aff12d373a3a52dee (patch)
tree9f9a8140374a498e39ca647db401a61ca7632e69 /README.en.md
parent9510639b494a416a2a1bc75988e7531c50153fb2 (diff)
修改READMEHEADmain
Diffstat (limited to 'README.en.md')
-rw-r--r--README.en.md163
1 files changed, 163 insertions, 0 deletions
diff --git a/README.en.md b/README.en.md
new file mode 100644
index 0000000..75a58dc
--- /dev/null
+++ b/README.en.md
@@ -0,0 +1,163 @@
+<div align="center">
+ <img alt="V3 Admin Vite Logo" width="120" height="120" src="./src/assets/layouts/logo.png">
+ <h1>V3 Admin Vite</h1>
+ <span>English | <a href="./README.zh-CN.md">中文</a></span>
+</div>
+
+## ⚡ Introduction
+
+V3 Admin Vite is a free and open source middle and background management system basic solution, based on mainstream framework such as Vue3, TypeScript, Element Plus, Pinia and Vite
+
+- Vue Cli 5.x: [v3-admin](https://github.com/un-pany/v3-admin)
+- Electron desktop: [v3-electron-vite](https://github.com/un-pany/v3-electron-vite)
+
+China repository: [Gitee](https://gitee.com/un-pany/v3-admin-vite)
+
+## 📚 Document
+
+- Chinese documentation: [link](https://juejin.cn/post/7089377403717287972)
+- Chinese getting started tutorial: [link](https://juejin.cn/column/7207659644487139387)
+
+## 📺 Online preview
+
+| Location | account | Link |
+| ------------ | ------------------- | ----------------------------------------------- |
+| github-pages | `admin` or `editor` | [link](https://un-pany.github.io/v3-admin-vite) |
+
+## ❤️ Generate electricity with love
+
+- **Completely free**:But hopefully you order a star !!!
+- **Very concise**:No complicated encapsulation, no complicated type gymnastics, out of the box
+- **Detailed annotations**:Each configuration item is written with as detailed comments as possible
+- **Latest dependencies**: Regularly update all third-party dependencies to the latest version
+- **Very specification**: The code style is unified, the naming style is unified, and the comment style is unified
+
+## Feature
+
+- **Vue3**:The latest Vue3 composition API using Vue3 + script setup
+- **Element Plus**:Vue3 version of Element UI
+- **Pinia**: An alternative to Vuex in Vue3
+- **Vite**:Really fast
+- **Vue Router**:router
+- **TypeScript**:JavaScript With Syntax For Types
+- **PNPM**:Faster, disk space saving package management tool
+- **Scss**:Consistent with Element Plus
+- **CSS variable**:Mainly controls the layout and color of the item
+- **ESlint**:Code verification
+- **Prettier**: Code formatting
+- **Axios**: Promise based HTTP client (encapsulated)
+- **UnoCSS**: Real-time atomized CSS engine with high performance and flexibility
+- **Mobile Compatible**: The layout is compatible with mobile page resolution
+
+## Functions
+
+- **User management**: log in, log out of the demo
+- **Authority management**: Built-in page permissions (dynamic routing), instruction permissions, permission functions
+- **Multiple Environments**: Development, Staging, Production
+- **Multiple themes**: Normal, Dark, Dark Blue, theme modes
+- **Multiple layouts**:Built-in left, top, left-top three layout modes
+- **Error page**: 403, 404
+- **Dashboard**: Display different Dashboard pages according to different users
+- **Other functions**:SVG, Dynamic Sidebar, Dynamic Breadcrumb Navigation, Tabbed Navigation, Screenfull, Adaptive Shrink Sidebar, HooK (Composables)
+
+## 🚀 Development
+
+```bash
+# configure
+1. installation of the recommended plugins in the .vscode directory
+2. node version 18.x or 20+
+3. pnpm version 8.x or latest
+
+# clone
+git clone https://github.com/un-pany/v3-admin-vite.git
+
+# enter the project directory
+cd v3-admin-vite
+
+# install dependencies
+pnpm i
+
+# start the service
+pnpm dev
+```
+
+## ✔️ Preview
+
+```bash
+# stage environment
+pnpm preview:stage
+
+# prod environment
+pnpm preview:prod
+```
+
+## 📦️ Multi-environment packaging
+
+```bash
+# build the stage environment
+pnpm build:stage
+
+# build the prod environment
+pnpm build:prod
+```
+
+## 🔧 Code inspection
+
+```bash
+# code formatting
+pnpm lint
+
+# unit test
+pnpm test
+```
+
+## Git commit specification reference
+
+- `feat` add new functions
+- `fix` Fix issues/bugs
+- `perf` Optimize performance
+- `style` Change the code style without affecting the running result
+- `refactor` Re-factor code
+- `revert` Undo changes
+- `test` Test related, does not involve changes to business code
+- `docs` Documentation and Annotation
+- `chore` Updating dependencies/modifying scaffolding configuration, etc.
+- `workflow` Work flow Improvements
+- `ci` CICD
+- `types` Type definition
+- `wip` In development
+
+## Project preview
+
+![preview1.png](./src/assets/docs/preview1.png)
+![preview2.png](./src/assets/docs/preview2.png)
+![preview3.png](./src/assets/docs/preview3.png)
+
+## 💕 Contributors
+
+Thanks to all the contributors!
+
+<a href="https://github.com/un-pany/v3-admin-vite/graphs/contributors">
+ <img src="https://contrib.rocks/image?repo=un-pany/v3-admin-vite" />
+</a>
+
+## 💕 Thanks star
+
+Small projects are not easy to get a star, if you like this project, welcome to support a star! This is the only motivation for the author to maintain it on an ongoing basis (whisper: it's free after all)
+
+## ☕ Donate
+
+[See how to donate](https://github.com/un-pany/v3-admin-vite/issues/69)
+
+## Group
+
+QQ group:1014374415 (left) && add me on WeChat,Invite you to join WeChat group (right)
+
+![qq.png](./src/assets/docs/qq.png)
+![wechat.png](./src/assets/docs/wechat.png)
+
+## 📄 License
+
+[MIT](./LICENSE)
+
+Copyright (c) 2022-present [pany](https://github.com/pany-ang)