muazzambuilds/filament-recycle-bin

Central soft-deletes recycle bin for Filament v5 — restore or permanently delete trashed records from one panel page.

v1.0.0 2026-07-13 17:46 UTC

Requires

• php: ^8.2
• filament/filament: ^5.0
• illuminate/contracts: ^11.0|^12.0
• illuminate/database: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• orchestra/testbench: ^9.0|^10.0
• phpunit/phpunit: ^11.0

MIT

• Muazzam Builds

• laravel
• trash
• soft-deletes
• filament
• filament-plugin
• recycle-bin

Published on Packagist.org on 2026-07-13 17:54 UTC

README

Filament Recycle Bin

Central soft-deletes recycle bin for Filament v5. Register once, then restore or permanently delete trashed records from every SoftDeletes model in one place.

Requirements

Dependency	Version
PHP	^8.2
Laravel	^11 / ^12
Filament	^5.0

Installation

composer require muazzambuilds/filament-recycle-bin

Publish config (optional):

php artisan vendor:publish --tag=filament-recycle-bin-config

Register the plugin:

use MuazzamBuilds\FilamentRecycleBin\RecycleBinPlugin;

$panel->plugin(
    RecycleBinPlugin::make()
        ->discoverModels() // scans app/Models for SoftDeletes
);

Or register models explicitly:

use App\Models\Post;
use App\Models\Comment;

$panel->plugin(
    RecycleBinPlugin::make()
        ->models([
            Post::class,
            Comment::class,
        ])
);

Usage

Open Recycle Bin in the panel navigation.

From there you can:

• Search and filter trashed records by model type
• Restore a single record or selected rows
• Permanently delete a single record or selected rows
• Empty the entire bin for registered models

Authorization

RecycleBinPlugin::make()
    ->authorize(fn (): bool => auth()->user()->isAdmin());

Configuration

// config/filament-recycle-bin.php
return [
    'navigation_group' => null,
    'navigation_sort' => -1,
    'navigation_icon' => 'heroicon-o-trash',
    'title_attributes' => ['title', 'name', 'label', 'email', 'subject', 'slug'],
    'per_model_limit' => 500,
];

License

MIT — see LICENSE.