Weave Code
Filament Collapsible Subnav Laravel Package
emuniq/filament-collapsible-subnav
Filament v3–v5 plugin that adds a collapsible toggle to resource page sub-navigation sidebars (secondary nav), working with both top navigation and sidebar layouts. Auto-registers to all panels with zero configuration; optional theme CSS bundling.
A Filament v3, v4 & v5 plugin for collapsible sub-navigation sidebar.
Frequently asked questions about Filament Collapsible Subnav
- How do I add collapsible sub-navigation to my Filament v5 admin panel?
- Install the package via Composer (`composer require emuniq/filament-collapsible-subnav`) and it auto-registers to all panels. No configuration is needed—it works immediately with Filament v5’s sub-navigation sidebars (e.g., resource pages using `SubNavigationPosition::Start`).
- Does this plugin work with Filament’s top navigation layout?
- Yes, the plugin supports both top navigation and sidebar layouts. It specifically targets the sub-navigation sidebar (secondary nav) on resource pages, not the main panel navigation. Works seamlessly in both configurations.
- Will this break my existing Filament v3 or v4 installation?
- No, the plugin is backward-compatible with Filament v3 and v4. It explicitly supports versions ^3.0, ^4.0, and ^5.0 with no breaking changes, so upgrading or downgrading won’t disrupt functionality.
- How do I integrate the plugin’s CSS into my Filament theme for better performance?
- Run `php artisan collapsible-subnav:install` followed by `npm run build`. This bundles the plugin’s CSS with your theme, reducing HTTP requests. However, the plugin works perfectly without this step—it’s optional.
- Does this plugin support dark mode in Filament?
- Yes, the plugin’s tooltips and collapsible elements automatically respect Filament’s dark mode class (`.dark`). No additional configuration is required for dark/light theme compatibility.
- Can I use this with Cloudflare Rocket Loader or other script optimizers?
- The plugin includes a documented workaround for Cloudflare Rocket Loader. If you encounter rendering issues, exclude the plugin’s scripts from Rocket Loader or use the CSS-only tooltip fallback. Check the README for specifics.
- What if I have custom sub-navigation implementations beyond `SubNavigationPosition::Start`?
- The plugin auto-detects standard Filament sub-navigation sidebars. For custom Blade templates or non-standard setups, manual integration may be required. Test thoroughly if your sub-navigation deviates from Filament’s defaults.
- Are there any known issues with Filament v5’s SPA mode?
- The plugin includes fixes for SPA mode using Livewire’s `livewire:navigated` listener to prevent state desync issues during navigation. However, test thoroughly in SPAs to ensure smooth collapsible behavior across page transitions.
- How do I roll back if Filament v5 breaks compatibility later?
- Pin to version `v1.5.0` if you’re concerned about early Filament v5 adoption. Monitor the Filament v5 changelog for breaking changes, as the plugin’s compatibility depends on Filament’s sidebar structure (e.g., `.fi-sidebar-item-btn`).
- What are the PHP and Laravel version requirements for this package?
- The package requires PHP 8.1+ and supports Laravel 10, 11, 12, and 13. It’s designed to work with modern Laravel stacks and aligns with Filament’s version constraints (v3–v5).
Weaver
How can I help you explore Laravel packages today?