axn/livewire-upload-handler

Modern file upload handler for Livewire 3 with chunked uploads, image previews, and Spatie Media Library integration

laravel spatie upload file-upload glide livewire media-library chunked-upload

Install
`composer require axn/livewire-upload-handler`
Latest Version:	1.4.1
PHP:	^8.4

Maintainer: axn

Livewire Upload Handler

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>

⚠️ Important: Exclude temporary files from Git:

# Add livewire-tmp/ to main .gitignore
if ! grep -q "livewire-tmp/" storage/app/.gitignore 2>/dev/null; then
    echo "livewire-tmp/" >> storage/app/.gitignore
fi

# Create .gitignore for Glide cache
mkdir -p storage/app/.livewire-upload-handler-glide-cache && \
echo "*" > storage/app/.livewire-upload-handler-glide-cache/.gitignore && \
echo "!.gitignore" >> storage/app/.livewire-upload-handler-glide-cache/.gitignore

See Installation for details.

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