Skip to content

pboivin/filament-peek

Repository files navigation

Peek

Build Status Latest Stable Version Total Downloads License

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.

Screenshots of the edit page and preview modal

Installation

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

Upgrading from 1.x

Follow the steps in the Upgrade Guide.

Compatibility

Peek Status Filament PHP
1.x Bugfixes only ^2.0 ^8.0
2.x Current version ^3.0 ^8.1

Stability

From the Filament documentation:

Livewire v3 is recently released! The Livewire team have done a great job in making it stable, but it was a complete rewrite of Livewire v2. You may encounter issues, so we recommend testing your application thoroughly before using Filament v3 in production.

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.

Demo Projects

There are 2 demo projects available to try the plugin:

Repository Description
filament-peek-demo Content previews on a simple Filament project with Laravel Blade views.
filament-peek-demo-with-astro Content previews on a more complex project with Filament as "headless CMS", and Astro on the front-end. (Work in progress)

Documentation

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

Changelog

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

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

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

Credits

Acknowledgements

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

License

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