Download the PHP package aurorawebsoftware/filament-astart without Composer

Filament Astart

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.

📦 Included Dependencies

This package relies on the following AuroraWebSoftware components:

• 🛡️ AAuth: Advanced authentication and role-permission management.

• 🔄 Arflow: Workflow engine for dynamic state transitions.

🚀 Installation

Install the package via Composer:

Then run the main installation command:

⚠️ 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

📥 Post-Installation Setup

After running the installation command, make sure to complete the following steps:

1️⃣ Register the plugin in your Filament panel provider

Open your Filament panel service provider (usually AdminPanelProvider) and register the plugin inside the panel() method:

2️⃣ Update your User model

Your User model must implement the required contract and trait from the AAuth package:

This ensures that AAuth can interact properly with your authenticated users.

🔐 Default Credentials

After installation, you can log in with the following default user credentials (if you seeded the sample data):

⚠️ Important: Be sure to change or delete this user in production environments.

🎨 Features

Modern User Menu

The plugin provides an enhanced user dropdown menu with avatar, role badges, organization node display, and a theme switcher. Configurable via config/filament-astart.php:

The modern menu fully supports Filament's userMenuItems() API — any items registered via $panel->userMenuItems([...]) will automatically appear in the modern menu.

LogiAudit Integration (Optional)

Built-in read-only pages for LogiAudit log viewing and change history. No composer dependency required — pages only appear when the LogiAudit package is installed.

• System Logs — Filterable log viewer with level badges, tag support, date range filters, and a stats widget (colored cards for errors, warnings, info)
• Change History — Model change tracking with old/new value comparison table

Both pages require AAuth permissions to be granted. Configure in config/astart-auth.php:

Resource visibility can also be toggled in config/filament-astart.php:

Backward compatible with older LogiAudit versions — columns like tag and causer_type are checked at runtime.

User Active/Passive Toggle

Instead of deleting users (which causes orphan records in related tables), users can be activated or deactivated via a toggle button on the edit page. Requires an is_active column on the users table.

Avatar Support

Optional avatar upload and display throughout the plugin. Enable in config:

When enabled, adds avatar upload to user form, displays avatars in user view, user menu, and select components.

UserSelect / UserMultiSelect Components

Reusable form components for selecting users with optional avatar display:

ABAC Rule Management

Visual, repeater-based editor for Attribute-Based Access Control rules on the role edit page. Rules are stored in aauth's role_model_abac_rules table and applied automatically through a wrapper scope that also bypasses the filter for super-admin users.

Quick start:

1. Make a model ABAC-enabled — implement AAuthABACModelInterface and use this plugin's AStartAbacModel trait (recommended; super-admin bypass is built in):

   Prefer AStartAbacModel over aauth's AAuthABACModel. The plugin trait wraps aauth's scope and short-circuits filtering for super-admin (configured via aauth-advanced.super_admin).

2. Register it in config/astart-auth.php:

3. Open any role's edit page → the ABAC Rules tab will appear with a section per registered model and a repeater rule builder.

The editor supports a top-level AND/OR operator, condition blocks, and one level of nested condition groups. Only attributes listed in the whitelist are selectable. Saving an empty rule deletes the row so the global scope is not broken. See docs/ABAC_USAGE.md for the full guide.

User Custom Actions (Dynamic Links)

Config-driven links attached to the User resource — rendered as table row actions and/or on the user detail (view) page. Each link points to a named route in your host application (assignment, matching, profile, etc.), maps record attributes to route parameters, and can be gated behind an AAuth permission. If the route is not registered, the link is silently hidden.

⚠️ The user_actions key is not added to an already-published config on update — add it to your published config/filament-astart.php manually.

Both the table row and the detail page are driven by a single resolver (UserCustomActions::for()), so one definition works in both places. The full field reference is documented in the user_actions block comments inside config/filament-astart.php.

⚙️ Manual Publish Options

You may publish each resource manually if needed:

Config File

Language Files

Seeders

Arflow Config

📘 Changelog

Please see CHANGELOG for more information on what has changed recently.

🤝 Contributing

Contributions are welcome! Please read the CONTRIBUTING guide before submitting pull requests.

🛡️ Security

If you discover a security vulnerability, please review our security policy for how to report it.

🙌 Credits

• AuroraWebSoftware

📄 License

The MIT License (MIT). Please see LICENSE for more information.