#MWGuerra FileManager

A file manager package for Laravel and Filament v4 with dual operating modes, S3/MinIO support, file previews, and drag-and-drop uploads.

#Features

• Dual operating modes: Database mode (tracked files with metadata) or Storage mode (direct filesystem browsing)
• File browser: Grid and list views, folder tree sidebar, breadcrumb navigation
• File operations: Upload, move, rename, delete with drag-and-drop support
• Multi-selection: Select multiple files with Ctrl/Cmd + click
• File previews: Built-in viewers for video, audio, images, PDF, and text files
• Storage drivers: Works with local, S3, MinIO, or any Laravel Storage driver
• Security: MIME validation, blocked extensions, filename sanitization, signed URLs
• Authorization: Configurable permissions with Laravel Policy support
• Embeddable: Use as standalone pages or embed in Filament forms
• Dark mode: Full dark mode support via Filament

#Requirements

• PHP 8.2+
• Laravel 11.x or 12.x
• Filament 4.x

#Installation

composer require mwguerra/filemanager

Publish configuration:

php artisan vendor:publish --tag=filemanager-config

Run migrations to create the file_system_items table:

php artisan migrate

This table is required for the File Manager (Database Mode) to track uploaded files and folders.

Already have files in storage? If you have existing files in your filesystem that you want to import into the File Manager, run:

php artisan filemanager:rebuild

This will scan your storage and create database records for all existing files.

Register the plugin in your Panel Provider:

use MWGuerra\FileManager\FileManagerPlugin;

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

#Configuring Pages

By default, the plugin registers all pages based on config settings. You can customize which pages to register:

use MWGuerra\FileManager\FileManagerPlugin;
use MWGuerra\FileManager\Filament\Pages\FileManager;
use MWGuerra\FileManager\Filament\Pages\FileSystem;
use MWGuerra\FileManager\Filament\Pages\SchemaExample;
use MWGuerra\FileManager\Filament\Resources\FileSystemItemResource;

// Register all enabled pages (default)
FileManagerPlugin::make()

// Register only specific pages
FileManagerPlugin::make([
    FileManager::class,      // Database mode - full CRUD
    FileSystem::class,       // Storage mode - read-only browser
])

// Register only the File Manager page
FileManagerPlugin::make([
    FileManager::class,
])

// Register only the File System page
FileManagerPlugin::make([
    FileSystem::class,
])

// Include the Schema Example page (for testing embeds)
FileManagerPlugin::make([
    FileManager::class,
    FileSystem::class,
    SchemaExample::class,
])

// Using the fluent API
FileManagerPlugin::make()
    ->only([
        FileManager::class,
        FileSystemItemResource::class,
    ])

#Quick Start

After installation, access the file manager at:

#Embedding in Forms

use MWGuerra\FileManager\Schemas\Components\FileManagerEmbed;
use MWGuerra\FileManager\Schemas\Components\FileSystemEmbed;

// Database mode (full CRUD)
FileManagerEmbed::make()
    ->height('400px')
    ->disk('s3')
    ->target('uploads'),

// Storage mode (read-only browser)
FileSystemEmbed::make()
    ->height('400px')
    ->disk('public')
    ->target('media'),

#Artisan Commands

#filesystem:list

List files directly from a storage disk (recursive by default):

php artisan filesystem:list [path] [options]

#filemanager:list

List files with database or storage mode support:

php artisan filemanager:list [path] [options]

#filemanager:rebuild

Rebuild database from filesystem (clears existing records):

php artisan filemanager:rebuild [options]

#filemanager:upload

Upload a local folder to storage:

php artisan filemanager:upload <path> [options]

#Publishable Assets

#License

MIT License. See LICENSE for details.

#Author

#Marcelo W. Guerra

• Website: mwguerra.com
• Github: mwguerra
• Linkedin: marcelowguerra

#Contributors

• Claudio Pereira
• Fernando dos Santos Souza