branzia/settings

A powerful FilamentPHP settings manager with dynamic schema support, .env and database storage, and a fully integrated admin panel.

dev-main 2025-07-25 07:05 UTC

Requires

• php: >=8.0
• jackiedo/dotenv-editor: ^1.1

MIT

• Visvanathan D

• config
• laravel
• Settings
• admin-panel
• dotenv
• developer-tools
• env-editor
• filament
• filamentphp
• settings-panel
• database-settings
• dynamic-forms

README

A powerful settings manager built for FilamentPHP, allowing you to manage .env and database-stored settings with a dynamic schema and beautiful admin panel.

🔧 Built with flexibility, extendability, and developer-friendliness in mind.

✨ Features

• ✅ Manage .env variables visually via Filament
• ✅ Store & retrieve settings from a dedicated database table
• ✅ Create settings dynamically using reusable schema classes
• ✅ Group settings by tab, section, and sort order
• ✅ Extend existing settings using extend() method
• ✅ Automatically registers with Filament sidebar
• ✅ Fully customizable and modular

🧱 Installation

composer require branzia/settings

⚙️ Usage Defining Settings Form

Extend the Branzia\Settings\Contracts\FormSchema contract in your own class:

namespace App\Settings;

use Branzia\Settings\Contracts\FormSchema;
use Filament\Forms;

class SiteSettings extends FormSchema
{
    public static string $tab = 'Site';
    public static string $group = 'General';
    public static int $sort = 1;

    public static function env(): array
    {
        return [
            'app.name' => 'APP_NAME',
        ];
    }

    protected static function baseSchema(): array
    {
        return [
            Forms\Components\TextInput::make('app.name')
                ->label('Site Name')
                ->required(),
        ];
    }
}

🔁 The env() method maps form fields to .env variables for persistence.

🔁 Syncing to .env and Laravel Config

You can link form inputs to Laravel config and environment variables by defining the env() method in your schema:

public static function env(): array
{
    return [
        'app.name' => 'APP_NAME',
        'app.debug' => 'APP_DEBUG',
        'mail.mailer' => 'MAIL_MAILER',
    ];
}