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)15889.7k↓28.8%10[3 issues](https://github.com/GuavaCZ/filament-clusters/issues)[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 2d 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 45 — FairBetter than 91% of packages Maintenance40 Moderate activity, may be stable Popularity47 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 494d 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 [rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[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)[codewithdennis/filament-select-tree The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths. 329530.5k29](/packages/codewithdennis-filament-select-tree)[stephenjude/filament-feature-flags Filament implementation of feature flags and segmentation with Laravel Pennant. 122177.8k1](/packages/stephenjude-filament-feature-flags)[finity-labs/fin-mail A powerful email template manager and composer for Filament with dynamic token replacement, template versioning, and inline email sending. 284.5k1](/packages/finity-labs-fin-mail) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)