显示侧边栏

安装 Flux Pro Max

Flux Pro Max 是在 Flux 与 Flux Pro 之上的进阶组件包，提供更加完整的应用模板与高级组件。它基于 Flux UI 设计系统构建，支持深色模式、响应式布局，并开箱即用地集成了一系列业务场景组件。

先决条件

在安装 Flux Pro Max 之前，请确认已满足以下要求：

Laravel

10 或更高版本

Livewire

3.6.2 或更高版本

Flux / Flux Pro

Flux + Flux Pro ≥ 2.6.1，已按安装文档完成配置

Tailwind CSS

4 或更高版本

配置 Composer 仓库

首先，在项目根目录中配置 Flux Pro Max 的 Composer 仓库地址：

composer config repositories.flux-pro-max composer https://composer.fluxui.cn

该配置会在 composer.json 中注册一个名为 flux-pro-max 的私有仓库，用于拉取专有组件包。

配置认证信息

接着，为私有仓库配置邮箱与许可证密钥，用于鉴权下载：

composer config http-basic.composer.fluxui.cn your-email your-license-key

建议将上述命令中的 your-email 与 your-license-key 替换为你在仪表盘中看到的邮箱与许可证密钥。

安装 Flux Pro Max

完成仓库与认证配置后，即可通过 Composer 安装 Flux Pro Max：

composer require fluxui/flux-pro-max

如果你尚未配置私有 Composer 仓库或认证信息，请先在仪表盘中根据指引完成配置，再次执行上述命令。

接着，请在你的项目样式入口文件中引入 Flux Pro Max 样式依赖，并重新构建资源（以 Vite 默认结构为例）：

@import '../../vendor/fluxui/flux-pro-max/dist/flux-pro-max.css';

如果发现组件样式不对（例如样式未生效或显示错乱），可以执行以下命令重新构建资源：

npm run build

清除缓存（可选）

安装完成后，建议清除 Composer 与应用缓存，以确保 Flux Pro Max 的配置与服务提供者正确加载：

composer clear-cache
php artisan optimize:clear
composer dump-autoload

验证安装

你可以通过以下命令检查 Flux Pro Max 是否已经正确安装并可用：

# 查看可用命令
php artisan list | grep flux-pro-max

# 查看所有可发布的 provider / tag（不会立刻发布资源）
php artisan vendor:publish

保持 Flux Pro Max 为最新

为了获得最新的功能与修复，建议定期更新 Flux、Flux Pro 与 Flux Pro Max 相关依赖：

composer update livewire/flux livewire/flux-pro fluxui/flux-pro-max

你也可以在自定义与其他文档中了解如何在项目中充分发挥 Flux Pro Max 的能力。

如果在安装或使用过程中遇到其他问题，可以查看 Flux Pro Max 包内的 docs/README.md 获取更详细的说明。