- How do I install this package for my Laravel Filament admin panel?
- Run `composer require hammadzafar05/mobile-bottom-nav` and register the plugin in your panel provider using `MobileBottomNav::make()`. No additional configuration is required for basic functionality.
- Does this package work with Filament v5?
- Yes, this package explicitly supports Filament v4 and v5. The latest version includes fixes to ensure compatibility with both versions, including proper navigation ordering.
- Can I customize the number of navigation items shown in the bottom bar?
- Yes, use the `fromNavigation()` method to specify how many items to display. For example, `->fromNavigation(5)` will show 4 items plus a 'More' button. You can also disable the 'More' button entirely.
- Will this package break if I upgrade Filament to v6?
- The package currently supports Filament v4/v5 only. If you upgrade to Filament v6, you’ll need to check for compatibility updates from the maintainer or manually test the package.
- Does the bottom navigation bar support dark mode?
- Yes, the package includes built-in support for dark mode and automatically adapts to Filament’s theme settings without requiring additional configuration.
- How does the bottom nav handle navigation ordering compared to the sidebar?
- The latest version (v1.3) ensures the bottom nav respects Filament’s native sidebar order, eliminating unintended re-sorting. However, if your sidebar order doesn’t match your desired mobile UX, you may need to manually specify items.
- Can I use custom icons or labels for the bottom navigation items?
- The package provides a fluent API to customize items, including icons and labels, but advanced customization may require forking the package or overriding views if the default options aren’t sufficient.
- Is this package compatible with custom Filament themes?
- Yes, the package works with Filament’s default themes and most custom themes, provided they don’t override the navigation rendering logic. Always test with your specific theme to ensure compatibility.
- Does the bottom navigation bar add any performance overhead?
- The package is designed to be lightweight and doesn’t introduce significant performance overhead. However, if you’re concerned, benchmark your application before and after integration to confirm.
- Are there any known issues with accessibility (e.g., screen readers, keyboard navigation)?
- The package follows Filament’s accessibility standards, but no specific accessibility testing updates were mentioned in the latest release. If accessibility is critical, review the generated HTML or test manually.