Download the PHP package emuniq/filament-collapsible-subnav without Composer
On this page you can find all versions of the php package emuniq/filament-collapsible-subnav. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download emuniq/filament-collapsible-subnav
More information about emuniq/filament-collapsible-subnav
Files in emuniq/filament-collapsible-subnav
Package filament-collapsible-subnav
Short Description A Filament v3, v4 & v5 plugin for collapsible sub-navigation sidebar.
License MIT
Homepage https://github.com/Emuniq/filament-collapsible-subnav
Informations about the package filament-collapsible-subnav
Filament Collapsible Sub-Navigation
A Filament v3, v4 & v5 plugin that adds a collapsible toggle to sub-navigation sidebars only. Perfect for resource pages with multiple tabs or sections using ->subNavigationPosition(SubNavigationPosition::Start).
Works with both top navigation and sidebar navigation layouts — the plugin specifically targets the sub-navigation sidebar that appears on individual resource pages, not the main panel navigation.
Without Top Navigation (Sidebar Layout):
With Top Navigation:
Compatibility
| Plugin version | Filament | PHP | Laravel |
|---|---|---|---|
^1.0 |
v3, v4, v5 | 8.1+ | 10 / 11 / 12 / 13 |
Note: This plugin only affects sub-navigation sidebars (the secondary navigation within resource pages), not the main panel sidebar. It works regardless of whether you use top navigation or sidebar navigation for your main panel layout.
Installation
Install the package via composer:
That's it! The plugin auto-registers to all panels and works immediately with zero flash.
Optional: Theme Integration
For a slight performance boost, you can integrate the CSS into your Filament theme:
This bundles the plugin CSS with your theme, reducing HTTP requests. Not required — the plugin works perfectly without this step.
Features
- ✅ Zero configuration — Auto-registers to all panels
- ✅ Collapsible sub-navigation sidebar toggle
- ✅ Persistent state using cookies (server-side rendered to avoid FOUC)
- ✅ Works with SPA mode (
livewire:navigatedre-sync) - ✅ Tooltips for collapsed items (native fallback for v4, Tippy for v3)
- ✅ Responsive — hidden on mobile (<768px)
- ✅ Smooth transitions
- ✅ No theme, npm, or build step required
How It Works
The plugin automatically:
- Registers itself to all Filament panels on installation
- Injects critical CSS in the
<head>to prevent flashes on reload - Adds a toggle button to sub-navigation sidebars only (not main panel navigation)
- Persists the collapsed/expanded state via the
subnav_collapsedcookie - Re-syncs after each Livewire SPA navigation
The plugin detects pages with sub-navigation and only applies to those specific sidebars, leaving your main panel navigation (top or sidebar) untouched.
Manual Registration (Optional)
If you prefer manual control, you can register the plugin explicitly on individual panels:
Troubleshooting
Cloudflare Rocket Loader strips the early script. The plugin marks its critical inline script with data-cfasync="false" so Rocket Loader skips it. If you still see a flash on reload, check that your CDN or HTML minifier preserves the attribute.
SPA mode (->spa()) leaves the toggle out of sync. Fixed since the SPA re-sync patch — the plugin now listens to livewire:navigated and re-applies state on every navigation.
Tooltips don't appear in Filament v4. Filament v4 doesn't expose Tippy globally; the plugin falls back to the native HTML title attribute so a tooltip always shows on hover.
Contributing
Issues and pull requests are welcome on GitHub. For bugs, please include your Filament version, PHP version, and a minimal reproduction.
Maintained by Emuniq
This plugin is built and maintained by Emuniq — a Laravel & Filament consultancy based in Mexico. We help teams ship admin panels, custom Filament resources, and SaaS backoffices.
- 🌐 Website: emuniq.com
- 💼 Need a hand with your Filament project? Get in touch.
- ⭐ If this plugin saves you time, a GitHub star helps others find it.
License
The MIT License (MIT). Please see LICENSE.md for more information.