- Does Awrel work with Filament v5 or only v3.x?
- Awrel is explicitly built for **Filament v3.x** and will not work with v5 without modifications. Attempting to use it with v5 may cause errors or broken layouts. If you’re using Filament v5, consider alternatives like Filament UI or a custom fork.
- How do I install Awrel in my Laravel project?
- Run `composer require khoirulaksara/awrel` followed by `php artisan awrel:install`. This command publishes assets, runs migrations, and auto-configures the plugin in `bootstrap/providers.php`. Ensure you’re using **Filament v3.x**, Laravel 11/12/13, and Tailwind CSS v4.
- Will Awrel’s animations slow down my Filament dashboard?
- Awrel includes micro-interactions like skeleton loaders and glassmorphism effects, which rely on JavaScript and CSS animations. Test performance on low-end devices, especially if your users have slow connections. Disable opt-in features (e.g., favicon spinner) if needed via custom JS/CSS.
- Can I customize the glassmorphism effect or other styles?
- Yes, Awrel’s glassmorphism and other UI elements are built with Tailwind CSS. Override styles in your `tailwind.config.js` or publish Awrel’s assets (`php artisan vendor:publish --tag=awrel-assets`) to modify the `resources/views/vendor/filament/` templates. Backup your original `theme.css` before publishing.
- Does Awrel support dark mode, and how do I enable it?
- Awrel includes full dark mode support out of the box. Enable it via the **Settings page** in your Filament admin panel, where you can toggle dark/light mode globally. Ensure your Tailwind config includes dark mode classes (`dark:`) for full compatibility.
- What if I need sticky table actions but they conflict with my existing Filament setup?
- Sticky table actions are opt-in and require manual configuration. Check the `deferLoading()` JavaScript function in Awrel’s assets and ensure it doesn’t conflict with your existing Livewire event listeners. If conflicts arise, disable the feature via custom CSS/JS or fork the package.
- Are there alternatives to Awrel for Filament v5 users?
- If you’re using **Filament v5**, Awrel isn’t compatible. Consider alternatives like **Filament UI** (a modern theme plugin for v5) or **Filament Nova** for a more polished admin experience. For custom animations, use Alpine.js or Tailwind keyframes instead of Awrel’s built-in features.
- How do I update Awrel to the latest version?
- Run `composer update khoirulaksara/awrel` to update the package. Always back up your `resources/views/vendor/filament/` and `tailwind.config.js` before updating, as breaking changes may occur. Monitor the package’s GitHub repo for release notes.
- Can I use Awrel without Tailwind CSS or Livewire?
- No, Awrel **requires** Tailwind CSS (v4) and Livewire (v4) to function. It leverages Tailwind for styling and Livewire for dynamic interactions like skeleton loaders. If you’re not using these, Awrel won’t work without significant modifications.
- What should I do if Awrel breaks my Filament admin panel?
- First, restore your original `theme.css` and `resources/views/vendor/filament/` files from backup. If the issue persists, check for Tailwind config conflicts or JavaScript errors in the browser console. For critical bugs, consider forking the package or switching to a v5-compatible alternative like Filament UI.