Gin-Vue-Admin is a full-stack, backend-frontend separated development platform built with Vue 3 and Gin. It targets developers needing a rapid development foundation for medium-to-small projects, offering essential features like JWT authentication, dynamic routing, permission management, and code/form generators to accelerate business logic implementation.

How It Works

The platform utilizes Vue 3 with Element UI for the frontend and Gin (a Go web framework) for the backend. It employs JWT for authentication and Casbin for fine-grained authorization. MySQL is used as the database, with GORM for ORM operations. Redis handles JWT token storage and multi-login restrictions. Swagger is integrated for API documentation, and fsnotify with Viper manages configuration. The architecture separates concerns into API, config, core, middleware, model, and service layers for the backend, and a component-based structure for the frontend.

Quick Start & Requirements

• Backend: go run . (after go generate for dependencies)
• Frontend: npm install then npm run serve
• Prerequisites: Node.js > v16.8.3, Go >= v1.22, MySQL > 5.7, Redis (for multi-login).
• API Docs: go install github.com/swaggo/swag/cmd/swag@latest then swag init in the server directory. Access at http://localhost:8888/swagger/index.html.
• VSCode Workspace: Open gin-vue-admin.code-workspace for integrated backend/frontend tasks.
• Documentation: Online Docs

Highlighted Details

• AI-assisted code generation for structure and CRUD operations.
• Integrated form and code generators.
• Supports multi-cloud file uploads (Qiniu, Aliyun, Tencent Cloud).
• Dynamic menu and API permission management.
• Multi-point login restriction via Redis.

Maintenance & Community

• Active development with detailed documentation and video tutorials available.
• QQ Group: 971857775. WeChat contact available for group access.
• Team Blog with framework tutorials.

Licensing & Compatibility

• Licensed under Apache 2.0.
• Commercial use requires retaining author attribution and copyright notices. Commercial use is defined as any revenue-generating activity. A separate commercial license is available for those needing to remove attribution.

Limitations & Caveats

The project requires existing Go and Vue knowledge. Free technical support is not provided; paid support is available. Commercial use requires strict adherence to the Apache 2.0 license or purchasing a license.