PHPackages livewire-filemanager/filemanager - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. livewire-filemanager/filemanager ActiveLibrary[File & Storage](/categories/file-storage) livewire-filemanager/filemanager ================================ A simple, friendly and practical Livewire filemanager for your applications v1.1.0(3mo ago)36210.0k—5.9%361MITPHPPHP ^8.2|^8.3CI passing Since Jun 11Pushed 3mo ago5 watchersCompare [ Source](https://github.com/livewire-filemanager/filemanager)[ Packagist](https://packagist.org/packages/livewire-filemanager/filemanager)[ Docs](https://github.com/livewire-filemanager/filemanager)[ Fund](https://www.buymeacoffee.com/bee.interactive)[ GitHub Sponsors](https://github.com/bee-interactive)[ RSS](/packages/livewire-filemanager-filemanager/feed)WikiDiscussions master Synced 3d ago READMEChangelog (2)Dependencies (16)Versions (65)Used By (1)Security (1) ![Livewire filemanager image](./images/banner_light.png) Livewire Filemanager ==================== [](#livewire-filemanager) A simple, friendly, and practical file manager designed specifically for Laravel applications. This Livewire-powered tool makes it easy to manage files and folders within your project, offering an intuitive interface and seamless integration with Laravel's ecosystem. Perfect for developers seeking an efficient and user-friendly solution for file and folders management. - Drag & drop files - Search for files or folders - Ready to include in any projects - Multiple languages (see resources/lang for the list) - Darkmode available - API endpoints Watch the presentation of the package here: [Laravel Switzerland Meetup](https://www.youtube.com/watch?v=lgk_1AtukfM) **[Full Documentation](docs.md)** - Comprehensive guide with detailed examples, API reference, and advanced usage. Project requirements -------------------- [](#project-requirements) - PHP 8.2.0 or greater required Important composer dependencies ------------------------------- [](#important-composer-dependencies) - [livewire/livewire](livewire.laravel.com) - [spatie/laravel-medialibrary](https://spatie.be/docs/laravel-medialibrary) Installation ------------ [](#installation) Important This package is still in development and its structure can change until a stable version is released. Use with caution in you projects. Additionally, the file manager does not include any security layers to protect uploaded documents. You are responsible for controlling access where you install the package and securing your files and folders. You can install the package via [composer](https://getcomposer.org): ``` composer require livewire-filemanager/filemanager ``` Publish the package's migration file: ``` php artisan vendor:publish --tag=livewire-filemanager-migrations ``` This package relies on spatie/medialibrary to handle the medias, so if you haven't already configured the package, don't forget this step: ``` php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-migrations" ``` If you need for informations about the spatie/medialibrary package, please [visit their documentation](https://spatie.be/docs/laravel-medialibrary) Note **Thumbnails** When you upload images, the package will generate a thumbnail. By defaults, it will be dispatched into the queues. You'll have to launch the workers inside your app or change the **QUEUE\_CONNECTION** value in your .env file After that, you need to run migrations. ``` php artisan migrate ``` This will create a `folders` table which will hold all the filemanager structure and a media table if not already present. ### Package configuration [](#package-configuration) Next, you'll need to use the `` component where you want to place the filemanager. For the styles and scripts, the package relies on TailwindCSS and AlpineJS. So if you don't already have them installed, you can include the `@filemanagerScripts` and `@filemanagerStyles`. ``` > @filemanagerStyles @filemanagerScripts ``` Important The @filemanagerStyles will include the PLAY CDN from TailwindCSS which is not recommended for production. Instead, prefer including the path inside your tailwind config file. Tailwind version 4, in your app.css ``` @source '../../vendor/livewire-filemanager/filemanager/resources/views/**/*.blade.php'; ``` Tailwind version 3, in your tailwind.config.js ``` module.exports = { content: [ './resources/**/*.blade.php', './vendor/livewire-filemanager/filemanager/resources/views/**/*.blade.php', ], } ``` If you intend to give access to your files with the public, you can add this inside your web routes file:. ``` Route::get('{path}', [FileController::class, 'show'])->where('path', '.*')->name('assets.show'); ``` And don't forget to import the FileController class: ``` use LivewireFilemanager\Filemanager\Http\Controllers\Files\FileController; ``` This will give you an endpoint where you can reach the files with a direct url. Inside the filemanager, when you click on a file, you'll have the possibility to copy the url to the file. In order to work correctly, this feature needs to have your domain with https enabled. The interface ------------- [](#the-interface) Once everything is installed, the interface should look like this: ![Livewire filemanager interface screenshot](./images/interface-light-mode.jpg) The whole interface is available in dark/light mode. #### ACL Configuration [](#acl-configuration) If you want to enable ACL, you should publish the config file: ``` php artisan vendor:publish --tag=livewire-filemanager-config ``` This will create a `livewire-filemanager.php` file inside your config folder. You can now enable the ACL by changing the `acl_enabled` value to `true`. Also publish the Spatie medialibrary config file, if you haven't already done it. ``` php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="medialibrary-config" ``` In the media-library config file, change the `media_model` value to `LivewireFilemanager\Filemanager\Models\Media`. If you already have a media model, you can use the Trait `LivewireFilemanager\Filemanager\Traits\HasMediaOwner` inside your model. This will ensure that only users who created files can view them. API Integration --------------- [](#api-integration) The package includes a comprehensive REST API for programmatic file and folder management. The API provides endpoints for: - Folder CRUD operations (create, read, update, delete) - File upload and management - Bulk file operations - Authentication and authorization support API endpoints are available under the `/api/filemanager/v1/` prefix and require authentication via Laravel Sanctum. The API can be enabled/disabled and configured through the package configuration file. If upgrading the package, you may update the config file as well inside your project. Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Contributing ------------ [](#contributing) All contributions are welcome and will be fully credited. Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Credits ------- [](#credits) - [Yves Engetschwiler](https://github.com/bee-interactive) - All illustrations are made by [Quetzal Graphic Design](https://quetzal.ch/) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 58 — FairBetter than 98% of packages Maintenance79 Regular maintenance activity Popularity46 Moderate usage in the ecosystem Community26 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 89.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~11 days Total 60 Last Release 108d ago Major Versions v0.1.47 → v1.0.02025-11-23 v0.1.48 → v1.0.22025-12-03 v0.1.49 → v1.0.42026-01-19 v0.1.50 → v1.0.52026-01-22 v0.1.51 → v1.1.02026-03-18 PHP version history (2 changes)v0.1.0PHP ^8.2 v0.1.36PHP ^8.2|^8.3 ### Community Maintainers ![](https://www.gravatar.com/avatar/29a7438db853b772d2db4da9060dff1eae1e23e95216348d810788801ebbda30?d=identicon)[bee-interactive](/maintainers/bee-interactive) --- Top Contributors [![bee-interactive](https://avatars.githubusercontent.com/u/1703353?v=4)](https://github.com/bee-interactive "bee-interactive (191 commits)")[![Rayiumir](https://avatars.githubusercontent.com/u/11635923?v=4)](https://github.com/Rayiumir "Rayiumir (4 commits)")[![zvizvi](https://avatars.githubusercontent.com/u/4354421?v=4)](https://github.com/zvizvi "zvizvi (4 commits)")[![msucevan](https://avatars.githubusercontent.com/u/57497646?v=4)](https://github.com/msucevan "msucevan (3 commits)")[![aliqasemzadeh](https://avatars.githubusercontent.com/u/26847446?v=4)](https://github.com/aliqasemzadeh "aliqasemzadeh (2 commits)")[![boranbar](https://avatars.githubusercontent.com/u/58306089?v=4)](https://github.com/boranbar "boranbar (2 commits)")[![JurgenThijs](https://avatars.githubusercontent.com/u/25119092?v=4)](https://github.com/JurgenThijs "JurgenThijs (1 commits)")[![kidiatoliny](https://avatars.githubusercontent.com/u/48266788?v=4)](https://github.com/kidiatoliny "kidiatoliny (1 commits)")[![MarcelWeidum](https://avatars.githubusercontent.com/u/9413586?v=4)](https://github.com/MarcelWeidum "MarcelWeidum (1 commits)")[![josephbradfield](https://avatars.githubusercontent.com/u/167458762?v=4)](https://github.com/josephbradfield "josephbradfield (1 commits)")[![holymp2006](https://avatars.githubusercontent.com/u/13824510?v=4)](https://github.com/holymp2006 "holymp2006 (1 commits)")[![sToiBe](https://avatars.githubusercontent.com/u/104876928?v=4)](https://github.com/sToiBe "sToiBe (1 commits)")[![hdaklue](https://avatars.githubusercontent.com/u/107682410?v=4)](https://github.com/hdaklue "hdaklue (1 commits)") --- Tags filemanagerlivewire-filemanager ### Code Quality TestsPHPUnit Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/livewire-filemanager-filemanager/health.svg) ``` [![Health](https://phpackages.com/badges/livewire-filemanager-filemanager/health.svg)](https://phpackages.com/packages/livewire-filemanager-filemanager) ``` ### Alternatives [psalm/plugin-laravel Psalm plugin for Laravel 3355.3M346](/packages/psalm-plugin-laravel)[laravel/pulse Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application. 1.7k15.1M132](/packages/laravel-pulse)[tallstackui/tallstackui TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications. 725173.2k14](/packages/tallstackui-tallstackui)[pressbooks/pressbooks Pressbooks is an open source book publishing tool built on a WordPress multisite platform. Pressbooks outputs books in multiple formats, including PDF, EPUB, web, and a variety of XML flavours, using a theming/templating system, driven by CSS. 45444.2k1](/packages/pressbooks-pressbooks)[api-platform/laravel API Platform support for Laravel 58171.6k14](/packages/api-platform-laravel) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)