MCPcopy
hub / github.com/soybeanjs/soybean-admin

github.com/soybeanjs/soybean-admin @tauri-v2.2.0 sqlite

repository ↗ · DeepWiki ↗ · release tauri-v2.2.0 ↗
370 symbols 840 edges 134 files 102 documented · 28%
README
<img src="https://github.com/soybeanjs/soybean-admin/raw/tauri-v2.2.0/public/favicon.svg" width="160" />
<h1>SoybeanAdmin</h1>

中文 | English


license github stars github forks gitee stars gitcode star

soybeanjs%2Fsoybean-admin | Trendshift Featured|HelloGitHub

[!NOTE] If you think SoybeanAdmin is helpful to you, or you like our project, please give us a ⭐️ on GitHub. Your support is the driving force for us to continue to improve and add new features! Thank you for your support!

[!NOTE] The SoybeanAdmin quick start series videos have been uploaded to Bilibili Go online click here Go check it out

SoybeanUI SoybeanUI
A powerful and elegant component system for Vue 3, delivering headless interaction capabilities and ready-to-use style encapsulation. Built on a two-layer Headless + UI architecture to reuse interaction capabilities and unify interface expression. Vue 3 Headless Admin
Visit SoybeanUI

Introduction

SoybeanAdmin is a clean, elegant, beautiful and powerful admin template, based on the latest front-end technology stack, including Vue3, Vite8, TypeScript, Pinia and UnoCSS. It has built-in rich theme configuration and components, strict code specifications, and an automated file routing system. In addition, it also uses the online mock data solution based on ApiFox. SoybeanAdmin provides you with a one-stop admin solution, no additional configuration, and out of the box. It is also a best practice for learning cutting-edge technologies quickly.

Features

  • Cutting-edge technology application: using the latest popular technology stack such as Vue3, Vite8, TypeScript, Pinia and UnoCSS.
  • Clear project architecture: using pnpm monorepo architecture, clear structure, elegant and easy to understand.
  • Strict code specifications: follow the SoybeanJS specification, integrate eslint, prettier and simple-git-hooks to ensure the code is standardized.
  • TypeScript: support strict type checking to improve code maintainability.
  • Rich theme configuration: built-in a variety of theme configurations, perfectly integrated with UnoCSS.
  • Built-in internationalization solution: easily realize multi-language support.
  • Automated file routing system: automatically generate route import, declaration and type. For more details, please refer to Elegant Router.
  • Flexible permission routing: support both front-end static routing and back-end dynamic routing.
  • Rich page components: built-in a variety of pages and components, including 403, 404, 500 pages, as well as layout components, tag components, theme configuration components, etc.
  • Command line tool: built-in efficient command line tool, git commit, delete file, release, etc.
  • Mobile adaptation: perfectly support mobile terminal to realize adaptive layout.

Version

Documentation

Example Images

Usage

Environment Preparation

Make sure your environment meets the following requirements:

  • git: you need git to clone and manage project versions.
  • NodeJS: >=20.19.0, recommended 20.19.0 or higher.
  • pnpm: >= 10.5.0, recommended 10.5.0 or higher.

Clone Project

# github
git clone https://github.com/soybeanjs/soybean-admin.git
# gitee
git clone https://gitee.com/honghuangdc/soybean-admin.git
# gitcode
git clone https://gitcode.com/soybeanjs/soybean-admin.git

Install Dependencies

pnpm i

Since this project uses the pnpm monorepo management method, please do not use npm or yarn to install dependencies.

Start Project

pnpm dev

Build Project

pnpm build

Code Synchronization

Refer to the Code Synchronization document.

Ecosystem

  • skyroc-admin: SoybeanAdmin's React version implementation.
  • electron-mock-admin: A Mock Api management system that helps front-end developers quickly implement interface mocks.
  • T-Shell: A terminal emulator and SSH client with configurable command prompts.
  • pea : Adopting SpringBoot3.2 + JDK21, MyBatis-Plus, SpringSecurity security framework, etc., suitable for the simple permission system developed by soybean-admin.
  • MalusAdmin: A backend management framework developed based on Vue3/TypeScript/NaiveUI and NET7 & Sqlsugar. It is implemented in the most original and simplest way, with a fresh and elegant front-end, a clear and elegant backend structure, and powerful functions.
  • PanisAdmin: Adopting SpringBoot 3, SaToken, MySQL and other frameworks to develop and modify soybean-admin for the second time, adapting dynamic menu/button-level authorization. Retaining the original flavor, fresh and elegant, high-value back-end management system scaffold.
  • snail-job: A distributed task retry and task scheduling platform with "high performance, high value and high activity".
  • SuperApi: Quickly turn your idea into an online stable product! Entity-less library and table building, add, delete, change and check entity-less library table, support 15 kinds of condition query, as well as paging, list, unlimited tree list and other functions of the API deployment! With interface documentation, Auth authorisation, interface flow restriction, access to the client's real IP, advanced server caching components, dynamic APIs and other features, we look forward to your experience!
  • FastSoyAdmin: A modern Management Platform based on FastAPI+Vue3+Naive UI.
  • ba: Backend service docking with soybean admin based on goFrame framework, adapted to dynamic routing, and interface authentication permissions.
  • soybean-admin-go:A Go backend service developed based on the Gin and GORM frameworks, integrated with the example branch of Soybean Admin. It supports dynamic routing and API permission authentication.

More ecosystem please refer to Ecosystem document.

How to Contribute

We warmly welcome and appreciate all forms of contributions. If you have any ideas or suggestions, please feel free to share them by submitting pull requests or creating GitHub issue.

Git Commit Guidelines

This project has built-in commit command, you can execute pnpm commit to generate commit information that conforms to Conventional Commits specification. When submitting PR, please be sure to use commit command to create commit information to ensure the standardization of information.

Browser Support

It is recommended to use the latest version of Chrome in development for a better experience.

| IE |  Edge | Firefox | Chrome | Safari | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------

Extension points exported contracts — how you extend this code

AdminLayoutHeaderConfig (Interface)
Header config
packages/materials/src/types/index.ts
ThemeSetting (Interface)
Theme setting
src/typings/app.d.ts
CommandArg (Interface)
(no doc)
packages/scripts/src/index.ts
RequestOption (Interface)
(no doc)
packages/axios/src/type.ts
PaginationData (Interface)
(no doc)
packages/hooks/src/use-table.ts
RequestOptions (Interface)
(no doc)
packages/alova/src/type.ts
RequestInstanceState (Interface)
(no doc)
src/service/request/type.ts
NaiveColorAction (Interface)
(no doc)
src/store/modules/theme/shared.ts

Core symbols most depended-on inside this repo

useBoolean
called by 11
packages/hooks/src/use-boolean.ts
getHsl
called by 8
packages/color/src/shared/colord.ts
transformRecordToOption
called by 6
src/utils/common.ts
createRequiredRule
called by 6
src/hooks/common/form.ts
getHex
called by 5
packages/color/src/shared/colord.ts
addColorAlpha
called by 5
packages/color/src/shared/colord.ts
transformMenuToBreadcrumb
called by 5
src/store/modules/route/shared.ts
getRoutePath
called by 5
src/router/elegant/transform.ts

Shape

Function 315
Interface 49
Method 3
Class 2
Enum 1

Languages

TypeScript100%

Modules by API surface

src/store/modules/route/index.ts21 symbols
src/store/modules/tab/index.ts20 symbols
src/store/modules/tab/shared.ts17 symbols
src/store/modules/route/shared.ts16 symbols
src/hooks/common/table.ts14 symbols
src/store/modules/theme/index.ts13 symbols
src/typings/app.d.ts12 symbols
src/store/modules/theme/shared.ts12 symbols
packages/color/src/shared/colord.ts12 symbols
src/router/elegant/transform.ts11 symbols
src/layouts/modules/global-menu/context/index.ts11 symbols
src/hooks/common/echarts.ts10 symbols

Dependencies from manifests, versioned

@alova/mock2.0.20 · 1×
@better-scroll/core2.5.1 · 1×
@elegant-router/vue0.3.8 · 1×
@iconify/json2.2.472 · 1×
@iconify/vue5.0.1 · 1×
@sa/axiosworkspace:* · 1×
@sa/colorworkspace:* · 1×
@sa/hooksworkspace:* · 1×
@sa/materialsworkspace:* · 1×
@sa/scriptsworkspace:* · 1×
@sa/uno-presetworkspace:* · 1×
@sa/utilsworkspace:* · 1×

For agents

$ claude mcp add soybean-admin \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact