Drilldown sidebar

• Requirements
• Version Compatibility
• Installation
• Usage
• How It Works
• Screenshot
• License

A Filament plugin that adds optional drill-down navigation to sidebar groups. Instead of the default collapsible accordion, selected groups display as clickable buttons that slide into a detail view showing the group's items.

Groups not marked for drill-down keep the standard Filament collapsible behavior. Both styles can coexist in the same sidebar, rendered in their original registration order.

#Requirements

• PHP 8.1+
• Filament 3.x, 4.x, or 5.x
• Laravel 10, 11, or 12

#Version Compatibility

The plugin automatically detects your Filament version and publishes the correct sidebar view:

• Filament 3.x: Publishes a Blade component override (components/sidebar/index.blade.php)
• Filament 4.x / 5.x: Publishes a Livewire view override (livewire/sidebar.blade.php)

Note: After upgrading Filament to a new major version, re-publish the views:

php artisan vendor:publish --tag=drilldown-sidebar-views --force

#Installation

composer require osamaatef/filament-drilldown-sidebar

Publish the sidebar view:

php artisan vendor:publish --tag=drilldown-sidebar-views

#Usage

Register the plugin in your panel provider and pass the labels of the groups that should use drill-down navigation:

use OsamaAtef\DrilldownSidebar\DrilldownSidebarPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            DrilldownSidebarPlugin::make()
                ->drilledGroups([
                    'Service Management',
                    'Content Management',
                ]),
        ]);
}

Groups listed in drilledGroups() will render as a button with a chevron. Clicking it slides into a detail view with the group's items and a back button. All other groups render as the standard Filament collapsible accordion.

#How It Works

• Main view: Ungrouped items (Dashboard, etc.) appear first, followed by all labeled groups in their original registration order. Drilled groups show as buttons; standard groups show as collapsible accordions.
• Detail view: Clicking a drilled group slides in a panel showing the group title, icon, and its navigation items. A back button returns to the main view.
• Collapsed sidebar: When the sidebar is collapsed (icon-only mode), all groups use Filament's default icon dropdown regardless of drill-down status.
• Auto-drill: If the current page belongs to a drilled group, the sidebar automatically opens that group's detail view on page load.

#Screenshot

#License

MIT License. See LICENSE for details.