PHPackages                             guava/filament-clusters - 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. guava/filament-clusters

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

guava/filament-clusters
=======================

Filament clusters allow you to cluster multiple fields into one visually.

1.5.0(1y ago)15881.9k—1%10[4 PRs](https://github.com/GuavaCZ/filament-clusters/pulls)1MITPHPPHP ^8.1CI failing

Since Oct 9Pushed 1y ago5 watchersCompare

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

READMEChangelog (7)Dependencies (13)Versions (13)Used By (1)

[![Filament Cluster Banner](docs/images/banner.jpg)](docs/images/banner.jpg)

Filament Clusters
=================

[](#filament-clusters)

[![Latest Version on Packagist](https://camo.githubusercontent.com/2a42656725069921c5a9db82d9a85ee7639add3b83714b882c61a6617dea797d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f67756176612f66696c616d656e742d636c7573746572732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/guava/filament-clusters)[![GitHub Tests Action Status](https://camo.githubusercontent.com/73dbc732ecfc4d08530df43ca0d9def12446b990335316e36b97a31dc10fceb5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f67756176612f66696c616d656e742d636c7573746572732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/guava/filament-clusters/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/fc5d27c6a6cfe940b350009339da8e92593ac1cd7c4bbcfaa960bad85c1e50c3/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f67756176612f66696c616d656e742d636c7573746572732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/guava/filament-clusters/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/806f0ab7e3b7c673dcbd556106b03829df7a4f70fc906df8a08156057b73c80a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f67756176612f66696c616d656e742d636c7573746572732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/guava/filament-clusters)

Filament Clusters allows you to visually cluster multiple fields together.

Functionality wise it is similar to the `Group` component except that the fields look visually as one, which is useful for tighly coupled form fields, such as a currency and amount which only make sense together.

Showcase
--------

[](#showcase)

[![Screenshot 01](docs/images/screenshot_01.jpg)](docs/images/screenshot_01.jpg)

[![Screenshot 02](docs/images/screenshot_02.png)](docs/images/screenshot_02.png)

Support us
----------

[](#support-us)

Your support is key to the continual advancement of our plugin. We appreciate every user who has contributed to our journey so far.

While our plugin is available for all to use, if you are utilizing it for commercial purposes and believe it adds significant value to your business, we kindly ask you to consider supporting us through GitHub Sponsors. This sponsorship will assist us in continuous development and maintenance to keep our plugin robust and up-to-date. Any amount you contribute will greatly help towards reaching our goals. Join us in making this plugin even better and driving further innovation.

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

[](#installation)

You can install the package via composer:

```
composer require guava/filament-clusters
```

Usage
-----

[](#usage)

It's simple as:

```
use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    // Your schema
]);
```

For example for a currency and amount cluster:

```
use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    \Filament\Forms\Components\Select::make('currency')
        ->options(['EUR', 'USD']),

    \Filament\Forms\Components\TextInput::make('amount')
        ->numeric()
        ->required(),
]),
```

#### Customization

[](#customization)

You can add a label, hint, helper text or actions to your Cluster:

```
use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    // Schema
])
    ->label('My label')
    ->hint('Useful hint')
    ->helperText('Help when you\'re stuck');
```

#### Grid

[](#grid)

By default, the cluster automatically distributes the space among each child component. You can however customize it using `columns` and `columnSpan` for each child, just like you're used to from Filament:

```
use Guava\FilamentClusters\Forms\Cluster;

Cluster::make([
    // Schema
])->columns(5);
```

#### Vertical Clusters

[](#vertical-clusters)

To create a vertical clusters, you simply need set the columns of the Cluster to 1:

```
Cluster::make([
    // Schema
])->columns(1);
```

#### Different Breakpoints

[](#different-breakpoints)

The breakpoints use the same system as Filament`s columns, so you can customize each breakpoint by passing in an array:

```
Cluster::make([
    // Schema
])->columns([
    'default' => 1,
    'lg' => 3,
]);
```

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)

- [Lukas Frey](https://github.com/GuavaCZ)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance43

Moderate activity, may be stable

Popularity48

Moderate usage in the ecosystem

Community20

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 73.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 ~72 days

Recently: every ~87 days

Total

8

Last Release

448d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/42d872f5f47cd71cfd46c8fbd6ec77a6bfb46d6d9499b5e1f843eb407c07f737?d=identicon)[Skrypt](/maintainers/Skrypt)

---

Top Contributors

[![lukas-frey](https://avatars.githubusercontent.com/u/10926334?v=4)](https://github.com/lukas-frey "lukas-frey (14 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![dev-idkwhoami](https://avatars.githubusercontent.com/u/26493113?v=4)](https://github.com/dev-idkwhoami "dev-idkwhoami (1 commits)")[![saulens22](https://avatars.githubusercontent.com/u/9000854?v=4)](https://github.com/saulens22 "saulens22 (1 commits)")

---

Tags

laravelGuavafilament-clusters

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/guava-filament-clusters/health.svg)

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

###  Alternatives

[guava/calendar

Adds support for vkurko/calendar to Filament PHP.

298241.0k3](/packages/guava-calendar)[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[creagia/filament-code-field

A Filamentphp input field to edit or view code data.

58289.3k3](/packages/creagia-filament-code-field)[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)[swisnl/filament-backgrounds

Beautiful backgrounds for Filament auth pages

54149.2k6](/packages/swisnl-filament-backgrounds)

PHPackages © 2026

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