PHPackages                             tomatophp/filament-settings-hub - 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. tomatophp/filament-settings-hub

ActiveLibrary

tomatophp/filament-settings-hub
===============================

Manage your Filament app settings with GUI and helpers

4.0.1(7mo ago)5746.1k—9.1%15[5 PRs](https://github.com/tomatophp/filament-settings-hub/pulls)9MITPHPPHP ^8.2|^8.3|^8.4CI passing

Since Apr 6Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/tomatophp/filament-settings-hub)[ Packagist](https://packagist.org/packages/tomatophp/filament-settings-hub)[ GitHub Sponsors](https://github.com/3x1io)[ RSS](/packages/tomatophp-filament-settings-hub/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (16)Versions (21)Used By (9)

[![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-settings-hub/master/arts/fadymondy-tomato-settings-hub.jpg)](https://raw.githubusercontent.com/tomatophp/filament-settings-hub/master/arts/fadymondy-tomato-settings-hub.jpg)

Filament Settings Hub
=====================

[](#filament-settings-hub)

[![Dependabot Updates](https://github.com/tomatophp/filament-settings-hub/actions/workflows/dependabot/dependabot-updates/badge.svg)](https://github.com/tomatophp/filament-settings-hub/actions/workflows/dependabot/dependabot-updates)[![PHP Code Styling](https://github.com/tomatophp/filament-settings-hub/actions/workflows/fix-php-code-styling.yml/badge.svg)](https://github.com/tomatophp/filament-settings-hub/actions/workflows/fix-php-code-styling.yml)[![Tests](https://github.com/tomatophp/filament-settings-hub/actions/workflows/tests.yml/badge.svg)](https://github.com/tomatophp/filament-settings-hub/actions/workflows/tests.yml)[![Latest Stable Version](https://camo.githubusercontent.com/8eab2108a350a075e01b963c586ed9593de2bffc1ab5a761a6066412db3e1255/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d73657474696e67732d6875622f76657273696f6e2e737667)](https://packagist.org/packages/tomatophp/filament-settings-hub)[![License](https://camo.githubusercontent.com/9accfcacc6564a6c74e42f5ca8abee155f61fb2fe52c4721d19be050716c482a/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d73657474696e67732d6875622f6c6963656e73652e737667)](https://packagist.org/packages/tomatophp/filament-settings-hub)[![Downloads](https://camo.githubusercontent.com/6c74a7e1f548c35c164b9c44772f00114da7880a8f64b9027f0e40b6da36f133/68747470733a2f2f706f7365722e707567782e6f72672f746f6d61746f7068702f66696c616d656e742d73657474696e67732d6875622f642f746f74616c2e737667)](https://packagist.org/packages/tomatophp/filament-settings-hub)

Manage your Filament app settings with GUI and helpers

Screenshots
-----------

[](#screenshots)

[![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-settings-hub/master/arts/settings-hub.png)](https://raw.githubusercontent.com/tomatophp/filament-settings-hub/master/arts/settings-hub.png)[![Screenshot](https://raw.githubusercontent.com/tomatophp/filament-settings-hub/master/arts/setting-page.png)](https://raw.githubusercontent.com/tomatophp/filament-settings-hub/master/arts/setting-page.png)

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

[](#installation)

```
composer require tomatophp/filament-settings-hub
```

fadymondy after publish and migrate settings table please run this command

```
php artisan filament-settings-hub:install
```

finally register the plugin on `/app/Providers/Filament/AdminPanelProvider.php`

```
->plugin(
    \TomatoPHP\FilamentSettingsHub\FilamentSettingsHubPlugin::make()
        ->allowSiteSettings()
        ->allowSocialMenuSettings()
)
```

Usage
-----

[](#usage)

you can use this package by use this helper function

```
setting($key, 'default value');
```

to register new setting to the hub page you can use Facade class on your provider like this

```
use TomatoPHP\FilamentSettingsHub\Facades\FilamentSettingsHub;
use TomatoPHP\FilamentSettingsHub\Services\Contracts\SettingHold;

FilamentSettingsHub::register([
    SettingHold::make()
        ->order(2)
        ->label('Site Settings') // to translate label just use direct translation path like `messages.text.name`
        ->icon('heroicon-o-globe-alt')
        ->route('filament.admin.pages.site-settings') // use page / route
        ->page(\TomatoPHP\FilamentSettingsHub\Pages\SiteSettings::class) // use page / route
        ->description('Name, Logo, Site Profile') // to translate label just use direct translation path like `messages.text.name`
        ->group('General') // to translate label just use direct translation path like `messages.text.name`,
]);
```

and now you can see your settings on the setting hub page.

Allow Shield
------------

[](#allow-shield)

to allow [filament-shield](https://github.com/bezhanSalleh/filament-shield) for the settings please install it and config it first then you can use this method

```
->plugin(
    \TomatoPHP\FilamentSettingsHub\FilamentSettingsHubPlugin::make()
        ->allowShield()
)
```

to make a secure setting page just use this trait

```
use TomatoPHP\FilamentSettingsHub\Traits\UseShield;
```

Change Upload File System for Logo / Profile
--------------------------------------------

[](#change-upload-file-system-for-logo--profile)

on your config `filament-settings-hub.php` you can change the file system for the logo / profile

```
'upload' => [
    'disk' => 's3',
    'path' => 'settings',
],
```

Publish Assets
--------------

[](#publish-assets)

you can publish config file by use this command

```
php artisan vendor:publish --tag="filament-settings-hub-config"
```

you can publish views file by use this command

```
php artisan vendor:publish --tag="filament-settings-hub-views"
```

you can publish languages file by use this command

```
php artisan vendor:publish --tag="filament-settings-hub-lang"
```

you can publish migrations file by use this command

```
php artisan vendor:publish --tag="filament-settings-hub-migrations"
```

Testing
-------

[](#testing)

if you like to run `PEST` testing just use this command

```
composer test
```

Code Style
----------

[](#code-style)

if you like to fix the code style just use this command

```
composer format
```

PHPStan
-------

[](#phpstan)

if you like to check the code by `PHPStan` just use this command

```
composer analyse
```

Other Filament Packages
-----------------------

[](#other-filament-packages)

Checkout our [Awesome TomatoPHP](https://github.com/tomatophp/awesome)

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance71

Regular maintenance activity

Popularity44

Moderate usage in the ecosystem

Community23

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 88.2% 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 ~34 days

Recently: every ~84 days

Total

17

Last Release

229d ago

Major Versions

v1.0.10 → v2.x-dev2024-10-30

2.0.2 → 4.0.02025-08-26

PHP version history (3 changes)v1.0.0PHP ^8.1|^8.2

v2.x-devPHP ^8.2|^8.3

2.0.2PHP ^8.2|^8.3|^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/2147eb2fca7ab5f0124d0fafd88ba2d2a5dfa3a0036fb8872d1084b7cba29366?d=identicon)[fadymondy](/maintainers/fadymondy)

---

Top Contributors

[![fadymondy](https://avatars.githubusercontent.com/u/11937812?v=4)](https://github.com/fadymondy "fadymondy (45 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (3 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")

---

Tags

filamentphpfilamentphp-pluginintegrationmanage-settingssettingsspatie-settingsphplaravelSettingsfilamenttomatophpspatie-integrations

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/tomatophp-filament-settings-hub/health.svg)

```
[![Health](https://phpackages.com/badges/tomatophp-filament-settings-hub/health.svg)](https://phpackages.com/packages/tomatophp-filament-settings-hub)
```

###  Alternatives

[tomatophp/filament-pwa

get a PWA feature on your FilamentPHP app with settings from panel

8115.8k](/packages/tomatophp-filament-pwa)[tomatophp/filament-ecommerce

Build your own ecommerce store with FilamentPHP with the Power of Tomato CMS Builder

964.4k1](/packages/tomatophp-filament-ecommerce)[tomatophp/filament-invoices

Generate and manage your invoices / payments using multi currencies and multi types in FilamentPHP

993.9k](/packages/tomatophp-filament-invoices)[tomatophp/filament-media-manager

Manage your media files using spatie media library with easy to use GUI for FilamentPHP

14543.9k3](/packages/tomatophp-filament-media-manager)[tomatophp/filament-payments

Manage your payments inside FilamentPHP app with multi payment gateway integration

542.3k](/packages/tomatophp-filament-payments)[tomatophp/filament-cms

Full CMS System with support of importing integrations and multi meta functions

11410.4k4](/packages/tomatophp-filament-cms)

PHPackages © 2026

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