AgentSkillsCN

fluxui-development

借助 Flux UI Pro 组件开发 UI 界面。当您创建按钮、表单、模态框、输入框、表格、图表、日期选择器或其他 UI 组件时,该技能将自动激活;当您用 Flux 替换 HTML 元素、使用 Flux 组件进行开发,或当用户提及 Flux、组件库、UI 组件、表单字段,或是询问可用的 Flux 组件时,此技能亦会自动启动。

SKILL.md
--- frontmatter
name: fluxui-development
description: "Develops UIs with Flux UI Pro components. Activates when creating buttons, forms, modals, inputs, tables, charts, date pickers, or UI components; replacing HTML elements with Flux; working with flux: components; or when the user mentions Flux, component library, UI components, form fields, or asks about available Flux components."
license: MIT
metadata:
  author: laravel

Flux UI Development

When to Apply

Activate this skill when:

  • Creating new UI components or pages
  • Working with forms, modals, or interactive elements
  • Styling components with Flux UI patterns
  • Checking available Flux components

Documentation

Use search-docs for detailed Flux UI patterns and documentation.

Basic Usage

This project uses the Pro version of Flux UI, which includes all free and Pro components and variants.

Flux UI is a component library for Livewire built with Tailwind CSS. It provides components that are easy to use and customize.

Use Flux UI components when available. Fall back to standard Blade components when no Flux component exists for your needs.

<!-- Basic Button -->
blade
<flux:button variant="primary">Click me</flux:button>

Available Components (Pro Edition)

Available: accordion, autocomplete, avatar, badge, brand, breadcrumbs, button, calendar, callout, card, chart, checkbox, command, composer, context, date-picker, dropdown, editor, field, file-upload, heading, icon, input, kanban, modal, navbar, otp-input, pagination, pillbox, popover, profile, radio, select, separator, skeleton, slider, switch, table, tabs, text, textarea, time-picker, toast, tooltip

Icons

Flux includes Heroicons as its default icon set. Search for exact icon names on the Heroicons site - do not guess or invent icon names.

<!-- Icon Button -->
blade
<flux:button icon="arrow-down-tray">Export</flux:button>

For icons not available in Heroicons, use Lucide. Import the icons you need with the Artisan command:

bash
php artisan flux:icon crown grip-vertical github

Common Patterns

Form Fields

<!-- Form Field -->
blade
<flux:field>
    <flux:label>Email</flux:label>
    <flux:input type="email" wire:model="email" />
    <flux:error name="email" />
</flux:field>

Tables

<!-- Table -->
blade
<flux:table>
    <flux:table.head>
        <flux:table.row>
            <flux:table.cell>Name</flux:table.cell>
        </flux:table.row>
    </flux:table.head>
</flux:table>

Verification

  1. Check component renders correctly
  2. Test interactive states
  3. Verify mobile responsiveness

Common Pitfalls

  • Not checking if a Flux component exists before creating custom implementations
  • Forgetting to use the search-docs tool for component-specific documentation
  • Not following existing project patterns for Flux usage