FilaWarden by Spiggle

• ⚡ Key Highlights & Important Architecture Info
• 📦 Features (Core Edition)
• 📋 Requirements
• 🛠️ Installation
• 🔌 Filament Admin Panel Registration
• ⚙️ Automated Telemetry Scheduling
• 💻 Artisan Commands
  • Run Deployment Audit
  • Check Published Advisories
  • Collect Telemetry Snapshot
• 🧪 Testing
• 🚀 Advanced Edition
• 📹 Demo Video
• 🔒 Security & Reporting
• Sponsors
• 📄 License

High-Performance Operations Intelligence, Health Auditor & Production Sentinel for Filament.

FilaWarden is a native operations intelligence suite built specifically for Laravel Filament. Designed to eliminate expensive third-party SaaS monitoring subscriptions, FilaWarden embeds deployment readiness auditing, queue worker tracking, cron overseer telemetry, and system diagnostics directly into your Filament admin panel with zero external background daemons.

#⚡ Key Highlights & Important Architecture Info

• Zero External Daemons: No Node.js agents, Golang sidecars, or Docker daemons to maintain. Runs entirely on standard PHP runtime telemetry.
• Non-Blocking Low Overhead: Telemetry sampling uses native /proc and SQL engine caches with sub-millisecond execution times.
• Filament v5 & v4 Certified: Native support for Filament's latest responsive design patterns, dark mode, slide-over modals, and Livewire v3 components.
• Mobile-Optimized: Features a responsive dual-presentation layout—rendering touch-friendly cards on mobile devices and wide data tables on desktop viewports.

#📦 Features (Core Edition)

#📋 Requirements

• PHP: 8.2, 8.3, 8.4, or 8.5
• Laravel Framework: 11.x, 12.x, or 13.x
• Filament: 4.x or 5.x
• Database: MySQL 8.x, MariaDB 10.x, PostgreSQL 14+, or SQLite 3

#🛠️ Installation

Install FilaWarden Core via Composer:

composer require spiggle/filawarden-core

Publish the configuration file (optional):

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

#🔌 Filament Admin Panel Registration

Register FilaWardenPlugin inside your Filament Panel Provider (typically app/Providers/Filament/AdminPanelProvider.php):

namespace App\Providers\Filament;

use Filament\Panel;
use Filament\PanelProvider;
use Spiggle\FilaWarden\FilaWardenPlugin;

class AdminPanelProvider extends PanelProvider
{
    public function panel(Panel $panel): Panel
    {
        return $panel
            ->default()
            ->id('admin')
            ->path('admin')
            ->plugin(
                FilaWardenPlugin::make()
                    // All modules are enabled by default, or disable individually:
                    // ->deploymentAuditor(false)
                    // ->queueMonitor(false)
            );
    }
}

#⚙️ Automated Telemetry Scheduling

To record telemetry snapshots and run scheduled health audits automatically, add the commands to your routes/console.php (or app/Console/Kernel.php):

use Illuminate\Support\Facades\Schedule;

// Collect system telemetry every minute without overlapping:
Schedule::command('filawarden:collect')->everyMinute()->withoutOverlapping();

// Run deployment readiness check daily:
Schedule::command('filawarden:audit')->dailyAt('01:00');

#💻 Artisan Commands

#Run Deployment Audit

php artisan filawarden:audit

# Format output as JSON for CI/CD pipelines:
php artisan filawarden:audit --json

#Check Published Advisories

php artisan filawarden:advisories

# Bypass the cache and print JSON:
php artisan filawarden:advisories --fresh --json

#Collect Telemetry Snapshot

php artisan filawarden:collect

#🧪 Testing

Run the automated test suite via PHPUnit / Pest:

composer test
# or via Laravel test runner:
php artisan test --filter=FilaWardenPluginTest

#🚀 Advanced Edition

Looking for automated secret scanning, APM slow query tracing, and multi-channel incident response? Explore FilaWarden Advanced.

#📹 Demo Video

Watch on YouTube - Laravel Monitoring Inside Filament: FilaWarden Full Tour (Free)

#🔒 Security & Reporting

If you discover a security vulnerability within FilaWarden, please review our Security Policy and send an e-mail to [email protected]. All reports are investigated promptly.

#Sponsors

If this package is useful, consider supporting development:

#📄 License

The MIT License (MIT). Please see License File for more information.