Repolode
soybeanjs

soybeanjs/soybean-admin

A Vue 3, Vite, TypeScript and Naive UI admin template with theming, i18n, file-based routing and a built-in CLI for back-office apps.

Stars
15,148
Forks
2,521
Open issues
7
Last commit
yesterday

What is it?

SoybeanAdmin is an admin dashboard template built on Vue 3, Vite, TypeScript, Pinia, Naive UI and UnoCSS. It provides a ready-made layout with pages for 403, 404 and 500 errors, tab and theme configuration components, and mobile-responsive styling, so teams can start building management interfaces without assembling the basics themselves.

The project uses a pnpm monorepo and includes an automatic file-based routing system that generates route imports, declarations and types through the Elegant Router tool. Routing supports both static frontend routes and dynamic routes from a backend, and internationalization is built in. Code quality tooling covers ESLint, oxlint, oxfmt and Git hooks, and a bundled command-line tool handles commits, file deletion and releases.

The template is MIT licensed. Its README notes that version 2.3 is the last maintained major release of the 2.x line and that new work is moving to a 3.0 version under development.

Key features

  • 01Built on Vue 3, Vite, TypeScript, Pinia and UnoCSS.
  • 02Automatic file-based routing that generates route types.
  • 03Static and backend-driven dynamic permission routes.
  • 04Built-in internationalization, theme configuration and multiple page templates.
  • 05Command-line tool for conventional commits and releases.
  • 06Responsive layout for mobile browsers.

Use cases

  • Starting an internal back-office or admin dashboard with Vue 3.
  • Learning a modern Vue stack with routing, state and theming in one project.
  • Building a management system that needs static or backend-driven permissions.

Quick start

  1. 1

    Clone the project repository

    git clone https://github.com/soybeanjs/soybean-admin.git
  2. 2

    Install dependencies with pnpm (do not use npm or yarn)

    pnpm i
  3. 3

    Start the development server

    pnpm dev

Things to know

  • Requires Node.js 20.19.0 or higher and pnpm 10.5.0 or higher; npm and yarn are not supported for installs.
  • Version 2.3 is the last maintained major release of the 2.x line, and new features are planned for the 3.0 rewrite, which is still in development.

Topics

FAQ

What is soybean-admin?
A Vue 3, Vite, TypeScript and Naive UI admin template with theming, i18n, file-based routing and a built-in CLI for back-office apps. SoybeanAdmin is an admin dashboard template built on Vue 3, Vite, TypeScript, Pinia, Naive UI and UnoCSS. It provides a ready-made layout with pages for 403, 404 and 500 errors, tab and theme configuration components, and mobile-responsive styling, so teams can start building management interfaces without assembling the basics themselves.
Is soybean-admin free to use? What license does it have?
soybean-admin is open source under the MIT license. Check the license terms before using it in commercial products.
Is soybean-admin still maintained?
Actively maintained. The last commit to soybean-admin was on Oct 21, 2026.
What can I use soybean-admin for?
Starting an internal back-office or admin dashboard with Vue 3. Learning a modern Vue stack with routing, state and theming in one project. Building a management system that needs static or backend-driven permissions.
How do I install soybean-admin?
Clone the project repository: git clone https://github.com/soybeanjs/soybean-admin.git Install dependencies with pnpm (do not use npm or yarn): pnpm i Start the development server: pnpm dev
Where can I get soybean-admin?
The source code and installation instructions are on GitHub: https://github.com/soybeanjs/soybean-admin

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects