axn / livewire-upload-handler
Modern file upload handler for Livewire 3 with chunked uploads, image previews, and Spatie Media Library integration
Installs: 1
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
This package is auto-updated.
Last update: 2025-12-02 16:31:38 UTC
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 handlers, enums, exceptions
- Events - Livewire events reference
- Troubleshooting - Common issues
- API Reference - Complete component reference
License
MIT License - see LICENSE