Gin-Vue-Admin

Gin-Vue-Admin is an open-source full-stack admin development boilerplate built on Vue 3, Element Plus, and the Go Gin framework, designed to generate production-ready CRUD pages and permission systems in about one minute. It runs on Node.js and Go with MySQL/MariaDB and Redis as infrastructure, and is maintained by the flipped-aurora GitHub organization.

What is Gin-Vue-Admin?

Gin-Vue-Admin is a full-stack, front-end/back-end separated development platform that combines a Vue 3 frontend with a Go Gin backend. It takes a developer's business requirements as input and outputs a complete admin system skeleton with user, role, menu, and API permission management, dynamic routing, and a code generator that produces CRUD code. The project is maintained by the flipped-aurora organization on GitHub, with an online demo and a plugin marketplace.

Key Features

• Code generator — Generates backend Go logic and simple CRUD code from a database table or a created template, including permission assignment, so you can create a working module in minutes.
• Form generator — Builds forms with the Variant Form component and integrates them into pages without handwritten HTML.
• Permission management — Uses JWT for authentication and Casbin for authorization, letting admins assign different API and menu permissions to different roles.
• Dynamic routing and menus — Menus and routes are rendered per role from database configuration, so different users see different navigation.
• Multi-point login restriction — Records active user JWT tokens in Redis to limit concurrent logins from multiple devices.
• File upload/download — Supports local disk, Qiniu Cloud, Aliyun OSS, and Tencent COS, including chunked upload for large files.
• Pagination encapsulation — Frontend uses Vue mixins to encapsulate pagination, so list pages call a method instead of writing pagination logic.
• Swagger API docs — Automatically generates interactive API documentation from Go annotations, accessible at /swagger/index.html after running the server.

Who is it for?

• Go and Vue developers — who need a pre-built admin panel with login, user, role, menu, and API management instead of writing these modules from scratch.
• Full-stack freelancers — who want to quickly scaffold a small-to-medium project with a generated CRUD backend and frontend, then focus on business features.
• Teams adopting Gin and GORM — who need a consistent architecture with standards for routing, API responses, and database access, plus documented conventions for CI and contributions.
• Companies evaluating open-source admin platforms — who require a license model that permits free non-commercial and learning use under BSL 1.1, with paid licenses for production.

What can you do with it?

• Rapid prototyping: Create a new module by adding a database table, running the code generator, and assigning permissions to a role — a process that takes about one minute according to the project's demo video.
• Custom admin panels: Use the dynamic menu, user, role, and API managers to configure an internal back-office system that matches an organization's permission hierarchy.
• Learning reference: Study the codebase to see how a Vue 3 + Element Plus frontend integrates with a Gin + GORM backend, including JWT authentication, file uploads, and WebSocket examples.

How does it run?

The project is split into server and web directories. For the backend, clone the repository, enter the server folder, run 'go generate' to install Go dependencies, then 'go run .' to start it on localhost:8888. For the frontend, enter the web folder, run 'npm install' and 'npm run serve'. A VSCode workspace file includes tasks to launch both concurrently.

Pricing

The project uses the BSL 1.1 license, which is free for non-commercial, learning, and evaluation. Commercial or production use, or removal of copyright notices, requires purchasing a license from the plugin marketplace.

FAQ

Is Gin-Vue-Admin free to use?

Gin-Vue-Admin is free for non-commercial, learning, and evaluation purposes under the BSL 1.1 license. For commercial or production use, you must purchase authorization from the plugin marketplace, and you must retain the copyright notices in the repository, logs, and code.

What versions of Node and Go are required?

The web frontend requires Node.js version above v18.16.0, and the backend requires Go version v1.22 or higher. The recommended IDE is Goland, though a VSCode workspace with build and debug tasks is also provided.

How do I access the Swagger API documentation?

After starting the Go server, open your browser to localhost:8888/swagger/index.html. Swagger documents are generated by running 'swag init' in the server directory, which produces docs.go, swagger.json, and swagger.yaml files.

Is there a live demo?

Yes, an online preview is available at demo.gin-vue-admin.com. Use the test username 'admin' and password '123456' to explore the platform's features.