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(3mo ago)4330.8k↓41.3%10[1 PRs](https://github.com/johncarter-/filament-focal-point-picker/pulls)1MITBladePHP ^8.2

Since Mar 21Pushed 3mo 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 2d 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

56

—

FairBetter than 97% of packages

Maintenance78

Regular maintenance activity

Popularity42

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

119d 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

[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger

About

104162.2k2](/packages/stephenjude-filament-debugger)[croustibat/filament-jobs-monitor

Background Jobs monitoring like Horizon for all drivers for FilamentPHP

274325.8k8](/packages/croustibat-filament-jobs-monitor)[awcodes/filament-curator

A media picker plugin for FilamentPHP.

437356.9k24](/packages/awcodes-filament-curator)

PHPackages © 2026

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