Download the PHP package jeffersongoncalves/filament-flux-pro without Composer

Filament Flux Pro

Filament v5 plugin that exposes Livewire Flux Pro components — Date Picker, Calendar, Color Picker, Editor, File Upload, Slider, Pillbox, Autocomplete, Charts, Tabs, Accordion, Popover, Kanban, Command Palette, Composer and Context Menu — as native Filament Form Fields, Widgets, Schema Components and Page Concerns.

⚠️ This package requires a commercial Flux Pro license. The wrapper itself is MIT-licensed, but the runtime dependency livewire/flux-pro is proprietary. Buy at https://fluxui.dev before installing.

Compatibility

What you get

• Form Fields: FluxDatePicker, FluxDateTimePicker, FluxTimePicker, FluxCalendar, FluxColorPicker, FluxEditor, FluxFileUpload, FluxSlider, FluxPillbox, FluxAutocomplete, FluxComposer
• Widgets: FluxLineChartWidget, FluxAreaChartWidget, FluxBarChartWidget (and FluxChartWidget abstract)
• Table Columns: FluxChartColumn (sparkline)
• Schema Components: FluxTabs, FluxAccordion
• Page Concerns: HasKanban, HasCommandPalette, HasComposer + FluxKanbanPage, FluxCommandPalettePage, FluxComposerPage abstract bases
• Actions: FluxCommandAction
• Helpers: FluxPopover, FluxContextMenu, EditorImageUploader, HtmlSanitizer, KanbanColumnDefinition, KanbanCardData, CommandRegistry

Pre-requisites

Before you run composer require:

1. Add the Flux Pro Composer repository to your project's composer.json:

2. Create auth.json in your project root with your Flux Pro credentials:

3. Add auth.json to .gitignore — these credentials authenticate against your paid license. Never commit them.

4. Register the free plugin first. This package depends on jeffersongoncalves/filament-flux being installed and registered on the panel.

Installation

The install command:

• Patches resources/css/filament/{panel}/theme.css with the @source paths Tailwind v4 needs to scan Flux Pro's stubs and this plugin's views.
• Publishes the config file (config/filament-flux-pro.php).
• Warns if any of the pre-requisites above are missing.

After running it:

Plugin registration

Register the free plugin first, then this one:

If you forget the free plugin, registration throws a RuntimeException telling you to add it.

Auto-bind Filament fields to their Flux Pro replacements

useEverywhere() rebinds Filament's own form fields to their Flux Pro equivalents through the service container, so existing Resources keep calling DatePicker::make(), RichEditor::make(), etc. and receive the Flux Pro version at runtime.

Form Fields

FluxDatePicker / FluxDateTimePicker / FluxTimePicker / FluxCalendar

FluxColorPicker

FluxEditor

fluxSanitize() runs every saved value through HtmlSanitizer, which strips <script>, <style>, <iframe>, on* event handlers and javascript: URLs while keeping the standard rich-text tag set (p, strong, em, a, h1-h6, ul, ol, li, code, pre, blockquote, img, …).

FluxFileUpload

FluxSlider

FluxPillbox

FluxAutocomplete

FluxComposer

Chat-style input with attachments and @-mentions:

The dehydrated state is either a plain string (when only text is filled) or an array ['text' => string, 'attachments' => array, 'mentions' => array].

Charts

Three abstract widgets ready to subclass:

FluxAreaChartWidget and FluxBarChartWidget work the same way. The default option set is ['colors' => ['accent'], 'showLegend' => true, 'showGrid' => true, 'showAxis' => true] and can be overridden by re-implementing getOptions().

FluxChartColumn (sparkline in tables)

Schema components

FluxTabs

FluxAccordion

FluxPopover

FluxPopover::trigger() returns an HtmlString you can render anywhere:

The position attribute is HTML-escaped, so user-controlled values are safe.

FluxContextMenu

Pages

Kanban

The Kanban migration must include status (or whatever getKanbanStatusField() returns) and an order column. Override getKanbanOrderField() to use a different name.

Command Palette

The trait already exposes openCommandPalette(), closeCommandPalette(), toggleCommandPalette(), executeCommand($key) and getFilteredCommands(). Render the palette from vendor/jeffersongoncalves/filament-flux-pro/resources/views/pages/command-palette-modal.blade.php (publish + customize when needed) or pass $this->isCommandPaletteOpen to your own modal.

CommandRegistry helper

If you want a free-standing collection of commands (not bound to a page), use the registry:

FluxCommandAction (record-scoped command palette)

Composer page

When to reach for filament-flux-pro

Troubleshooting

• composer require fails with Could not find package livewire/flux-pro — your composer.json is missing the composer.fluxui.dev repository. See Pre-requisites above.
• composer require fails with Could not authenticate against composer.fluxui.dev — auth.json is missing or has invalid credentials. Re-create it with the email + license key from your Flux Pro account.
• auth.json shows up in git status — add it to .gitignore immediately. The install command warns about this.
• RuntimeException: FilamentFluxProPlugin requires FilamentFluxPlugin to be registered first — list the free plugin before the Pro one in your panel provider's ->plugin() chain.
• Kanban resets cards to position 0 on drag-drop — your migration is missing the order column. Either add an order integer column or override getKanbanOrderField() to point to your existing column.
• Command palette hotkey doesn't fire — the page must dispatch open-command-palette itself or listen with protected $listeners = ['open-command-palette' => 'openCommandPalette'];. The plugin only exposes the configuration; binding the keystroke is your responsibility.
• Editor saves raw HTML with <script> tags — make sure fluxSanitize() is on (default) and that you're reading the dehydrated state from the form, not the raw Livewire property.

License

The wrapper code in this repository is MIT — see https://fluxui.dev to install and run this plugin.