Skip to content

Latest commit

 

History

History
160 lines (115 loc) · 5 KB

README.md

File metadata and controls

160 lines (115 loc) · 5 KB
Raw
V3 Admin Vite Logo

V3 Admin Vite

English | 中文

⚡ 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

China repository: Gitee

📚 Document

  • Chinese documentation: link
  • Chinese getting started tutorial: link

📺 Online preview

Location account Link
github-pages admin or editor link

❤️ 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 and out of the demo
  • Authority management: Page-level permissions (dynamic routing), button-level permissions (directive permissions, permission functions), and route navigation guards
  • Multiple Environments: Development, Staging, Production
  • Multiple themes: Normal, Dark, Dark Blue, three theme modes
  • Multiple layouts：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

# 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

# stage environment
pnpm preview:stage

# prod environment
pnpm preview:prod

📦️ Multi-environment packaging

# build the stage environment
pnpm build:stage

# build the prod environment
pnpm build:prod

🔧 Code inspection

# 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 preview2.png preview3.png

💕 Contributors

Thanks to all the contributors!

💕 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

Group

See how to join a group chat

📄 License

MIT

Copyright (c) 2022-present pany