Skip to content

ruoyi-vue-pro

Java admin-system template (Spring Boot + Vue) with permissions, workflow, multi-tenancy and many business mod

Stars
40.2k
Forks
8.6k
Licence
MIT
Language
Java
Last update
5 days ago
Type
Framework

What it is

RuoYi-Vue-Pro is a large open-source starting point for building back-office admin systems, built on Spring Boot, MyBatis Plus and Vue with Element UI or Element Plus. The README lists features such as role-based and data-level permissions, SaaS multi-tenancy, Flowable workflow, a code generator, and optional modules for e-commerce, CRM, ERP, IoT and AI. Developers typically use it as a base to adapt rather than a finished product.

  • Start an internal admin dashboard with user, role and menu management
  • Adapt the built-in workflow engine for approval processes
  • Use the code generator to create Java and Vue CRUD code from database tables
  • Run a multi-tenant admin system where each tenant has its own permissions

Great for

  • Java developers building an internal admin or back-office system
  • Teams that want a starting point with login, permissions and workflow already wired up
  • Projects needing multi-tenant (SaaS) admin features
  • Developers who want a code generator to scaffold CRUD pages from database tables

Not ideal for

  • Non-Java teams, since the backend is Java and Spring Boot (reason: you would need to learn that stack)
  • Small projects that only need a simple site or a few pages (reason: the codebase and module count are large)
  • Anyone wanting the lightest possible version, unless they use the mini edition (reason: the full edition includes many modules that add complexity)
Step-by-step guide: how to use ruoyi-vue-proInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Clone and build from source

    You'll need: JDK (version depends on branch: JDK 8, 17/21 or 25) · MySQL (default database) · Redis

    Clone the repository

    git clone https://github.com/YunaiV/ruoyi-vue-pro
  2. 2

    Run it

    • Choose the branch matching your JDK version (master for JDK 8, master-jdk17 for 17/21, master-jdk25 for 25)
    • Create the database using the scripts in the sql directory for your database
    • Configure database and Redis connection settings, then start the backend
    • Start the Vue frontend and log in to the admin dashboard
    • Follow the quick-start guide at doc.iocoder.cn for detailed steps
  3. 3

    Get the most out of it

    • Use the code generator to scaffold CRUD pages for new business tables
    • Use the 'yudao-boot-mini' edition if you only need system and infrastructure features
    • Review the dynamic permission and multi-tenant sections before designing your access model
    • Check the official docs at doc.iocoder.cn for the migration and deployment guides

Downloads

Strengths

  • Broad built-in feature set, documented in the README
  • MIT license and the README states the project is fully open source
  • Active maintenance with a recent push and multiple version branches for different JDK versions

Trade-offs

  • Very large scope, so learning the full codebase takes time
  • Main documentation and demos are on Chinese sites, and much of the README is in Chinese
  • The README lists many optional modules; you need to choose the edition that fits your needs

How it compares

ProjectStarsTypeLevelUpdatedBest for
ruoyi-vue-pro (this)40.2kFrameworkadvanced5 days agoJava developers building an internal admin or back-office system
vue-element-admin90.1kOtherintermediate2.0 years agoDevelopers building internal admin dashboards in Vue
yudao-cloud19.7kAppadvanced5 days agoJava teams building internal business or admin systems
SpringAll28.9kLearning resourcebeginner2.4 years agoDevelopers who read Chinese and want to learn Spring Boot step by step
zfile10.9kAppintermediate4 days agoIndividuals or small teams who already have files spread across several cloud storage services
nuxt61kLibraryintermediate4 days agoDevelopers who already know Vue.js and want a structured full-stack setup

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.