- How do I install BaksDev Dashboard in a Laravel 10+ project?
- Run `composer require baks-dev/dashboard` to install via Composer. Then execute `php bin/console baks:assets:install` to set up configuration and assets. Ensure your project uses PHP 8.4+ and Laravel 10+ for compatibility.
- Does this package work with Eloquent ORM, or only Doctrine?
- BaksDev Dashboard relies on Doctrine migrations and DBAL/ORM, so it’s best suited for projects already using Doctrine. If your app uses Eloquent exclusively, conflicts may arise, and you’ll need to evaluate alternatives like Filament or Nova.
- Can I customize the dashboard widgets or themes without forking the package?
- The package likely supports overriding Blade templates and assets, but documentation is minimal. Check for service provider hooks or event listeners in the codebase. If none exist, you may need to extend or modify core files directly.
- What Laravel versions are officially supported by BaksDev Dashboard?
- The package requires PHP 8.4+ and is designed for Laravel 10+. While it may work with older versions, no guarantees are provided. Always test thoroughly in a staging environment before production deployment.
- How do I handle database migrations if I’m already using Laravel’s native migrations?
- BaksDev Dashboard uses Doctrine migrations (`doctrine:migrations:diff` and `migrate`). To avoid conflicts, either merge its migrations into your existing Laravel migration system or run them separately. Backup your database before applying changes.
- Are there any known conflicts with Vite or Webpack asset pipelines?
- The `baks:assets:install` command copies assets to `public/` or `resources/`. If using Vite or Webpack, manually configure your build tool to ignore or process these files to prevent overwrites or duplicate assets.
- Does BaksDev Dashboard support real-time data or Livewire/Inertia.js integration?
- There’s no explicit mention of Livewire or Inertia.js support in the documentation. The package likely relies on Blade templates and traditional AJAX for dynamic updates. Test compatibility or extend it manually if real-time features are critical.
- How do I test the dashboard functionality in my Laravel app?
- Run `php bin/phpunit --group=dashboard` to execute the package’s test suite. For integration testing, mock the dashboard routes and widgets in your own test suite. Ensure your test environment mirrors production (e.g., Doctrine setup, asset paths).
- What are the alternatives to BaksDev Dashboard for Laravel admin panels?
- Consider Filament, Nova, or Backpack for more mature solutions with larger communities. AdminLTE or CoreUI offer lightweight frontend templates if you prefer DIY backend logic. Evaluate each based on your needs: Filament for customization, Nova for SaaS, or Backpack for open-source flexibility.
- How do I handle permissions or role-based access in the dashboard?
- The package likely includes basic permission logic, but specifics aren’t documented. Check for middleware or policy classes in the source code. For advanced RBAC, integrate Laravel’s built-in `Gate` or `Policy` system or use packages like Spatie’s Laravel-Permission alongside BaksDev Dashboard.