PHPackages                             axn/livewire-upload-handler - 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. axn/livewire-upload-handler

ActiveLibrary[File & Storage](/categories/file-storage)

axn/livewire-upload-handler
===========================

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

1.4.1(2mo ago)199[2 PRs](https://github.com/AXN-Informatique/livewire-upload-handler/pulls)MITPHPPHP ^8.4CI passing

Since Dec 2Pushed 2mo agoCompare

[ Source](https://github.com/AXN-Informatique/livewire-upload-handler)[ Packagist](https://packagist.org/packages/axn/livewire-upload-handler)[ Docs](https://github.com/AXN-Informatique/livewire-upload-handler)[ RSS](/packages/axn-livewire-upload-handler/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (18)Used By (0)

Livewire Upload Handler
=======================

[](#livewire-upload-handler)

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

Features
--------

[](#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
------------

[](#requirements)

- PHP 8.4+
- Laravel 12+
- Livewire 3.1+

> Uses PHP 8.4 features: asymmetric visibility, enums, typed exceptions.

Quick Start
-----------

[](#quick-start)

```
composer require axn/livewire-upload-handler
```

Add to your layout:

```

    @livewireStyles
    @livewireUploadHandlerStyles

    @livewireScripts
    @livewireUploadHandlerScripts

```

**⚠️ 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](docs/installation.md#git-configuration-important) for details.

Single file upload:

```

```

Documentation
-------------

[](#documentation)

- **[Installation](docs/installation.md)** - Setup and configuration
- **[Configuration](docs/configuration.md)** - All config options
- **[Basic Usage](docs/basic-usage.md)** - Single & multiple uploads
- **[Media Library](docs/media-library.md)** - Spatie integration
- **[Customization](docs/customization.md)** - Themes, views, translations
- **[Advanced Usage](docs/advanced-usage.md)** - Custom components
- **[Events](docs/events.md)** - Livewire events reference
- **[Troubleshooting](docs/troubleshooting.md)** - Common issues

License
-------

[](#license)

MIT License - see [LICENSE](LICENSE)

Credits
-------

[](#credits)

- [AXN Informatique](https://github.com/AXN-Informatique)
- [Livewire](https://livewire.laravel.com/)
- [Glide](https://glide.thephpleague.com/)
- [Spatie Media Library](https://spatie.be/docs/laravel-medialibrary/)

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance86

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 75.5% 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 ~9 days

Total

12

Last Release

68d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1314974?v=4)[Axel Neumann](/maintainers/axn)[@axn](https://github.com/axn)

---

Top Contributors

[![lgtaxn](https://avatars.githubusercontent.com/u/23211553?v=4)](https://github.com/lgtaxn "lgtaxn (74 commits)")[![forxer](https://avatars.githubusercontent.com/u/407917?v=4)](https://github.com/forxer "forxer (24 commits)")

---

Tags

spatielaravellivewireuploadglidemedia libraryfile-uploadchunked-upload

###  Code Quality

Static AnalysisRector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/axn-livewire-upload-handler/health.svg)

```
[![Health](https://phpackages.com/badges/axn-livewire-upload-handler/health.svg)](https://phpackages.com/packages/axn-livewire-upload-handler)
```

###  Alternatives

[spatie/livewire-filepond

Upload files using Filepond in Livewire components

306452.7k3](/packages/spatie-livewire-filepond)[mwguerra/filemanager

A full-featured file manager package for Laravel and Filament v5 with dual operating modes, drag-and-drop uploads, S3/MinIO support, and comprehensive security features.

718.5k1](/packages/mwguerra-filemanager)[kingofcode/laravel-uploadable

Laravel Uploadable trait to automatically upload images and files with minimum configuration

286.4k](/packages/kingofcode-laravel-uploadable)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)