SoybeanAdmin
A Vue 3 admin dashboard template with TypeScript, Vite, Pinia, Naive UI and UnoCSS.
- Stars
- 15.2k
- Forks
- 2.5k
- Licence
- MIT
- Language
- TypeScript
- Last update
- 16 days ago
- Type
- Library
What it is
SoybeanAdmin is a starter template for building back-office admin panels, the kind of web app used to manage users, data and settings. It is built on Vue 3, Vite, TypeScript, Pinia, Naive UI and UnoCSS, and includes layouts, themes, internationalization, automatic file-based routing, and sample pages such as 403, 404 and 500. Developers use it as a ready-made starting point so they do not have to set up these pieces themselves.
- Start a new admin dashboard with login, menus, and role-based page access
- Customize the theme and layout using the built-in theme configuration
- Add multi-language support using the built-in internationalization setup
- Use the built-in mock data approach to build front-end pages before a backend exists
Great for
- Developers starting a new internal admin or back-office web app with Vue 3
- Teams that want TypeScript, linting and a monorepo structure already configured
- Developers who want to learn a modern Vue stack through a working example
- Projects that need both static and backend-driven permission routing
Not ideal for
- Non-developers looking for a finished tool to install and use without coding; it is a template to build from
- Teams on Vue 2 or React, since this is a Vue 3 project (a React version exists separately)
- Projects that need the 2.x line long-term, since the README says 2.3 is the last maintained major version and new features are going into 3.0
How to get it
- 1
Clone and build from source
You'll need: git · Node.js 20.19.0 or higher · pnpm 10.5.0 or higher
Clone the repository
git clone https://github.com/soybeanjs/soybean-admin.gitInstall dependencies
pnpm i - 2
Run it
- Clone the repository from GitHub or one of the mirror sites listed in the README
- Run pnpm i in the project folder to install dependencies
- Run pnpm dev to start the development server
- Run pnpm build when you are ready to produce a production build
- 3
Get the most out of it
- Read the official documentation at docs.soybeanjs.cn for setup and customization details
- Use the built-in command-line tool for git commits, file deletion and releases, as described in the features list
- Use the automatic file-based routing system (Elegant Router) to avoid hand-writing route imports and types
- Watch the Bilibili video series linked in the README for a guided walkthrough
Downloads
Strengths
- Uses a current, widely used front-end stack with TypeScript support
- Includes many ready-made pages, layouts and tooling such as linting and a command-line helper
- Has a large community, with about 15,000 GitHub stars and a MIT license
Trade-offs
- The README says the 2.x line is ending maintenance and 3.0 is still in development, so the project's future direction is changing
- Requires pnpm for installs; npm and yarn are discouraged by the README
- Documentation is primarily in Chinese; the English README is a separate file and was not reviewed here
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| soybean-admin (this) | 15.2k | Library | intermediate | 16 days ago | Developers starting a new internal admin or back-office web app with Vue 3 |
| vue-vben-admin | 33.7k | App | intermediate | 4 days ago | Developers starting a new Vue 3 admin or back-office project |
| vue-admin-better | 18.9k | App | intermediate | 17 days ago | Front-end developers with about a year of experience who want an admin panel starting point |
| vue-element-admin | 90.1k | Other | intermediate | 2.0 years ago | Developers building internal admin dashboards in Vue |
| iview-admin | 16.3k | App | intermediate | 4.5 years ago | Developers building an internal admin panel on Vue 2 |
| ant-design-vue-pro | 10.9k | App | intermediate | 1.1 years ago | Developers building internal admin panels or dashboards on Vue 2 |
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.