PHPackages                             moonshine/filepond - 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. moonshine/filepond

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

moonshine/filepond
==================

Description

0.2.1(3mo ago)4431[1 issues](https://github.com/moonshine-software/filepond/issues)MITPHPPHP ^8.2CI passing

Since Jan 18Pushed 3mo agoCompare

[ Source](https://github.com/moonshine-software/filepond)[ Packagist](https://packagist.org/packages/moonshine/filepond)[ Docs](https://getmoonshine.app)[ RSS](/packages/moonshine-filepond/feed)WikiDiscussions 1.x Synced 1mo ago

READMEChangelog (4)DependenciesVersions (5)Used By (0)

[![Total Downloads](https://camo.githubusercontent.com/856e5cd9acc8fd7f7e41730ef589422d788d06a595d3748612ef06e39a26381f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d6f6f6e7368696e652f66696c65706f6e64)](https://packagist.org/packages/moonshine/filepond)[![Latest Stable Version](https://camo.githubusercontent.com/2254ee6cffceb34e2c44e1c244fba716cf4ab8b3e4baf0a017d2d0816db1e5ed/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d6f6f6e7368696e652f66696c65706f6e64)](https://packagist.org/packages/moonshine/filepond)[![License](https://camo.githubusercontent.com/761d2b15a6385d0d182ea9cceb0c3f58748a67a5ae0fa0af87ca3dbd6705a637/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d6f6f6e7368696e652f66696c65706f6e64)](https://packagist.org/packages/moonshine/filepond)

 [![Laravel 10+](https://camo.githubusercontent.com/67ff25342790de50f83c6313acb28d5fdd1d7931a63bf481f21ea769b7b1ca1c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302b2d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c)](https://laravel.com) [![PHP 8.2+](https://camo.githubusercontent.com/233addbd8bc6c491cd7a929fd0305ab4d0144a078f8f346dfeb9421d929ac128/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322b2d3737374242343f7374796c653d666f722d7468652d6261646765266c6f676f3d706870)](https://laravel.com)

MoonShine FilePond
==================

[](#moonshine-filepond)

A modern file upload field for [MoonShine](https://github.com/moonshine-software/moonshine) admin panel, powered by the [FilePond](https://pqina.nl/filepond/) JavaScript library.

Features
--------

[](#features)

- Drag and drop file uploads
- Image previews with customizable dimensions
- Multiple file uploads with grid layout
- File reordering via drag and drop
- File type validation
- Localization support (EN, RU)
- Seamless integration with MoonShine v4+

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

[](#requirements)

- PHP 8.2+
- Laravel 10+
- MoonShine 4.0+

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

[](#installation)

Install the package via Composer:

```
composer require moonshine/filepond
```

Publish assets:

```
php artisan vendor:publish --tag=moonshine-filepond-assets
```

Optionally, publish translations:

```
php artisan vendor:publish --tag=moonshine-filepond-lang
```

Usage
-----

[](#usage)

### Basic Usage

[](#basic-usage)

```
use MoonShine\Filepond\Fields\Filepond;

Filepond::make('Avatar', 'avatar')
    ->disk('public')
    ->dir('avatars');
```

### Multiple Files

[](#multiple-files)

```
Filepond::make('Gallery', 'images')
    ->disk('public')
    ->dir('gallery')
    ->multiple();
```

> **Note:** When using `multiple()`, ensure your model has the appropriate cast for the attribute:
>
> ```
> protected function casts(): array
> {
>     return [
>         'images' => 'array', // or 'collection', 'json'
>     ];
> }
> ```

### With File Type Restrictions

[](#with-file-type-restrictions)

```
Filepond::make('Documents', 'files')
    ->disk('public')
    ->dir('documents')
    ->multiple()
    ->acceptExtensions('pdf', 'doc', 'docx');
```

Configuration Methods
---------------------

[](#configuration-methods)

### Item Dimensions

[](#item-dimensions)

Set the preview item height with optional min/max values:

```
Filepond::make('Image')
    ->itemHeight(150)           // height: 150px
    ->itemHeight(150, 50, 200); // height: 150px, min: 50px, max: 200px
```

### Grid Layout

[](#grid-layout)

To disable grid layout and stack items vertically:

```
Filepond::make('Files')
    ->multiple()
    ->vertical();
```

### Aspect Ratio

[](#aspect-ratio)

Set the panel aspect ratio for the upload area:

```
Filepond::make('Cover')
    ->aspectRatio('16:9'); // or '1:1', '4:3', etc.
```

### Compact Mode

[](#compact-mode)

Enable compact layout where the preview replaces the drop area:

```
Filepond::make('Thumbnail')
    ->compact();
```

Complete Example
----------------

[](#complete-example)

```
use MoonShine\Filepond\Fields\Filepond;

public function fields(): array
{
    return [
        // Single file with aspect ratio and compact mode
        Filepond::make('Thumbnail', 'thumbnail')
            ->disk('public')
            ->dir('thumbnails')
            ->acceptExtensions('jpg', 'jpeg', 'png', 'webp')
            ->aspectRatio('16:9')
            ->compact(),

        // Multiple files in a grid layout
        Filepond::make('Gallery', 'images')
            ->disk('public')
            ->dir('gallery')
            ->multiple()
            ->itemHeight(180, 100, 200)
            ->acceptExtensions('jpg', 'jpeg', 'png', 'gif', 'webp'),

        // Documents with vertical layout
        Filepond::make('Documents', 'documents')
            ->disk('public')
            ->dir('documents')
            ->multiple()
            ->vertical()
            ->acceptExtensions('pdf', 'doc', 'docx', 'xls', 'xlsx'),
    ];
}
```

Localization
------------

[](#localization)

The package includes translations for English and Russian. To customize translations, publish the language files:

```
php artisan vendor:publish --tag=moonshine-filepond-lang
```

Translation files will be published to `lang/vendor/moonshine-filepond/`.

License
-------

[](#license)

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

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance73

Regular maintenance activity

Popularity15

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.3% 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 ~0 days

Total

5

Last Release

117d ago

Major Versions

0.2.1 → 1.x-dev2026-01-21

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1861327?v=4)[Danil Shutsky](/maintainers/lee-to)[@lee-to](https://github.com/lee-to)

---

Top Contributors

[![lee-to](https://avatars.githubusercontent.com/u/1861327?v=4)](https://github.com/lee-to "lee-to (12 commits)")[![wispoz](https://avatars.githubusercontent.com/u/156639?v=4)](https://github.com/wispoz "wispoz (1 commits)")

---

Tags

keyword

### Embed Badge

![Health badge](/badges/moonshine-filepond/health.svg)

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

###  Alternatives

[knplabs/gaufrette

PHP library that provides a filesystem abstraction layer

2.5k39.8M123](/packages/knplabs-gaufrette)[google/cloud-storage

Cloud Storage Client for PHP

34390.8M125](/packages/google-cloud-storage)[illuminate/filesystem

The Illuminate Filesystem package.

15261.6M2.6k](/packages/illuminate-filesystem)[superbalist/flysystem-google-storage

Flysystem adapter for Google Cloud Storage

26320.6M30](/packages/superbalist-flysystem-google-storage)[creocoder/yii2-flysystem

The flysystem extension for the Yii framework

2931.7M62](/packages/creocoder-yii2-flysystem)[flowjs/flow-php-server

PHP library for handling chunk uploads. Works with flow.js html5 file uploads.

2451.6M15](/packages/flowjs-flow-php-server)

PHPackages © 2026

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