README

A Filament V3 form macro for TextInput that allows you to easily format and manage serial numbers with optional prefixes, suffixes, separators, and padded digits.

✨ Features

• Format serial numbers in Filament forms.
• Support for:
  • Prefix and/or suffix
  • Custom separator
  • Fixed digit zero-padded numeric part
• Automatically formats on blur and focus
• Saves only numeric part to database
• Built-in Alpine.js interactivity
• Simple integration with Filament TextInput

📦 Installation

You can install the package via Composer:

composer require momenoor/filament-serial

This package auto-registers itself. No need to publish anything.

⚙️ Usage

use Filament\Forms\Components\TextInput;

TextInput::make('serial_number')
    ->label('Serial Number')
    ->serial(
        prefix: 'INV',     // Optional string or Closure
        suffix: 'UAE',     // Optional string or Closure
        separator: '-',    // Default is "-"
        length: 6          // Default is 8
    );

Example

🛠 Parameters

✅ Compatibility

• Laravel 10+
• Filament 3.x
• PHP 8.1+

📄 Changelog

Please see CHANGELOG for more information on recent changes.

🤝 Contributing

Please see CONTRIBUTING for details.

🔐 Security

If you discover any security-related issues, please review the security policy.

🙌 Credits

• Momen Noor
• All Contributors

📜 License

The MIT License (MIT). Please see LICENSE for more information.