README

A full-featured file manager package for Laravel applications. Browse, upload, organize, and manage files directly from your app with support for metadata, image editing, galleries, and an embeddable file picker.

Features

• Browse folders and files with list and gallery views
• Upload files or link external URLs
• Create, rename, move, copy, and delete files and folders
• Upload image galleries (multiple files to a new folder in one step)
• File metadata: author, source URL, date, description, tags
• Built-in image editor (crop, rotate, flip, resize, brightness/contrast/saturation, filters)
• File search and filtering by type, extension, author, and size
• Embeddable file picker (for use in CKEditor, TinyMCE, custom inputs, etc.)
• Disk usage stats
• Breadcrumb navigation and sidebar folder tree
• Multilingual: English and Spanish included

Requirements

• PHP 8.3+
• Laravel 13.x

Installation

Install via Composer:

composer require aspectox/ax-filebrowser

Laravel will auto-discover the service provider. Then run the migrations:

php artisan migrate

Publish the assets (CSS and JS):

php artisan vendor:publish --tag=ax-filebrowser-assets

Publishing other resources

Publish only what you need:

# Config file
php artisan vendor:publish --tag=ax-filebrowser-config

# Blade views (to customize them)
php artisan vendor:publish --tag=ax-filebrowser-views

# Language files
php artisan vendor:publish --tag=ax-filebrowser-lang

# Everything at once (config + assets)
php artisan vendor:publish --tag=ax-filebrowser

Configuration

After publishing the config, edit config/ax-filebrowser.php:

return [
    // Root uploads folder, relative to public/
    // Example: 'uploads' → public/uploads
    'uploads_folder' => 'uploads',

    // Label shown in the sidebar and breadcrumb
    // Leave empty to use the folder name automatically
    'root_name' => '',
];

Usage

File Browser

Navigate to /ax-filebrowser in your application. The route is registered automatically.

File Picker

The picker is designed to be embedded in rich text editors or custom file inputs. Open it via:

/ax-filebrowser/picker?callback=myCallbackFunction

The callback parameter is the name of the JavaScript function that will receive the selected file path.

Example with a plain input:

<input type="text" id="file-input" value="">
<button onclick="openPicker()">Browse</button>

<script>
function openPicker() {
    window.open(
        '/ax-filebrowser/picker?callback=onFilePicked',
        'picker',
        'width=1000,height=700'
    );
}

function onFilePicked(path) {
    document.getElementById('file-input').value = path;
}
</script>

Available Routes

File Metadata

Each file can store the following metadata:

Localization

The package ships with English and Spanish. To add another language, publish the lang files and add a new folder:

php artisan vendor:publish --tag=ax-filebrowser-lang

This creates lang/vendor/ax-filebrowser/{locale}/ax-filebrowser.php. Duplicate the en file and translate.

License

MIT — see LICENSE for details.