asmit/fila-calendar

asmit/fila-calendar

A polished inline calendar field for Filament forms and infolists. Supports single, range, multiple, and multi-range selection with a self-contained Alpine.js UI — no external calendar library required.

Features

• Multiple selection modes — single, multiple, range, and multi-range
• Form + infolist — CalendarInput field and read-only CalendarEntry
• Multi-month grid — column count per breakpoint with configurable month count
• Date constraints — unavailable dates, weekend blocking, and min/max bounds
• Reserved dates — mark days that are already booked with their own icon and tooltip, enforced server-side
• Range hover preview — visual feedback while selecting a range
• Smart range editing — deselecting a middle day splits the range instead of clearing it
• Localization — calendar labels via ->locale('ja')
• No extra dependencies — ships its own Alpine.js component and styles

Requirements

• PHP 8.2+
• Laravel 11+ (whichever versions your Filament release supports)
• Filament 4 or 5

Installation

composer require asmit/fila-calendar
php artisan filament:assets

Import the package stylesheet into your Filament theme:

@import '../../vendor/asmit/fila-calendar/resources/css/fila-calendar.css';

Development

If you symlink the package locally with a Composer path repository, see the development guide for the path-repository setup and theme import path.

Usage

Add a calendar field to a Filament form:

use Asmit\FilaCalendar\Forms\Components\CalendarInput;
use Asmit\FilaCalendar\Support\CalendarMode;

CalendarInput::make('booking')
    ->mode(CalendarMode::MultiRange)
    ->months(12)
    ->calendarColumns(['sm' => 2, 'lg' => 3, 'xl' => 4])
    ->reservedDates(fn (): array => Booking::query()->pluck('date')->all())
    ->withToday()
    ->locale('ja');

Render saved dates as a read-only infolist entry:

use Asmit\FilaCalendar\Infolists\Components\CalendarEntry;
use Asmit\FilaCalendar\Support\CalendarMode;

CalendarEntry::make('booking')
    ->mode(CalendarMode::MultiRange)
    ->months(3)
    ->calendarColumns(3);

View Complete Documentation →

Contributing

Contributions are welcome. Please see CONTRIBUTING.md before opening an issue or pull request.

Security

If you discover a security issue, please review our Security Policy.

Changelog

Please see CHANGELOG.md for recent changes.

License

MIT License. See LICENSE.md for details.