flipped-aurora/gin-vue-admin

What it is

Gin-vue-admin is a full-stack, front-end/back-end separated development base platform built on Gin (Go) and Vue 3 with Element Plus. It targets teams that want to skip the repetitive scaffolding of small to mid-sized management systems: authentication, permission control, dynamic menus and routes, uploads/downloads, pagination, and CRUD code generation are already wired up so work can start at the business layer.

The backend uses JWT for authentication and Casbin for authorization, GORM against MySQL/MariaDB, Redis for active login tokens and multi-device login limits, Swagger for API docs, and Viper plus fsnotify for YAML configuration. The front end is Vue 3 with Element Plus; the form generator is built on Variant Form. Recent versions add AI-oriented pieces: an MCP service adapted to AI editors and a skills management area, plus the Claw ecosystem plugin.

Quick start

Prerequisites: Node.js newer than v18.16.0, Go 1.26.10 or later, and a reachable MySQL/MariaDB plus Redis instance. Open the server directory itself in your IDE, not the repository root.

# backend
git clone https://github.com/flipped-aurora/gin-vue-admin.git
cd server
go generate
go run .

# frontend, in a separate shell
cd web
npm install
npm run serve

To produce API docs, install Swagger and regenerate:

 go install github.com/swaggo/swag/cmd/swag@latest
cd server
swag init

After the Go service starts, the Swagger UI is served at http://localhost:8888/swagger/index.html. Database configuration and initialization steps are covered separately in the initialization guide; the README's run commands assume an already configured database and do not themselves create one. A live demo is available with the test credentials shown in the README.

Constraints and licensing

• You are expected to already know Go and Vue; the project positions itself as a framework for developers, not a no-code tool.
• MySQL or MariaDB 5.7+ with InnoDB, and Redis, are part of the default stack; the server commands above do not explain database setup.
• VS Code users can open gin-vue-admin.code-workspace and run the Both (Backend & Frontend) task to start both sides.
• Licensed under Apache-2.0; keep the required notices when using, modifying or redistributing. Authorized-version features and official commercial support are sold separately through the plugin/license pages, and free technical support is explicitly not offered.
• The README also includes a small Go base64 snippet intended to gate a WeChat group invite; it is unrelated to running the platform.

HotRepo's take

The project has 25,124 stars and 7,102 forks, with an Apache-2.0 license and a long track record since 2019. Its one recorded Go daily-list snapshot (2026-11-10) shows no star gain that day and a best position of 11, so there is no growth evidence for that date, and no all-language daily rank is recorded. What stands out instead is the scope: a mature admin scaffold that has added MCP integration and skills management to stay relevant to AI-assisted development, while the core value remains the permission system and code generator that save setup time on CRUD-heavy backends.