PHPackages                             nhwin/settings - 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 &amp; Helpers](/categories/utility)
4. /
5. nhwin/settings

ActiveFilament[Utility &amp; Helpers](/categories/utility)

nhwin/settings
==============

A Filament plugin for database-backed application settings and editable content, with caching and easy page generation.

v1.0.1(5mo ago)07MITPHPPHP ^8.2CI passing

Since Sep 29Pushed 5mo agoCompare

[ Source](https://github.com/nhwin304/settings)[ Packagist](https://packagist.org/packages/nhwin/settings)[ Docs](https://github.com/nhwin304/settings)[ RSS](/packages/nhwin-settings/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (7)Versions (3)Used By (0)

Settings – Lightweight settings &amp; content manager for Filament
==================================================================

[](#settings--lightweight-settings--content-manager-for-filament)

[![Run Tests](https://github.com/nhwin304/settings/actions/workflows/tests.yaml/badge.svg)](https://github.com/nhwin304/settings/actions/workflows/tests.yaml)[![Code Style](https://github.com/nhwin304/settings/actions/workflows/code-style.yml/badge.svg)](https://github.com/nhwin304/settings/actions/workflows/code-style.yml)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](https://opensource.org/licenses/MIT)

- [Settings – Lightweight settings &amp; content manager for Filament](#db-config--lightweight-settings--content-manager-for-filament)
    - [Requirements](#requirements)
    - [Installation](#installation)
    - [🚀 Getting Started](#-getting-started)

Requirements
------------

[](#requirements)

- PHP version supported by your Laravel installation
- Laravel 12
- A database engine with JSON support (MySQL 5.7+, MariaDB 10.2.7+, PostgreSQL, SQLite recent versions)
- Filament 4
- PHP ^8.2

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

[](#installation)

1. **Install the package** via Composer:

    ```
    composer require nhwin/settings
    ```
2. **Publish the assets** (Configuration and Migration):

    ```

    php artisan vendor:publish --tag=settings-config

    php artisan vendor:publish --tag=settings-migrations

    php artisan vendor:publish --tag=settings-translations

    php artisan vendor:publish --provider="Nhwin\Settings\Providers\SettingServiceProvider"
    ```
3. **Run the migration**:

    ```
    php artisan migrate
    ```

    This command executes the migration file that you just published, creating the `settings` table (or the custom table name you defined in the config file) in your database. Your package is now ready to use!

Tip

If you want to use a custom table name instead of `settings`, edit the configuration file `config/settings.php` before running the migration. See the [Configuration](#configuration) section for details.

🚀 Getting Started
-----------------

[](#-getting-started)

Get up and running in just a few steps:

1. **Generate Your First Settings Page**

    ```
    php artisan make:settings Website
    ```

    This command creates a new Filament page (e.g., App/Filament/Pages/WebsiteSettings.php). You can repeat this step for more pages as needed.

Note

The generator will automatically add the “Settings” suffix to the page name for consistency (e.g., WebsiteSettings), but you can use any group name you wish.

2. **Define Your Fields**

    Open the generated page and customize the form() method with your desired fields:

    ```
    public function form(Form $form): Form
    {
        return $form
            ->components([
                TextInput::make('site_name')->label('Site Name'),
                TextInput::make('contact_email')->label('Contact Email'),
                Toggle::make('maintenance_mode')->label('Maintenance Mode'),
            ])
            ->statePath('data');
    }
    ```

Note

You may use **any Filament form fields or layout components - including third-party ones -** to build your settings and content pages, giving you full flexibility in how data is structured and edited.

3. **Save and Edit Settings from the Admin Panel**

    You can now edit these settings directly in your Filament admin panel—no extra boilerplate needed.
4. **Use Your Settings Anywhere**

    Retrieve your configuration values easily:

    - In PHP:

        ```
        $siteName = settings('website.site_name', 'Default Site Name');
        ```
    - In Blade:

        ```
        {{ settings('website.site_name', 'Default Site Name') }}

        @settings('website.site_name', 'Default Site Name')
        ```

**That’s it!** 🎉

Define your fields, save from the admin panel, and access your settings anywhere in your Laravel app.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance73

Regular maintenance activity

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~77 days

Total

2

Last Release

153d ago

PHP version history (2 changes)v1.0.0PHP ^8.3

v1.0.1PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/1e6adc68ef83b3ca4cc33a3bee6c1a8e192d7bcdf8919d2c4006532a525ca0f6?d=identicon)[huythang304](/maintainers/huythang304)

---

Top Contributors

[![nhwin304](https://avatars.githubusercontent.com/u/46878854?v=4)](https://github.com/nhwin304 "nhwin304 (47 commits)")

---

Tags

laravelfilamentfilament-pluginlaravel-filament

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nhwin-settings/health.svg)

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

###  Alternatives

[schmeits/filament-character-counter

This is a Filament character counter TextField and Textarea form field for Filament v4 and v5

33184.7k6](/packages/schmeits-filament-character-counter)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[inerba/filament-db-config

A Filament plugin for database-backed application settings and editable content, with caching and easy page generation.

329.1k](/packages/inerba-filament-db-config)[howdu/filament-record-switcher

Resource level navigation with search

1512.5k](/packages/howdu-filament-record-switcher)[wsmallnews/filament-nestedset

Filament nestedset tree builder powered by kalnoy/nestedset with Filament v4 and v5 support

163.0k8](/packages/wsmallnews-filament-nestedset)

PHPackages © 2026

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