axn / livewire-upload-handler
Modern file upload handler for Livewire 3 with chunked uploads, image previews, and Spatie Media Library integration
Installs: 9
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 0
Forks: 0
Open Issues: 0
pkg:composer/axn/livewire-upload-handler
Requires
- php: ^8.4
- axn/laravel-glide: ^3.0
- laravel/framework: ^12.0
- livewire/livewire: ^3.1
- spatie/laravel-medialibrary: ^11.0
Requires (Dev)
- driftingly/rector-laravel: ^2.1.3
- laravel/pint: ^1.25.1
- rector/rector: ^2.2.8
README
Modern file upload handler for Livewire 3 with chunked uploads, image previews via Glide, and Spatie Media Library integration.
Features
- Chunked uploads for large files
- Image previews with Glide
- Drag & drop support
- Sortable files (with Sortable.js)
- MIME type & file size validation
- Themeable (CSS classes + icons)
- Spatie Media Library integration
- i18n (English + French)
- Auto-save or manual mode
Requirements
- PHP 8.4+
- Laravel 12+
- Livewire 3.1+
Uses PHP 8.4 features: asymmetric visibility, enums, typed exceptions.
Quick Start
composer require axn/livewire-upload-handler
Add to your layout:
<head> @livewireStyles @livewireUploadHandlerStyles </head> <body> @livewireScripts @livewireUploadHandlerScripts </body>
Single file upload:
<livewire:upload-handler.item />
Documentation
- Installation - Setup and configuration
- Configuration - All config options
- Basic Usage - Single & multiple uploads
- Media Library - Spatie integration
- Customization - Themes, views, translations
- Advanced Usage - Custom components
- Events - Livewire events reference
- Troubleshooting - Common issues
License
MIT License - see LICENSE