promethys/revive

A 'RecycleBin' page where users can restore or delete permanently soft-deleted models.

1.2.0 2025-07-13 16:09 UTC

Requires

• php: ^8.2
• filament/filament: ^3.0
• filament/forms: ^3.0
• filament/tables: ^3.0
• illuminate/contracts: ^12.0|^11.0
• illuminate/database: *
• illuminate/support: *
• spatie/laravel-package-tools: ^1.15.0

Requires (Dev)

• laravel/pint: ^1.0
• nunomaduro/collision: ^8.1
• orchestra/testbench: ^8.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/extension-installer: ^1.1
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-phpunit: ^1.0
• spatie/laravel-ray: ^1.26

MIT

• Ilainiriko Tambaza

• laravel
• revive
• filament
• RecycleBin
• Promethys

README

Filament RecycleBin for Laravel Models

Revive is a plugin for FilamentPHP that brings a central Recycle Bin to your application. It lets you restore or permanently delete soft-deleted Eloquent models in just a few clicks.

This plugin is especially useful for SaaS applications, admin dashboards, or any multi-user platform where recovering accidentally deleted data is important.

Features

• View, restore, and permanently delete soft-deleted records from a dedicated Filament page
• Register multiple models as "Recyclable" with a simple trait
• Filter items by model type or search through deleted records
• Customize the plugin’s appearance and behavior with ease
• User and multi-tenancy support (⌛ in development, available in v2)

⚠️ Filament v4 Compatibility

Filament v4 is currently in beta, and this plugin does not support it yet.

We will begin testing and adapting the package once Filament v4 reaches a more stable release stage. Until then, please use this plugin with Filament v3.x only.

Trying to install this plugin on Filament v4 may result in unexpected errors or breaking changes.

Stay tuned for updates when full support becomes available.

Installation

Install the package via Composer:

composer require promethys/revive
php artisan revive:install

If you prefer to manually publish and run the migrations:

php artisan vendor:publish --tag="revive-migrations"
php artisan migrate

Configuration

Register the plugin in your panel:

use Promethys\Revive\RevivePlugin;

$panel->plugins([
    RevivePlugin::make()
]);

You can also customize the plugin using fluent configuration:

use Promethys\Revive\RevivePlugin;

$panel->plugins([
    RevivePlugin::make()
        ->authorize(auth()->user()->isAdmin()) // Accepts a boolean or Closure to control access
        ->navigationGroup('Settings') // Group the page under a custom sidebar section
        ->navigationIcon('heroicon-o-archive-box-arrow-down')
        ->activeNavigationIcon('heroicon-o-archive-box-arrow-down')
        ->navigationSort(1)
        ->navigationLabel('Custom Label')
        ->title('Custom Title')
        ->slug('custom-slug')
]);

⚠️ The plugin currently supports only the models in the App\Models namespace. If you want to register a third-party model (e.g., from another package), create a wrapper class that extends it and add the Recyclable trait there:

namespace App\Models;

use Promethys\Revive\Traits\Recyclable;
use Vendor\Package\Models\Foo as BaseFoo;

class Foo extends BaseFoo
{
    use SoftDeletes;
    use Recyclable;
}

Usage

Once the plugin is installed and configured, you’ll see a new page in your Filament navigation menu.
From there, users can restore deleted data or permanently remove it.

In the V1, Revive will show in a single table all the Recyclable records, without any user-specific scope. You may use the plugin in your admin panel for now. User-specific scope will be available in V2

1. Add the Recyclable trait to any soft-deletable model

use Promethys\Revive\Concerns\Recyclable;

class Post extends Model
{
    use SoftDeletes;
    use Recyclable;
}

ℹ️ Important: Adding the Recyclable trait without using SoftDeletes will throw an exception.

2. Optional: Discover existing soft-deleted records

If you already have soft-deleted records before installing the plugin, you’ll soon be able to “discover” them by running:

php artisan revive:discover-soft-deleted

🧪 This command is planned for V2.

Use the table outside the default page

You don’t have to register the plugin in your panel to use the table.

Instead, you can render the Livewire component directly in a Blade view:

@livewire(\Promethys\Revive\Tables\RecycleBin::class)

This is ideal if:

• You don’t want to clutter your navigation
• You’re not using Filament Panels but still want a recycle bin in your app

🐛 Issue Guidelines

If you encounter a bug or unexpected behavior, please help us help you by following these guidelines:

• 👉 Create an issue on GitHub: Create an issue on Github
• Describe the issue clearly: What did you try to do? What did you expect to happen? What actually happened?
• Include relevant code snippets: Show any relevant model, config, or page setup related to the issue.
• Share error messages: If possible, paste the full error output or stack trace.
• Attach screenshots: Visuals often help us understand UI-related bugs or logic problems more quickly.
• Mention your setup: Let us know your PHP version, Laravel version, Filament version, and the version of this plugin.

The more details you provide, the faster and better we can help. Thank you!

Contributing

See CONTRIBUTING for guidelines.

Credits

• Ilainiriko Tambaza
• mintellity/laravel-recycle-bin — inspiration for this package

License

This project is open-sourced under the MIT license.
See LICENSE.md for more details.