XYGo Admin

An open-source full-stack admin framework built with Vue3 + GoFrame. Includes RBAC permissions, code generation, system monitoring and more — ready to use out of the box.

English | 简体中文

Website | Demo | Join QQ Group | Gitee | GitHub

Overview

XYGo Admin is a full-stack open-source admin framework. The frontend is based on Art Design Pro (Vue3 + TypeScript + Element Plus), and the backend is powered by GoFrame v2. Free for commercial use without any authorization required.

Key Features

RBAC Permission System: Roles, menus, buttons, data scope, and field-level permissions with visual management

Visual Code Generator: Design table structures visually, generate full CRUD code (Go API + Controller + Logic + Vue pages) with one click, saving 80% of development time

Dual Database Support: Compatible with both MySQL and PostgreSQL from a single codebase — switch databases by changing one config line

Frontend-Backend Separation: Vue3 SPA + GoFrame RESTful API, deployable independently or as a single binary

Member Portal: Built-in frontend portal with member center, registration, login, check-in, and profile management

Document Center: Built-in Markdown documentation with category tree, full-text search, and online preview

System Monitoring: Server status, slow query alerts, slow API alerts, operation logs, and login logs

Message Queue: Redis-based async task queue with scheduled task management and message push

Modern UI: Based on Art Design Pro with 6 layout modes, light/dark themes, and smooth animations

Single Binary Deploy: Bundle frontend into Go binary — deploy with just one file + one config, no Nginx needed

Tech Stack

Layer	Technology
Frontend	Vue 3, TypeScript, Vite
UI Library	Element Plus, Tailwind CSS
State Management	Pinia
Backend	GoFrame v2 (Go 1.22+)
Database	MySQL 8.0+ / PostgreSQL 14+
Cache/Queue	Redis
Auth	JWT (single sign-on support)

Preview

Live Demo: www.xygoadmin.com

Quick Access

Live Demo | Gitee | GitHub | 📖 Documentation

Installation

For detailed installation instructions, please refer to the 📖 Official Documentation.

Default Account

Role	Username	Password
Super Admin	Super	123456

Project Structure

xygoadmin/
├── server/                    # Backend GoFrame project
│   ├── addons/                # Addon packages (*.zip)
│   ├── api/                   # API definitions
│   ├── internal/
│   │   ├── cmd/               # Main command entry
│   │   ├── cmdtools/          # Tool command logic (migrate, addon, updater)
│   │   ├── controller/        # Controllers (request handling)
│   │   ├── logic/             # Business logic (core code here)
│   │   ├── model/             # Data models (entity/do/input)
│   │   ├── dao/               # Data access (auto-generated by gf gen dao)
│   │   └── service/           # Service interfaces (auto-generated by gf gen service)
│   ├── cmd_tools/migrate/     # Migration SQL files
│   ├── manifest/config/       # Runtime config
│   ├── hack/config.yaml       # CLI tool config (build/gen)
│   ├── resource/              # Static assets, code gen templates
│   ├── main.go                # Server entry (gf run main.go)
│   └── tools.go               # Tools entry (go run tools.go)
├── web/                       # Frontend Vue3 project
│   ├── src/
│   │   ├── api/               # API request wrappers
│   │   ├── views/             # Page components (backend/frontend)
│   │   ├── router/            # Routes (static + dynamic loading)
│   │   ├── store/             # Pinia state management
│   │   └── components/        # Shared components
│   └── ...
├── mysql_install.sql           # MySQL init script
├── pgsql_install.sql           # PostgreSQL init script
└── version.json                # Version info (for online updates)

Tools

All tools are accessed via go run tools.go in the server/ directory:

Command	Description
go run tools.go	Interactive menu
go run tools.go migrate up	Run database migrations
go run tools.go migrate status	View migration status
go run tools.go migrate history	View migration history
go run tools.go check-tpl	Check template syntax
go run tools.go update	Online update
go run tools.go addon install tenant	Install addon
go run tools.go addon uninstall tenant	Uninstall addon

Contact

• Demo: www.xygoadmin.com
• GitHub: github.com/z312193608/xygo-admin
• Gitee: gitee.com/a751300685a/xygo-admin
• QQ: 751300685
• QQ Group: 963636900

Browser Compatibility

Supports Chrome, Safari, Firefox, Edge, and other modern browsers.

Acknowledgements

Thanks to these open-source projects:

• GoFrame - Go web framework
• Art Design Pro - Vue3 admin template
• Vue / Element Plus / Vite / Pinia
• Tailwind CSS / TypeScript

License

MIT - Free for commercial use, no authorization required.

Support

If you find this project helpful, please give us a Star on GitHub or Gitee. It means a lot to us.

Sponsor

If XYGo Admin has been helpful to you, feel free to buy the author a coffee ☕. Your support keeps the project going!

Alipay	WeChat Pay