Moderate Admin (moderate-react-admin) is an open-source enterprise admin dashboard boilerplate for React, published by DLand-Team on GitHub, whose core function is to deliver a ready-to-run admin frontend that connects to the ruoyi-pro backend out of the box while supporting three UI ecosystems — Ant Design 5, Shadcn UI, and Material UI — plus a Next.js 15+ variant. The repository carried 525 GitHub stars at the time of writing and is documented in Chinese with a linked English README.
What is Moderate Admin?
Moderate Admin is a modern enterprise-grade admin frontend solution that runs on React 18 or React 19 and is organized as a turborepo monorepo built with TypeScript. It takes a ruoyi-pro style backend API as its input and produces a complete admin console — user management, role management, menu management, and code generation screens — with a dual-token authorization flow already wired in. The template is maintained by the DLand-Team and published on GitHub under a license file, with a PRs-welcome badge.
Key Features
The feature list is drawn directly from the README's core-features section and the component-library support matrix.
- ruoyi-pro integration — A built-in dual-token mechanism plus user, role, and menu management modules are already connected to ruoyi-pro, so the admin core works before any configuration.
- Three UI libraries in one codebase — A support matrix covers Ant Design 5, Shadcn UI, and Material UI; Antd is recommended for broad coverage and stability, Shadcn UI for lightweight and flexible builds, and Material UI for experienced developers with high customization needs.
- Next.js App-mode keepalive — The Next.js variant supports keepalive in App Router mode together with tab windows for multitasking workflows.
- Business plugin architecture — Components, Providers, routes, and i18n resources can be added as plugins, so business capabilities are reusable and removable.
- Enhanced routing system — KeepAlive and multi-tab pages are supported, and a useActive hook watches route activation state.
- Node.js-powered development tooling — Convention-based routing plus visual generation of routes and Redux state stores speed up scaffolding.
- Redux Toolkit state management — The Redux ecosystem is deeply integrated with concise syntax and TypeScript-friendly hints.
- Turborepo monorepo layout — The apps/ folder holds the frontend applications, including admin-antd and admin-shadcn-nextjs, while packages/ holds shared libraries, a dev-server, UI packages, and eslint/TypeScript configurations.
Who is it for?
Moderate Admin targets teams and developers who need an enterprise admin console on top of ruoyi-pro, or who want to compare multiple React UI ecosystems without maintaining separate codebases.
- Teams already running ruoyi-pro backends get a React admin with dual-token auth and core management pages pre-wired, removing the need to hand-build user, role, or menu screens.
- React developers wanting a layered admin scaffold benefit from clear business/UI separation, a plugin model, and Redux Toolkit as the standard, which suits codebases that will be extended over time.
- Next.js teams building on App Router can use the Shadcn UI-based admin with keepalive and multi-tab support instead of classic full-page reload patterns.
- Frontend platform teams shipping multiple admin products can reuse the packages/ shared libraries across Antd-based and Next.js-based apps inside one monorepo.
What can you do with Moderate Admin?
The concrete workflows below map directly to the advertised features.
- Ruoyi-pro backend teams: stand up user, role, and menu administration against an existing ruoyi backend in one run, using the included dual-token auth instead of writing login and permission code from scratch.
- Admin dashboard developers: build the same product with Antd, Shadcn UI, or Material UI from one codebase, choosing the strategy the README recommends per project.
- Multi-task application builders: enable Next.js App-mode keepalive and tab windows so page state survives tab switching in complex back-office workflows.
- Scaffolding-savvy developers: use the Node.js convention-based routing and visual generators to create routes and Redux stores, then plug in new features as components, providers, or i18n plugins.
How does Moderate Admin work?
The start-up flow is pnpm-based: install dependencies at the repo root, then either run pnpm run start or launch a specific app with pnpm --filter admin-antd dev. The default configuration points at the maintainer's test ruoyi server, so the project runs without local backend setup; for real work the README recommends building your own ruoyi-pro instance and connecting to it. The source is a turborepo monorepo with apps/ for the frontend applications, packages/ for shared libraries and tooling, frontend/ for frontend-related code, and _assets/ for documentation images.
Pros and cons
The trade-offs below come from the README's stated setup and defaults.
Pros
- Multi-UI support: Antd, Shadcn UI, and Material UI variants are maintained in one repository with a recommendation matrix.
- Pre-wired backend integration: dual-token auth and core management modules already speak the ruoyi-pro protocol.
- Plugin business model: components, providers, routes, and i18n are pluggable, so features can be shared and removed cleanly.
- Next.js App-mode keepalive and multi-tab support are built in.
Cons
- The primary README and documentation are in Chinese; the English README (README.en-US.md) is linked but secondary.
- The default backend is the maintainer's test server — suited to evaluation, not production; real deployments must connect their own ruoyi instance.
- All documented commands assume pnpm, so npm- or yarn-based workflows need an adapter.
Pricing
Moderate Admin is free and open source. The repository includes a LICENSE file, displays a PRs-welcome badge, and the README mentions no paid tiers or premium features.
Alternatives
Two established React admin scaffolds occupy a similar niche.
- Ant Design Pro — the official Ant Design team's admin scaffold, tied to the Antd ecosystem rather than offering a three-UI-choice matrix.
- React Admin — a data-provider-driven admin framework from marmelab that uses its own component architecture rather than a plugin-based multi-UI monorepo.
FAQ
Is Moderate Admin free?
Yes — the repository is published under a LICENSE file, displays a PRs-welcome badge, and the README mentions no paid tiers or premium features. All apps, including admin-antd and admin-shadcn-nextjs, are part of the same open source project.
Does Moderate Admin work with the ruoyi-pro backend?
Yes. The template's headline integration is ruoyi-pro: a built-in dual-token mechanism plus user, role, and menu management modules are already connected, so the admin core runs against a ruoyi-pro backend without additional configuration.
Which React versions and UI libraries are supported?
The template supports React 19 and React 18. The UI options are Ant Design 5, Shadcn UI, and Material UI. The Next.js track runs on Next.js 15+ and uses Tailwind CSS 4.x for styling, while the pure-frontend apps build with Rsbuild or Vite.
Is there a Next.js version of Moderate Admin?
Yes — the monorepo contains admin-shadcn-nextjs, a Next.js App Router application. It supports keepalive in App mode, multi-tab windows, and a Shadcn UI interface, sharing the same ruoyi-pro backend as the other apps.
Do I need my own backend to run the demo?
No. The project's default configuration connects to the maintainer's test ruoyi server, so it starts without any local setup. For local development the README recommends building your own ruoyi project, since the test server is for evaluation rather than production.
