PHPackages                             codz/uploader - 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. [Templating & Views](/categories/templating)
4. /
5. codz/uploader

ActiveLibrary[Templating & Views](/categories/templating)

codz/uploader
=============

A modern, flexible drag-and-drop file uploader component for Laravel

1.0.0(1y ago)03MITJavaScriptPHP >=7.4

Since Apr 18Pushed 1y ago1 watchersCompare

[ Source](https://github.com/thecodezz/codz-uploader-package)[ Packagist](https://packagist.org/packages/codz/uploader)[ RSS](/packages/codz-uploader/feed)WikiDiscussions main Synced 1mo ago

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

 [![CODz Uploader Logo](codz-logo.png)](codz-logo.png)CODz File Uploader for Laravel
==============================

[](#codz-file-uploader-for-laravel)

 [![Version](https://camo.githubusercontent.com/34e695c6016bc2a934a96bed696e29b2f2ab562a7134d65a55d00653cd506bea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d626c75652e737667)](https://camo.githubusercontent.com/34e695c6016bc2a934a96bed696e29b2f2ab562a7134d65a55d00653cd506bea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f76657273696f6e2d312e302e302d626c75652e737667) [![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667) [![Author](https://camo.githubusercontent.com/60d61b71eda1d934a33f7a5421eae9934b5a8555d93d4edc4505b889ccd17cd0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d41686d6564253230416c692d6f72616e67652e737667)](https://camo.githubusercontent.com/60d61b71eda1d934a33f7a5421eae9934b5a8555d93d4edc4505b889ccd17cd0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f617574686f722d41686d6564253230416c692d6f72616e67652e737667)

A modern, flexible drag-and-drop file uploader component for Laravel applications
---------------------------------------------------------------------------------

[](#a-modern-flexible-drag-and-drop-file-uploader-component-for-laravel-applications)

Features
--------

[](#features)

- ✅ Drag & drop file upload interface
- ✅ Single or multiple file upload support
- ✅ File type validation
- ✅ File size limitation
- ✅ Image preview for supported formats
- ✅ File type icons for non-image files
- ✅ Easy file deletion
- ✅ Built-in RTL support (Arabic)
- ✅ Fully styled and customizable
- ✅ Works with Laravel forms

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

[](#installation)

You can install the package via composer:

```
composer require codz/uploader
```

Then publish the package assets and component:

```
php artisan vendor:publish --tag="codz-uploader"
```

This will publish:

- JavaScript and CSS assets to `public/vendor/codz-uploader/`
- Blade component to `resources/views/components/codz-uploader.blade.php`

### Include Assets

[](#include-assets)

For proper functionality, make sure to include the CSS in your document `` and the JavaScript file at the end of your ``:

```

```

Basic Usage
-----------

[](#basic-usage)

### Single File Upload

[](#single-file-upload)

```

```

### Multiple File Upload

[](#multiple-file-upload)

```

```

### With Existing Files

[](#with-existing-files)

```

```

### With Arabic Language Support (RTL)

[](#with-arabic-language-support-rtl)

```

```

### Using Inside a Laravel Form

[](#using-inside-a-laravel-form)

```

    @csrf

    Submit

```

Configuration Options
---------------------

[](#configuration-options)

OptionTypeDefaultDescription`name`string`'image'`Input name attribute`label`string`'Browse Files'`Upload component label`multiple`boolean`false`Enable multiple file uploads`hasLabel`boolean`true`Show/hide the label`required`boolean`false`Make the file upload required`accept`string`'.png, .jpg, .jpeg'`Allowed file types`maxSize`string`'500'`Maximum file size in KB`files`array/string`[]`Pre-populated files`deleteRouteName`string`null`Route name for file deletion`deleteMethod`string`'GET'`HTTP method for deletion (GET, POST, DELETE)`lang`string`'en'`Language ('en' or 'ar' for Arabic)Alternative Usage Methods
-------------------------

[](#alternative-usage-methods)

### Using Blade Component Directive

[](#using-blade-component-directive)

```
@component('codz-uploader::components.uploader', [
    'name' => 'document',
    'label' => 'Upload Document',
    'multiple' => false,
    'required' => true,
    'accept' => '.pdf,.docx',
    'maxSize' => '5120'
])
@endcomponent
```

### Using Blade Include

[](#using-blade-include)

```
@include('codz-uploader::components.uploader', [
    'name' => 'document',
    'label' => 'Upload Document',
    'multiple' => false,
    'required' => true,
    'accept' => '.pdf,.docx',
    'maxSize' => '5120'
])
```

Supported File Types
--------------------

[](#supported-file-types)

The uploader accepts file types based on MIME types or extensions:

```
// For images
accept=".jpg,.jpeg,.png,.gif,.webp"

// For documents
accept=".pdf,.doc,.docx,.xls,.xlsx,.ppt,.pptx"

// For videos
accept=".mp4,.webm,.mov,.avi"

// Using MIME types
accept="image/*,application/pdf"

// Multiple types
accept="image/*,application/pdf,.docx"
```

Custom Styling
--------------

[](#custom-styling)

The uploader comes with a pre-styled interface, but you can customize it by overriding CSS variables:

```
:root {
  --uploader-primary: #4a90e2;  /* Primary color */
  --uploader-border: #dbe1e9;   /* Border color */
  --uploader-text: #333333;     /* Text color */
  --uploader-bg: #f9f9f9;       /* Background color */
  --uploader-error: #e74c3c;    /* Error state color */
  --uploader-success: #2ecc71;  /* Success state color */
}
```

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance47

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity37

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

396d ago

### Community

Maintainers

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

---

Top Contributors

[![a7medali-dev](https://avatars.githubusercontent.com/u/219508544?v=4)](https://github.com/a7medali-dev "a7medali-dev (9 commits)")

---

Tags

laravelbladecomponentfile-uploaddrag-drop

### Embed Badge

![Health badge](/badges/codz-uploader/health.svg)

```
[![Health](https://phpackages.com/badges/codz-uploader/health.svg)](https://phpackages.com/packages/codz-uploader)
```

###  Alternatives

[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.2k438.5k29](/packages/tightenco-jigsaw)[radic/blade-extensions

Laravel package providing additional Blade extensions: foreach (with $loop data like twig), break, continue, set,array (multiline), etc

271321.7k5](/packages/radic-blade-extensions)

PHPackages © 2026

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