包简介

The official UI component library for Livewire.

README 文档

README

Flux is a robust, hand-crafted UI component library for Livewire applications. It's built using Tailwind CSS and provides a set of components that are easy to use and customize.

You can view the components in action at https://fluxui.dev.

Prerequisites

Flux requires the following before installing:

Laravel v10.0+
Livewire v3.5.19+
Tailwind CSS v4.0+

Installation

Run the following command from your project's root directory:

composer require livewire/flux

Getting Started

1. Include Flux Assets

Add the @fluxAppearance and @fluxScripts Blade directives to your layout file:

<head>
    ...
    @fluxAppearance
</head>

<body>
    ...
    @fluxScripts
</body>

2. Set up Tailwind CSS

Flux uses Tailwind CSS for its default styling. Add the following configuration to your resources/css/app.css file:

@import 'tailwindcss';
@import '../../vendor/livewire/flux/dist/flux.css';

@custom-variant dark (&:where(.dark, .dark *));

If you don't have Tailwind installed, you can learn how to install it on the Tailwind website.

3. Use the Inter Font Family (Optional)

We recommend using the Inter font family. Add the following to your layout file:

<head>
    ...
    <link rel="preconnect" href="https://fonts.bunny.net">
    <link href="https://fonts.bunny.net/css?family=inter:400,500,600&display=swap" rel="stylesheet" />
</head>

Configure Tailwind to use this font in your resources/css/app.css:

@import 'tailwindcss';
@import '../../vendor/livewire/flux/dist/flux.css';

...

@theme {
    --font-sans: Inter, sans-serif;
}

What's included?

The following components are included in the livewire/flux package:

The rest of the Flux components are part of the paid (Pro) tier of Flux.

Purchase a "Pro" license key here: https://fluxui.dev/pricing

Pro Installation

If you have purchased a Flux Pro license, activate it using:

php artisan flux:activate

During activation, you'll be prompted for your email and license key.

Customization

To customize specific Flux components, publish their blade files using:

php artisan flux:publish

You'll be prompted to select which components to publish, or use --all to publish everything.

Keeping Updated

To ensure you have the latest version of Flux, regularly update your dependencies:

composer update livewire/flux livewire/flux-pro

For more detailed documentation and guides, visit https://fluxui.dev/docs.

livewire/flux 适用场景与选型建议

livewire/flux 是一款基于 Blade 开发的 Composer 扩展包，目前已累计 7.4M 次下载、GitHub Stars 达 947，最近一次更新时间为 2024 年 09 月 19 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「ui」「components」「flux」「laravel」「livewire」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 livewire/flux 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 livewire/flux 我们能提供哪些服务？

定制开发 / 二次开发

基于 livewire/flux 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 livewire/flux 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

ympact/flux-icons 11

A package to provide icons from different vendors for Livewire Flux.

components/webfontloader 2

Web Font Loader gives you added control when using linked fonts via @font-face.

selvinortiz/flux 337

Fluent regular expressions in PHP.

kanti/fluidcontent 0

Create Flexible Content elements in pure fluid

wishborn/fancy-flux 3

Custom Flux UI components - carousel, color-picker, and emoji-select

kstmostofa/laravel-whatsapp 183

Dual-backend Laravel package for WhatsApp: Meta Cloud API + bundled whatsapp-web.js sidecar. Ships a Livewire/Flux admin UI, queued jobs, webhooks with HMAC, Eloquent models, broadcasting, and CLI lifecycle commands.

livewire/flux

包简介

关键字：