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

ActiveLibrary

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

Upload and browse files using livewire

0.0.1-beta(5y ago)31MITBlade

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 today

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 10% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity39

Early-stage or recently created project

 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

2000d 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

[laravel/pulse

Laravel Pulse is a real-time application performance monitoring tool and dashboard for your Laravel application.

1.7k12.1M99](/packages/laravel-pulse)[power-components/livewire-powergrid

PowerGrid generates Advanced Datatables using Laravel Livewire.

1.7k1.7M6](/packages/power-components-livewire-powergrid)[livewire/flux

The official UI component library for Livewire.

9385.0M86](/packages/livewire-flux)[livewire/volt

An elegantly crafted functional API for Laravel Livewire.

4195.3M84](/packages/livewire-volt)[jantinnerezo/livewire-alert

This package provides a simple alert utilities for your livewire components.

8041.2M20](/packages/jantinnerezo-livewire-alert)[leandrocfe/filament-apex-charts

Apex Charts integration for Filament PHP.

4861.2M8](/packages/leandrocfe-filament-apex-charts)

PHPackages © 2026

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