A Filament plugin to add a full-screen preview modal to your Panel pages. The modal can be used before saving to preview a modified record.

You can install the package via composer:

composer require pboivin/filament-peek:"^2.0"

Register a FilamentPeekPlugin instance in your Panel provider:

use Pboivin\FilamentPeek\FilamentPeekPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            FilamentPeekPlugin::make(),
        ]);
}

Then, publish the assets:

php artisan filament:assets

Follow the steps in the Upgrade Guide.

Please feel free to report any issues you encounter with Peek in this repository. I'll work with you to determine where the issue is coming from.

Here are a few example projects available to give this plugin a try:

The documentation is available in the 'docs' directory on GitHub:

• Configuration
  • Publishing the Config File
  • Available Options
  • Integrating With a Custom Theme
• Page Previews
  • Overview
  • Using the Preview Modal on Edit pages
  • Using the Preview Modal on List pages
  • Detecting the Preview Modal
  • Using a Preview URL
  • Embedding a Preview Action into the Form
  • Preview Pointer Events
  • Adding Extra Data to Previews
  • Alternate Templating Engines
• Builder Previews
  • Overview
  • Using Builder Previews on Edit pages
  • Using Multiple Builder Fields
  • Using Custom Fields
  • Customizing the Preview Action
  • Automatically Updating the Builder Preview
  • Adding Extra Data to the Builder Editor State
  • Adding Extra Data to the Builder Preview
  • Alternate Templating Engines
• JavaScript Hooks
• Upgrading from v1.x

Please see CHANGELOG for more information on what has changed recently.

Please see CONTRIBUTING for details.

Please review our security policy on how to report security vulnerabilities.

• Patrick Boivin
• All Contributors

The initial idea is heavily inspired by module previews in Twill CMS.

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