# PanGu

**Repository Path**: tingrays/PanGu

## Basic Information

- **Project Name**: PanGu
- **Description**: laravel 12+ && inertiajs
- **Primary Language**: PHP
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2019-12-23
- **Last Updated**: 2025-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Metronic - Laravel & Vuejs & Inertia.js & TailwindCSS Admin Dashboard Theme

## 概述
Metronic 是一个基于 Laravel、Vue.js、Inertia.js 和 TailwindCSS 构建的高级管理仪表板主题。它提供了一套完整的 UI 组件、页面模板和功能模块，帮助开发者快速构建现代化的企业级 Web 应用程序。

## 功能特性
- **Laravel 后端框架**：使用 Laravel 提供安全认证、API 支持和数据库迁移等功能。
- **Vue.js 前端框架**：基于 Vue.js 的响应式前端界面，支持组件化开发。
- **Inertia.js 集成**：无缝连接 Laravel 后端与 Vue.js 前端，实现单页应用体验。
- **TailwindCSS 样式**：使用 TailwindCSS 实现高度可定制的现代设计。
- **用户认证**：包含登录、注册、密码重置、邮件验证等完整认证流程。
- **用户资料管理**：支持用户资料编辑、更新和删除功能。
- **主题定制**：提供多种颜色主题和布局选项，支持暗色模式。
- **图标库**：集成丰富的 SVG 图标资源，涵盖多个行业和类别。
- **响应式设计**：适配各种屏幕尺寸，确保良好的移动端体验。

## 安装步骤
1. **克隆仓库**：
   ```bash
   git clone [仓库地址]
   cd metronic-laravel-vue
   ```

2. **安装依赖**：
   ```bash
   composer install
   npm install
   ```

3. **配置环境**：
   ```bash
   cp .env.example .env
   php artisan key:generate
   ```

4. **数据库迁移**：
   ```bash
   php artisan migrate
   ```

5. **编译前端资源**：
   ```bash
   npm run dev
   # 或者构建生产环境资源
   npm run build
   ```

6. **启动开发服务器**：
   ```bash
   php artisan serve
   ```

## 使用说明
- **用户认证**：访问 `/login` 或 `/register` 进行登录或注册操作。
- **用户资料管理**：已认证用户可通过 `/profile` 页面编辑个人资料。
- **密码修改**：在 `/settings/password` 页面可以更改账户密码。
- **图标使用**：图标资源位于 `public/media/svg` 目录，可直接引用。

## 自定义与扩展
- **主题切换**：通过 `HandleAppearance` 中间件控制主题样式。
- **图标替换**：使用 `ki-*` 类名调用 KeenIcons 图标。
- **页面布局**：利用 Inertia.js 实现的布局共享机制统一管理页面结构。

## 技术栈
- Laravel 10
- Vue.js 3 + Composition API
- Inertia.js
- Tailwind CSS 3
- TypeScript
- Vite 4

## 贡献指南
欢迎提交 Pull Request 和 Issue 报告。请遵循项目代码规范并确保测试通过。

## 许可协议
本项目采用 MIT 许可协议。详见 LICENSE 文件。