mirror of
https://github.com/vbenjs/vue-vben-admin.git
synced 2025-01-23 09:40:25 +08:00
A modern vue admin panel built with Vue3, Shadcn UI, Vite, TypeScript, and Monorepo. It's fast!
admin-templateant-designelement-plusmonoreponaive-uishadcn-uitsxtypescriptvbenvitevite-templatevue-routervue3vuex
dcbe5510d4
* feat: update nginx.conf 使用固定编译入口可能导致浏览器使用缓存js文件,而此配置可以解决 * feat: 更新docker打包逻辑: 原本固定的entry是为了方便替换环境变量,同时在nginx配置内让每次获取js等资源都不走缓存。这样的问题是首次打开会很慢。 因此本次使用的解决方案,回归vben原本的hash+timestamp的入口文件名,但是在环境变量替换的时候使用模糊匹配。 大家有类似需要可以参考环境变量的方式做 单镜像打包多环境的适配。 |
||
---|---|---|
.github | ||
.husky | ||
.vscode | ||
apps | ||
internal | ||
mock | ||
packages | ||
public | ||
src | ||
types | ||
.browserslistrc | ||
.commitlintrc.js | ||
.dockerignore | ||
.editorconfig | ||
.env | ||
.env.analyze | ||
.env.development | ||
.env.docker | ||
.env.production | ||
.env.test | ||
.eslintignore | ||
.eslintrc.js | ||
.gitattributes | ||
.gitignore | ||
.gitpod.yml | ||
.npmrc | ||
.prettierignore | ||
.prettierrc.js | ||
.stylelintignore | ||
.stylelintrc.js | ||
CHANGELOG.en_US.md | ||
CHANGELOG.md | ||
CHANGELOG.zh_CN.md | ||
CNAME | ||
Dockerfile | ||
index.html | ||
LICENSE | ||
nginx.conf | ||
package.json | ||
pnpm-lock.yaml | ||
pnpm-workspace.yaml | ||
README.md | ||
README.zh-CN.md | ||
tsconfig.json | ||
turbo.json | ||
uno.config.ts | ||
vite.config.ts |
English | 中文
Introduction
Vue Vben Admin is a free and open source middle and back-end template. Using the latest vue3
, vite4
, TypeScript
and other mainstream technology development, the out-of-the-box middle and back-end front-end solutions can also be used for learning reference.
Feature
- State of The Art Development:Use front-end front-end technology development such as Vue3/vite2
- TypeScript: Application-level JavaScript language
- Theming: Configurable themes
- International:Built-in complete internationalization program
- Mock Server Built-in mock data scheme
- Authority Built-in complete dynamic routing permission generation scheme.
- Component Multiple commonly used components are encapsulated twice
Preview
- vue-vben-admin - Full version Chinese site
- vue-vben-admin-gh-pages - Full version of the github site
- vben-admin-thin-next - Simplified Chinese site
- vben-admin-thin-gh-pages -Simplified github site
Test account: vben/123456
Use Gitpod
Open the project in Gitpod (free online dev environment for GitHub) and start coding immediately.
Documentation
Preparation
- node and git - Project development environment
- Vite - Familiar with vite features
- Vue3 - Familiar with Vue basic syntax
- TypeScript - Familiar with the basic syntax of
TypeScript
- Es6+ - Familiar with es6 basic syntax
- Vue-Router-Next - Familiar with the basic use of vue-router
- Ant-Design-Vue - ui basic use
- Mock.js - mockjs basic syntax
Install and use
- Get the project code
git clone https://github.com/anncwb/vue-vben-admin.git
- Installation dependencies
cd vue-vben-admin
pnpm install
- run
pnpm serve
- build
pnpm build
- docker
The dockerFile is located in the project root directory and supports differential deployment
build image
docker build -t vue-vben-admin .
Environment variables are dynamically used to achieve differentiated container deployment. Different VG_BASE_URL environment variables point to different back-end service addresses. In the following example, http://localhost:3333 is used as the back-end service address and the container is mapped to port 6666
docker run --name vue-vben-admin -d -p 6666:80 -e VG_BASE_URL=http://localhost:3333 vue-vben-admin
Then you can navigate http://localhost:6666
Change Log
Project
- vue-vben-admin - full version
- vue-vben-admin-thin-next - Simplified version
How to contribute
You are very welcome to join!Raise an issue Or submit a Pull Request。
Pull Request:
- Fork code!
- Create your own branch:
git checkout -b feat/xxxx
- Submit your changes:
git commit -am 'feat(function): add xxxxx'
- Push your branch:
git push origin feat/xxxx
- submit
pull request
Git Contribution submission specification
-
reference vue specification (Angular)
feat
Add new featuresfix
Fix the problem/BUGstyle
The code style is related and does not affect the running resultperf
Optimization/performance improvementrefactor
Refactorrevert
Undo edittest
Test relateddocs
Documentation/noteschore
Dependency update/scaffolding configuration modification etc.workflow
Workflow improvementsci
Continuous integrationtypes
Type definition file changeswip
In development
Related warehouse
If these plugins are helpful to you, you can give a star support
- vite-plugin-mock - Used for local and development environment data mock
- vite-plugin-html - Used for html template conversion and compression
- vite-plugin-compression - Used to pack input .gz|.brotil files
- vite-plugin-svg-icons - Used to quickly generate svg sprite
Browser support
The Chrome 80+
browser is recommended for local development
Support modern browsers, not IE
IE |
Edge |
Firefox |
Chrome |
Safari |
---|---|---|---|---|
not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |