- Does theme-aberdeen work with Filament v4 and v5?
- Yes, theme-aberdeen is explicitly built for both Filament v4 and v5. The package includes version checks during installation to ensure compatibility. If you're using an older version, you’ll need to upgrade Filament first.
- How do I install theme-aberdeen in my Laravel project?
- Run `composer require spykapps/theme-aberdeen` followed by `php artisan aberdeen:install`. The installer will detect your Filament panel and set up the theme automatically. Afterward, register the plugin in your `PanelServiceProvider` and compile assets with `npm run build`.
- Will this theme work with Laravel 11 or older versions?
- No, theme-aberdeen requires **Laravel 12.x** and **PHP 8.3** due to its dependencies. If you're on Laravel 11 or earlier, you’ll need to upgrade your project first. Check the [Filament documentation](https://filamentphp.com/docs) for migration guides.
- Can I customize the warm-amber color palette or shadows?
- Yes, the theme is designed to be extensible. You can override the warm-amber colors and shadows by modifying your `tailwind.config.js` file. The package provides clear documentation on how to extend the palette while maintaining theme consistency.
- Does theme-aberdeen support dark mode out of the box?
- Yes, the theme includes full dark mode support, but it assumes Filament’s native dark mode is enabled. If your project uses a custom dark mode implementation, you may need to adjust the CSS variables or override specific styles to ensure compatibility.
- What if I already have a custom theme or CSS in my Filament project?
- Theme-aberdeen is designed to integrate smoothly with existing themes, but conflicts can occur if your custom CSS uses high-specificity selectors. The installer creates a dedicated CSS file for the theme, so you can isolate styles. Always test in a staging environment to catch visual regressions.
- Do I need Node.js/npm to use this theme?
- Yes, theme-aberdeen requires Node.js and npm for asset compilation (`npm run build`). If your project doesn’t already have these set up, you’ll need to install them and ensure your CI/CD pipeline supports the build process.
- Are there any performance concerns with adding this theme?
- The theme adds minimal overhead, primarily through additional CSS. To ensure optimal performance, run Lighthouse audits before and after installation to measure any impact on critical rendering path or bundle size. The compact design helps mitigate performance issues.
- How do I test theme-aberdeen thoroughly before deploying to production?
- Test all Filament components—tables, forms, modals, and widgets—in both light and dark modes. Verify interactive states (hover, focus, active) and ensure third-party Filament plugins (e.g., Spatie Media Library) render correctly. Use a staging environment to catch edge cases.
- What if I need support or run into issues with the theme?
- The package includes an MIT license, so you’re free to modify the code. For support, check the [GitHub repository](https://github.com/SpykApp/theme-aberdeen) for issues or open a new one. Given its low adoption (2 stars, 0 dependents), community support may be limited, so thorough testing is recommended.