Filament Astart is a powerful starter plugin for FilamentPHP, designed to kickstart Laravel admin panels with modular authentication, workflow logic, multilingual support, and prebuilt UI components.
This package relies on the following AuroraWebSoftware components:
-
🛡️ AAuth: Advanced authentication and role-permission management.
-
🔄 Arflow: Workflow engine for dynamic state transitions.
Install the package via Composer:
composer require aurorawebsoftware/filament-astart
Then run the main installation command:
php artisan filament-astart:install
⚠️ Warning: This is a first-time installation command.It will automatically publish and overwrite configuration, language, and stub files using the
--force
flag.Make sure to backup or version control your custom changes before running.
This will:
- Run all necessary migrations
- Publish configuration and language files
- Publish seeders and stubs
- Seed example roles and permissions
- Setup AAuth and Arflow integrations
After running the installation command, make sure to complete the following steps:
Open your Filament panel service provider (usually AdminPanelProvider
) and register the plugin inside the panel()
method:
use AuroraWebSoftware\FilamentAstart\FilamentAstartPlugin;
public function panel(Panel $panel): Panel
{
return $panel
->plugins([
FilamentAstartPlugin::make(),
]);
}
Your User
model must implement the required contract and trait from the AAuth package:
use AuroraWebSoftware\AAuth\Traits\AAuthUser;
use AuroraWebSoftware\AAuth\Contracts\AAuthUserContract;
class User extends Authenticatable implements AAuthUserContract
{
use AAuthUser;
// Your user model logic...
}
This ensures that AAuth can interact properly with your authenticated users.
After installation, you can log in with the following default user credentials (if you seeded the sample data):
Email: [email protected]
Password: password
⚠️ Important: Be sure to change or delete this user in production environments.
You may publish each resource manually if needed:
php artisan vendor:publish --tag="filament-astart-config"
php artisan vendor:publish --tag="filament-astart-lang"
php artisan vendor:publish --tag=filament-astart-seeders
php artisan db:seed --class=SampleFilamentDataSeeder
php artisan vendor:publish --tag=arflow-config
Please see CHANGELOG for more information on what has changed recently.
Contributions are welcome! Please read the CONTRIBUTING guide before submitting pull requests.
If you discover a security vulnerability, please review our security policy for how to report it.
The MIT License (MIT). Please see LICENSE for more information.