PHPackages                             akhaled/livewire-files - 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. akhaled/livewire-files

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

akhaled/livewire-files
======================

Upload and browse files using livewire

0.0.1-beta(5y ago)21MITBlade

Since Nov 18Pushed 5y ago2 watchersCompare

[ Source](https://github.com/akhled/livewire-files)[ Packagist](https://packagist.org/packages/akhaled/livewire-files)[ RSS](/packages/akhaled-livewire-files/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Livewire files
===============

[](#livewire-files-)

Uploading file using [Livewire](https://laravel-livewire.com/) and [Tailwind](https://tailwindui.com/).

- [Installation](#installation)
- [Requirements](#requirements)
- [How to use](#how-to-use)
- [Configuration](#configuration)
- [Plan](#plan)

Installation
------------

[](#installation)

`composer require akhaled/livewire-files`

Requirements
------------

[](#requirements)

Frontend packages are required:

- [AlpineJS](https://github.com/alpinejs/alpine)
- [Tailwind Components](https://tailwindui.com/components)
- [Sweetalert2](https://sweetalert2.github.io/)

How to use
----------

[](#how-to-use)

### 1. Add livewire component to your view

[](#1-add-livewire-component-to-your-view-)

This component only displays a button within your content. This button is linked to [tailwind modal](https://tailwindui.com/components/application-ui/overlays/modals).

```
@livewire('files-upload', [
    'image' => true, // accept only image, optional
    'mimes' => 'pdf,csv', // or specify mime type, optional
    'max' => 1024 // max 1024kb by default
])
```

### 2. Add scripts

[](#2-add-scripts-)

```
...
@livewireScript

@livewireSweetalertScripts
...
```

Configuration
-------------

[](#configuration)

`php artisan vendor:publish --tag=livewire-files`

Will generate global config file.

### `store_dir`

[](#store_dir-)

Default is public (`storage/public`). You need to add the following line in config/filesystems.php under links property:

> `public_path('storage') => storage_path('app/public')`

### `validation`

[](#validation-)

- `image`: only accept images, default = `false`
- `mimes`: accepted mimes, default = `null` (accepting everything)
- `max`: maximum uploaded size, default = `102400` (in kilobytes)

Plan
----

[](#plan)

- Show toast on uploaded!
- Hide input file and show javascript link
- Move content to modal
- Show sweetalert popups instead of static alert
- Add button text and button color for upload button
- Specify upload files names
- Move uploads to directory year/month/day

###  Health Score

19

—

LowBetter than 9% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

2052d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b287abe0508bd1591fc87a4d0b770a9545fe6033e9be97f1fcab4d5ec78753c6?d=identicon)[akhaled](/maintainers/akhaled)

---

Top Contributors

[![akhled](https://avatars.githubusercontent.com/u/74369977?v=4)](https://github.com/akhled "akhled (1 commits)")

### Embed Badge

![Health badge](/badges/akhaled-livewire-files/health.svg)

```
[![Health](https://phpackages.com/badges/akhaled-livewire-files/health.svg)](https://phpackages.com/packages/akhaled-livewire-files)
```

###  Alternatives

[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

724160.4k14](/packages/tallstackui-tallstackui)[spatie/livewire-filepond

Upload files using Filepond in Livewire components

310601.6k5](/packages/spatie-livewire-filepond)[dasundev/livewire-dropzone

A Livewire Dropzone component for simple drag-and-drop file uploads.

22999.1k](/packages/dasundev-livewire-dropzone)[filament/support

Core helper methods and foundation code for all Filament packages.

2331.0M241](/packages/filament-support)[nasirkhan/laravel-starter

A CMS like modular Laravel starter project.

1.4k2.7k](/packages/nasirkhan-laravel-starter)[yajra/laravel-datatables-export

Laravel DataTables Queued Export Plugin.

362.2M4](/packages/yajra-laravel-datatables-export)

PHPackages © 2026

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