<p align="center">
    <img src="https://file.xinadmin.cn/file/favicons.ico" alt="xinadmin">
</p>
<h1 align="center">Xin Admin</h1>
<h4 align="center">Enterprise-level PHP Full-stack Development Framework</h4>
<p align="center">
    <a href="./README.md">简体中文</a> | <a href="./README.en.md">English</a>
</p>
<p align="center">
    <a href="https://xinadmin.cn/" target="_blank">
        <img src="https://img.shields.io/badge/XinAdmin-V2-brightgreen" alt="xinadmin">
    </a>
    <a href="https://www.php.com/" target="_blank">
        <img src="https://img.shields.io/badge/PHP->=8.2-brightgreen" alt="php">
    </a>
    <a href="https://laravel.com/" target="_blank">
        <img src="https://img.shields.io/badge/Laravel->=12-brightgreen" alt="laravel">
    </a>
    <a href="https://react.dev/" target="_blank">
        <img src="https://img.shields.io/badge/React->=18.1-brightgreen" alt="React">
    </a>
    <a href="https://mysql.org/" target="_blank">
        <img src="https://img.shields.io/badge/mysql->=5.7-brightgreen" alt="">
    </a>
    <a href="https://gitee.com/wonderful-code/buildadmin/blob/master/LICENSE" target="_blank">
        <img src="https://img.shields.io/badge/MIT-license-brightgreen" alt="license">
    </a>
</p>


XinAdmin is a full-stack development framework built with cutting-edge technologies including PHP8.2 + Laravel12 + MySQL + React + Zustand + TypeScript + Ant Design. It provides convenient development features such as annotation routing, API permission verification, dynamic menus, group permissions, data dictionaries, system configuration, file management, and dictionary management. Licensed under MIT, free for commercial use without authorization.

<img src="https://file.xinadmin.cn/readme/index_en.png" alt=""/>

## Key Features

### ✨ Deep Laravel Integration
Built on top of the `Laravel` framework, visualizing configurations for mail, storage, and more. Supports annotation routing and CRUD controllers, enabling rapid application development in Laravel's comfortable environment - [Laravel](https://laravel.com/) is the most efficient way to build, deploy, and monitor software.

### 🎈 React Tech Stack
`Xin Admin` frontend uses the React tech stack with built-in Zustand state management and file-system-based routing. Simple to use with a rich ecosystem, standing on the shoulders of giants to enjoy the convenience and joy of development.

### 🎨 Ant Design Component Library
Layout and menus built on `Ant Design V6` component library. Enterprise-grade product system, AI-friendly "Design System" that combines beauty with intelligence, making work full of "inspiration" and "happiness".

### 📟 Annotation Routing & Permissions
Use annotation routing in `Laravel` controllers, simplifying route definitions and making APIs clearer. Use `Laravel Sanctum` for permission control on annotation routes, with one-click configuration of API routes and permissions.

### ♻️ Rich System Features
`Xin Admin` comes with many out-of-the-box system features, including administrators, departments & roles, permission menus, file management, data dictionaries, system configuration, mail configuration, storage configuration, and more. You can build any web application on top of this foundation.

## Built-in Features

- Dashboard: Provides ready-to-use dashboard solutions based on `Echarts`, along with demo pages
- Example Components: Examples of icons, tables, lists, forms, and other components
- Frontend Members: Permission management, grouping, lists, and balance records for frontend members
- Administrators: Administrators are backend system visitors, providing admin grouping, permissions, lists, and admin settings
- Department Management: Used for grouping administrators by department, commonly used for enterprise department structure organization
- Role Management: Assign different permissions to specific roles, implementing role-based menu permission control
- System Settings: Quick setup forms for server variable parameters, with customizable groups and form types
- File Management: Backend file management with folders, supporting multi-select, file grouping, and uploads for images, videos, audio, archives, and other files
- Dictionary Management: Maintenance of frequently used, relatively fixed data in the system
- Mail Management: Provides visual configuration and testing for `Laravel` mail system
- Storage Configuration: Provides visual configuration and testing for `Laravel` file storage

## Preview

<img src="https://file.xinadmin.cn/readme/index_en.png" alt="Dashboard"/>
<img src="https://file.xinadmin.cn/readme/index_dark_en.png" alt="Dark Mode"/>
<img src="https://file.xinadmin.cn/readme/file_en.png" alt="File Management"/>
<img src="https://file.xinadmin.cn/readme/mail_en.png" alt="Mail Configuration"/>
<img src="https://file.xinadmin.cn/readme/storage_en.png" alt="Storage Configuration"/>

## More Information
- Official Website: [https://xinadmin.cn/](https://xinadmin.cn/)
- Documentation: [https://xinadmin.cn/](https://xinadmin.cn/)
- Demo: [https://demo.xinadmin.cn/](https://demo.xinadmin.cn/)

## Contact Us
- Github: [xinova](https://github.com/xinova)
- Github: [xin-admin](https://github.com/xin-admin)
- QQ: 2302563948
