PHPackages                             r64/nova-image-cropper - 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. [Image & Media](/categories/media)
4. /
5. r64/nova-image-cropper

ActiveLibrary[Image & Media](/categories/media)

r64/nova-image-cropper
======================

A Laravel Nova field.

1.1.5(7y ago)56303.1k↓33%16[12 issues](https://github.com/64robots/nova-image-cropper/issues)[8 PRs](https://github.com/64robots/nova-image-cropper/pulls)MITVuePHP >=7.1.0

Since Aug 31Pushed 3y ago1 watchersCompare

[ Source](https://github.com/64robots/nova-image-cropper)[ Packagist](https://packagist.org/packages/r64/nova-image-cropper)[ RSS](/packages/r64-nova-image-cropper/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (25)Used By (0)

Image Field with built-in cropper for Laravel Nova
==================================================

[](#image-field-with-built-in-cropper-for-laravel-nova)

This field extends Image Field adding a handy cropper to manipulate images. Can be configurable in the same way as a [File field in Nova](https://nova.laravel.com/docs/1.0/resources/file-fields.html).

### Demo

[](#demo)

[![Demo](https://camo.githubusercontent.com/9b16f0ae34717ca2ae17ecb259889e884983c5ea5416de381d588fedd7362d38/687474703a2f2f672e7265636f726469742e636f2f397562574462714e4e4c2e676966)](https://camo.githubusercontent.com/9b16f0ae34717ca2ae17ecb259889e884983c5ea5416de381d588fedd7362d38/687474703a2f2f672e7265636f726469742e636f2f397562574462714e4e4c2e676966)

### Install

[](#install)

Run this command into your nova project: `composer require r64/nova-image-cropper`

### Add it to your Nova Resource:

[](#add-it-to-your-nova-resource)

```
use R64\NovaImageCropper\ImageCropper;

ImageCropper::make('Photo'),
```

### Update form

[](#update-form)

In order to edit the existing image saved in the model, ImageCroper uses the preview method to return a base64 encoded image. You can either use the default implementation or override it as long as you return a base64 image.

```
use R64\NovaImageCropper\ImageCropper;

ImageCropper::make('Photo')
        ->preview(function () {
            if (!$this->value) return null;

            $url = Storage::disk($this->disk)->url($this->value);
            $filetype = pathinfo($url)['extension'];
            return 'data:image/' . $filetype . ';base64,' . base64_encode(file_get_contents($url));
        });
```

### Options

[](#options)

#### Avatar mode

[](#avatar-mode)

You can add a rounded mask to the preview and the cropper

```
ImageCropper::make('Photo')->avatar()
```

#### Custom aspect ratio

[](#custom-aspect-ratio)

Define the fixed aspect ratio of the crop box.

- Type: Number
- Default: NaN

```
ImageCropper::make('Photo')->aspectRatio(16/9)
```

For free ratio use:

```
ImageCropper::make('Photo')->aspectRatio(0)
```

### Localization

[](#localization)

Set your translations in the corresponding xx.json file located in `/resources/lang/vendor/nova`

```
...

  "Edit Image": "Editar Imagen",
  "Cancel Crop": "Cancelar Recorte",
  "Change Image": "Cambiar Imagen",
  "Done": "Hecho",
  "Click here or drop the file to upload": "Click aquí o arrastra el archivo para comenzar la subida"
```

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance16

Infrequent updates — may be unmaintained

Popularity48

Moderate usage in the ecosystem

Community17

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

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

Total

16

Last Release

2651d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/88e19e84d31e5f50eb2e338915669ae04f507a643fa24f88afc870520d8bef23?d=identicon)[64robots](/maintainers/64robots)

---

Top Contributors

[![beliolfa](https://avatars.githubusercontent.com/u/12644599?v=4)](https://github.com/beliolfa "beliolfa (27 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (17 commits)")[![cretueusebiu](https://avatars.githubusercontent.com/u/1517945?v=4)](https://github.com/cretueusebiu "cretueusebiu (1 commits)")[![icaroce](https://avatars.githubusercontent.com/u/13601799?v=4)](https://github.com/icaroce "icaroce (1 commits)")[![riesjart](https://avatars.githubusercontent.com/u/23455176?v=4)](https://github.com/riesjart "riesjart (1 commits)")

---

Tags

laravelnova

### Embed Badge

![Health badge](/badges/r64-nova-image-cropper/health.svg)

```
[![Health](https://phpackages.com/badges/r64-nova-image-cropper/health.svg)](https://phpackages.com/packages/r64-nova-image-cropper)
```

###  Alternatives

[classic-o/nova-media-library

Tool and field that will let you managing files and add them to the posts

154180.4k](/packages/classic-o-nova-media-library)[mostafaznv/nova-ckeditor

CkEditor for Laravel Nova

58376.5k1](/packages/mostafaznv-nova-ckeditor)[mostafaznv/nova-video

Video Field for Laravel Nova

22437.2k2](/packages/mostafaznv-nova-video)[silvanite/nova-field-cloudinary

A Laravel Nova Image Field with Flysystem Adapter for storing and retrieving media from Cloudinary

2772.3k3](/packages/silvanite-nova-field-cloudinary)[stepanenko3/nova-media-field

A Laravel Nova field for laravel-medilibrary.

1817.8k](/packages/stepanenko3-nova-media-field)[ajhaupt7/image-upload-preview

A Laravel Nova field for dragging and dropping images to upload, along with a preview.

1139.6k](/packages/ajhaupt7-image-upload-preview)

PHPackages © 2026

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