edrisaturay/filament-starter

A reusable Filament starter package.

dev-main 2026-01-26 23:06 UTC

Requires

• php: ^8.3
• a909m/filament-statefusion: ^2.3
• achyutn/filament-log-viewer: ^2.1
• alizharb/filament-activity-log: ^1.2
• alizharb/filament-module-manager: ^2.2
• archilex/filament-filter-sets: ^5.0
• asmit/resized-column: ^2.1
• bezhansalleh/filament-shield: ^4.1
• charrafimed/global-search-modal: ^5.0
• cheesegrits/filament-phone-numbers: ^2.1
• cocosmos/filament-quick-add-select: ^1.0
• croustibat/filament-jobs-monitor: ^4.1
• edrisaturay/filament-ai-chat-agent: *
• edrisaturay/filament-api-docs-builder: *
• edrisaturay/filament-natural-language-filter: *
• filament/filament: ^5.0
• guava/filament-knowledge-base: ^3.0
• illuminate/support: ^12.0
• jeffgreco13/filament-breezy: ^3.1
• promethys/revive: ^3.0
• pxlrbt/filament-environment-indicator: ^3.4
• rickdbcn/filament-email: ^2.2
• shuvroroy/filament-spatie-laravel-backup: ^3.3
• shuvroroy/filament-spatie-laravel-health: ^3.2
• stechstudio/filament-impersonate: ^4.1
• swisnl/filament-backgrounds: ^2.0
• tapp/filament-authentication-log: ^5.0
• tapp/filament-progress-bar-column: ^1.0
• watheqalshowaiter/filament-sticky-table-header: ^1.4

MIT

• Edrisa A Turay

README

The core engine of the Filament Starter Kit. This package provides centralized plugin management, multi-panel synchronization, and administrative infrastructure for Filament v5 applications.

Key Components

1. Plugin Registry (Support/PluginRegistry.php)

A centralized list of all managed Filament plugins. It defines how each plugin is installed, its default state, and whether it's critical for system stability.

2. Platform Management

The package provides resources for managing the platform directly within your existing panels:

• Plugin Management: Enable/disable plugins per panel and tenant.
• Panel Snapshots: Track registered panels and their configurations.
• System Status: Real-time health checks for the platform and its dependencies.
• Audit Logs: Track all configuration changes made via the Platform UI.

4. Plugin Global Config

The starter kit allows centralized configuration of plugins via config/filament-starter.php. For example, filament-backgrounds settings are managed there.

5. Developer Gate

Secure any route or panel using a static password for developer-only access.

• Enabled/Disabled via config.
• Configurable password.
• Middleware: starter.developer-gate.

4. Plugin Synchronization (Support/PluginSyncManager.php)

Ensures that the database overrides are always in sync with the code-based registry. It automatically handles the creation of default records and cleanup of stale entries.

5. Platform Doctor (Support/Doctor.php)

A diagnostic tool that verifies:

• Platform installation status.
• Presence of panel snapshots.
• Availability of required plugin classes and packages.
• Integrity of tenancy configurations.

Commands

• php artisan starter:install: The primary entry point for setting up the platform. Now supports interactive configuration of plugin publishing, activation, and safety markers.
• php artisan starter:doctor: Diagnostic command for health monitoring.
• php artisan starter:update: Refreshes snapshots and synchronizes the plugin registry.
• php artisan starter:safe-mode: Emergency command to bypass plugin overrides.

Knowledge Base Support

The starter kit includes built-in support for guava/filament-knowledge-base.

• Dedicated Panel: Requires a panel with ID knowledge-base.
• Companion Plugin: Can be enabled per panel via Plugin Management or the installation command.
• Theme Requirements: All panels using KB features MUST have a custom theme with specific Tailwind directives:

  @plugin "@tailwindcss/typography";
  @source '../../../../vendor/guava/filament-knowledge-base/src/**/*';
  @source '../../../../vendor/guava/filament-knowledge-base/resources/views/**/*';

• Diagnostics: starter:doctor will verify panel existence and theme directive compliance.

Filament Backgrounds Support

The starter kit integrates swisnl/filament-backgrounds.

• Installation: Run starter:install to set up background providers and interactive configuration.
• Global Config: Customize attribution, cache time (remember), and image providers in config/filament-starter.php.
• Custom Images: Supports my-images provider with a configurable directory.

Revive Recycle Bin Support

The starter kit integrates promethys/revive for centralized management of deleted records.

• Scoping Control: Configure User-scoping and Tenant-scoping globally via config/filament-starter.php.
• Admin Visibility: Define "Global Admin Panels" where admins can see all deleted records regardless of user or tenant.
• Interactive Setup: Run starter:install to configure scoping preferences and activate the recycle bin for specific panels.

New Interactive Installation Features

During starter:install, you can now:

1. Publish Configs: Interactively choose which plugin configuration files to publish to your application.
2. Activate Plugins per Panel: Select exactly which plugins should be enabled for each of your managed panels.
3. Mark Dangerous Plugins: Identify plugins that are critical for your system. Once marked, these plugins cannot be disabled via the UI, ensuring system stability.

Configuration

The package behavior can be customized via config/filament-starter.php. Key settings include:

• tenancy: Configure multi-tenancy mode and identification strategy.
• multilanguage: Enable and configure supported locales.
• superadmin: Define the role required to access Platform Manager resources.

Usage in Panels

To use the starter kit in any panel, simply register the StarterPlugin:

use EdrisaTuray\FilamentStarter\Filament\StarterPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        // ...
        ->plugins([
            StarterPlugin::make(),
        ]);
}

This will automatically register the Platform Manager resources (for authorized users) and resolve all enabled plugins for that panel.

License

The MIT License (MIT).