PHPackages                             johncarter/filament-focal-point-picker - 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. johncarter/filament-focal-point-picker

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

johncarter/filament-focal-point-picker
======================================

An image focal point picker for Filament Admin.

v4.2.0(2mo ago)4326.5k↓32.6%10[1 PRs](https://github.com/johncarter-/filament-focal-point-picker/pulls)1MITBladePHP ^8.2

Since Mar 21Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/johncarter-/filament-focal-point-picker)[ Packagist](https://packagist.org/packages/johncarter/filament-focal-point-picker)[ Docs](https://github.com/johncarter/filament-focal-point-picker)[ GitHub Sponsors](https://github.com/johncarter)[ RSS](/packages/johncarter-filament-focal-point-picker/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (12)Versions (19)Used By (1)

An image focal point picker for Filament Admin.
===============================================

[](#an-image-focal-point-picker-for-filament-admin)

A custom field for [Filament Admin](https://github.com/laravel-filament/filament). The field allows you to save a position on an image to act as its focal point, or focus. This can be used with the CSS `object-position` property to crop images on different aspect ratios.

The field returns a `string` with 2 percentages: distance from left, distance from top. e.g. `"17% 54%"`.

[![](https://camo.githubusercontent.com/82154a7add5c043ccce81c70307b35c6d47157140681956be2c48d1f2091d30c/68747470733a2f2f766964656f6170692d6d75796272696467652e76696d656f63646e2e636f6d2f616e696d617465642d7468756d626e61696c732f696d6167652f66383838616366322d383761322d346163352d393563342d6561623961383031373563652e6769663f436c69656e7449443d76696d656f2d636f72652d70726f6426446174653d31363437383832343235265369676e61747572653d63636531326162386237363064323639613162336133653164383861363066663433623862633663)](https://camo.githubusercontent.com/82154a7add5c043ccce81c70307b35c6d47157140681956be2c48d1f2091d30c/68747470733a2f2f766964656f6170692d6d75796272696467652e76696d656f63646e2e636f6d2f616e696d617465642d7468756d626e61696c732f696d6167652f66383838616366322d383761322d346163352d393563342d6561623961383031373563652e6769663f436c69656e7449443d76696d656f2d636f72652d70726f6426446174653d31363437383832343235265369676e61747572653d63636531326162386237363064323639613162336133653164383861363066663433623862633663)

See this video for a demo:

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

[](#installation)

You can install the package via composer:

```
composer require johncarter/filament-focal-point-picker
```

Optionally, you can publish the views using

```
php artisan vendor:publish --tag="filament-focal-point-picker-views"
```

Usage
-----

[](#usage)

```
FileUpload::make('my_image_field')->maxFiles(1),
FocalPointPicker::make('focal_point')
    ->default('10% 25%') // default: "50% 50%"
    ->imageField('my_image_field')
    // Or, return an image url from a closure on the image() method
    // ->image(function() {
    //     return 'https://www.example.com/images/image1.jpg'
    // })
```

Then in your blade template:

```

```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [John Carter](https://github.com/johncarter)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

58

—

FairBetter than 98% of packages

Maintenance86

Actively maintained with recent releases

Popularity41

Moderate usage in the ecosystem

Community19

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 87.5% 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 ~85 days

Recently: every ~95 days

Total

18

Last Release

73d ago

Major Versions

v0.8.0 → v3.0.02024-04-04

v3.1.0 → v4.0.02025-08-08

PHP version history (2 changes)v0.1.0-beta.1PHP ^8.0

v3.0.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/813018?v=4)[johncarter](/maintainers/johncarter)[@JohnCarter](https://github.com/JohnCarter)

---

Top Contributors

[![johncarter-](https://avatars.githubusercontent.com/u/3776888?v=4)](https://github.com/johncarter- "johncarter- (35 commits)")[![FDT2k](https://avatars.githubusercontent.com/u/5261645?v=4)](https://github.com/FDT2k "FDT2k (2 commits)")[![atmonshi](https://avatars.githubusercontent.com/u/1952412?v=4)](https://github.com/atmonshi "atmonshi (1 commits)")[![grafst](https://avatars.githubusercontent.com/u/8471055?v=4)](https://github.com/grafst "grafst (1 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)")

---

Tags

laraveljohncarterfilament-focal-point-picker

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/johncarter-filament-focal-point-picker/health.svg)

```
[![Health](https://phpackages.com/badges/johncarter-filament-focal-point-picker/health.svg)](https://phpackages.com/packages/johncarter-filament-focal-point-picker)
```

###  Alternatives

[awcodes/filament-curator

A media picker plugin for FilamentPHP.

434297.7k19](/packages/awcodes-filament-curator)[joaopaulolndev/filament-pdf-viewer

Filament package to show pdf document viewer

104147.2k3](/packages/joaopaulolndev-filament-pdf-viewer)[saasykit/laravel-open-graphy

An awesome open graph image (social cards) generator package for Laravel.

13057.0k](/packages/saasykit-laravel-open-graphy)[guava/filament-knowledge-base

A filament plugin that adds a knowledge base and help to your filament panel(s).

206120.5k1](/packages/guava-filament-knowledge-base)[vormkracht10/laravel-mails

Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app.

24149.7k](/packages/vormkracht10-laravel-mails)[ace-of-aces/laravel-image-transform-url

Easy, URL-based image transformations inspired by Cloudflare Images.

1756.4k](/packages/ace-of-aces-laravel-image-transform-url)

PHPackages © 2026

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