README

用于快速集成 I-UI, 安装列表如下：

• I-UI
• Inertia 3
• Vue 3
• Tailwind CSS 4
• Ziggy

2. 安装

composer require ilaoniu/breeze --dev

3. 使用

运行安装命令集成 I-UI:

php artisan breeze:install

复制 I-UI 到项目:

cp -r ~/code/ui/resources/js/i-ui ./resources/js/i-ui

本地项目测试也可使用软链接：

Linux/macOS

ln -s ~/code/ui/resources/js/i-ui ~/code/project-name/resources/js

Windows

mklink /J C:\Users\ilaoniu\code\project-name\resources\js\i-ui C:\Users\ilaoniu\code\i-ui\resources\js\i-ui

在 .env 中按需调整 Inertia SSR 相关环境变量：

INERTIA_SSR_PORT=13714
INERTIA_SSR_URL="http://127.0.0.1:${INERTIA_SSR_PORT}"

4. 注意事项

按需修改 Inertia 中间件，位置 app/Http/Middleware/HandleInertiaRequests.php:

.
.
.
    public function share(Request $request): array
    {
        return [
            ...parent::share($request),
            'app' => [
                'name' => config('app.name'),
                'base_url' => config('app.url'),
                'current_url' => URL::full(),
                'preferNativeScrollbar' => (bool) ! preg_match('/Windows ((NT|XP)( \d\d?.\d)?)/i', $request->userAgent()),
                'time' => now(),
            ],
            'auth' => [
                'user' => \Auth::user(),
            ]
        ];
    }
.
.
.

如果使用了 CDN，静态资源版本控制要修改为本地，否则可能不刷新：

.
.
.
    public function version(Request $request): ?string
    {
        if (file_exists($manifest = public_path('build/manifest.json'))) {
            return md5_file($manifest);
        }

        return null;
    }
.
.
.

5. 打包 tree-shaking

可根据需要在 package.json 中添加 sideEffects 自动移除未使用代码。（一般不需要）

示例：

.
.
.
    "sideEffects": [
        "./resources/js/app.js"
    ],
.
.
.