PHPackages                             nuhel/filament-croppie - 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. [Utility & Helpers](/categories/utility)
4. /
5. nuhel/filament-croppie

ActiveLibrary[Utility & Helpers](/categories/utility)

nuhel/filament-croppie
======================

1.1.1(3y ago)182.2k7[1 issues](https://github.com/Nuhel/FilamentCroppie/issues)MITBladePHP ^8.0

Since Dec 20Pushed 3y ago2 watchersCompare

[ Source](https://github.com/Nuhel/FilamentCroppie)[ Packagist](https://packagist.org/packages/nuhel/filament-croppie)[ RSS](/packages/nuhel-filament-croppie/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (1)Versions (8)Used By (0)

Filament Croppie Plugin
=======================

[](#filament-croppie-plugin)

[![Latest Version on Packagist](https://camo.githubusercontent.com/36e5131b4f0074e66ca87ae9cbfa67bf4d424021726acf23c76d64922d96c24f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e7568656c2f66696c616d656e742d63726f707069652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nuhel/filament-croppie)[![Total Downloads](https://camo.githubusercontent.com/d01322eb315de378f908cf83bcb301471dc5e94686ae069cf8e655eb9156b549/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e7568656c2f66696c616d656e742d63726f707069652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/nuhel/filament-croppie)

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

[](#installation)

You can install the package via composer:

```
composer require nuhel/filament-croppie
```

This field has most of the same functionality of the [Filament File Upload](https://filamentphp.com/docs/2.x/forms/fields#file-upload) field.

[![screenshot of square croppie](./images/square-example.png)](./images/square-example.png)

```
  Croppie::make('image')
      ->getUploadedFileNameForStorageUsing(function (TemporaryUploadedFile $file): string {
          return (string)str("image_path/" . $file->hashName());
      })->enableDownload()
      ->enableOpen()
      ->imageResizeTargetWidth('1000')
      ->imageResizeTargetHeight('800'),
```

Using `imageResizeTargetWidth` and `imageResizeTargetHeight` we can set width and height of the cropper.

```
Croppie::make('avatar')->avatar()
    ->enableOpen()->enableDownload()
    ->imageResizeTargetWidth('300')
    ->imageResizeTargetHeight('300')
    ->modalSize('xl'),
```

By default, the size of the resulting image will correspond to `imageResizeTargetWidth` and `imageResizeTargetHeight`. Using `keepOriginalSize`, the size of the resulting image will be at the original scale of the image.

```
Croppie::make('avatar')->avatar()
    ->enableOpen()->enableDownload()
    ->imageResizeTargetWidth('300')
    ->imageResizeTargetHeight('300')
    ->keepOriginalSize()
    ->modalSize('xl'),
```

By default, there is no outer container of the cropper. Using `withBoundary`, we can specify the outer container of the cropper. The specified value is in pixel and will be added to the width and the height of the cropper.

```
Croppie::make('avatar')->avatar()
    ->enableOpen()->enableDownload()
    ->imageResizeTargetWidth('300')
    ->imageResizeTargetHeight('300')
    ->withBoundary('30')
    ->modalSize('xl'),
```

We can make croppie circular using `avater` method. [![screenshot of big modal](./images/circural-example.png)](./images/circural-example.png)

Modal size can be customized if it is needed, using `modalSize` method.

```
Croppie::make('background')
    ->enableDownload()
    ->enableOpen()
    ->imageResizeTargetWidth('1000')
    ->imageResizeTargetHeight('400')
    ->modalSize('6xl')
    ->modalHeading("Crop Background Image")
```

[![screenshot of big modal](./images/7xl-modal-example.png)](./images/7xl-modal-example.png)

This Plugin is still under development. Some Croppie Feature need's to be implemented, but it provides the main feature of Croppie.

License
-------

[](#license)

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

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 85.7% 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 ~14 days

Recently: every ~21 days

Total

7

Last Release

1158d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1705ec0b2fad294ffd82d57464fd85888afaaab3c2d362a71d8addb6be1820ca?d=identicon)[Nuhel](/maintainers/Nuhel)

---

Top Contributors

[![Nuhel](https://avatars.githubusercontent.com/u/30118433?v=4)](https://github.com/Nuhel "Nuhel (18 commits)")[![bnzo](https://avatars.githubusercontent.com/u/17174973?v=4)](https://github.com/bnzo "bnzo (3 commits)")

---

Tags

laravelnuhelfilament-croppie

### Embed Badge

![Health badge](/badges/nuhel-filament-croppie/health.svg)

```
[![Health](https://phpackages.com/badges/nuhel-filament-croppie/health.svg)](https://phpackages.com/packages/nuhel-filament-croppie)
```

###  Alternatives

[guava/calendar

Adds support for vkurko/calendar to Filament PHP.

298241.0k3](/packages/guava-calendar)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

9169.0k4](/packages/marcelweidum-filament-expiration-notice)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)[outerweb/filament-settings

Filament integration for the outerweb/settings package

3690.9k4](/packages/outerweb-filament-settings)

PHPackages © 2026

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