PHPackages                             aurorawebsoftware/filament-astart - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. aurorawebsoftware/filament-astart

ActiveLibrary

aurorawebsoftware/filament-astart
=================================

This is my package filament-astart

12.1.0(4mo ago)0162MITPHPPHP ^8.1CI failing

Since May 7Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/AuroraWebSoftware/filament-astart)[ Packagist](https://packagist.org/packages/aurorawebsoftware/filament-astart)[ Docs](https://github.com/aurorawebsoftware/filament-astart)[ GitHub Sponsors](https://github.com/AuroraWebSoftware)[ RSS](/packages/aurorawebsoftware-filament-astart/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (18)Versions (66)Used By (0)

Filament Astart
===============

[](#filament-astart)

[![Latest Version on Packagist](https://camo.githubusercontent.com/94d0521a5ccdddf0d4cd5364f6b34f60b481f473fe9e68569cd594fac10e63f2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6175726f7261776562736f6674776172652f66696c616d656e742d6173746172742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aurorawebsoftware/filament-astart)[![Total Downloads](https://camo.githubusercontent.com/03a70c592cd060c9755516c56e611f861313cd3a9862c39220b46ef8010216b1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6175726f7261776562736f6674776172652f66696c616d656e742d6173746172742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/aurorawebsoftware/filament-astart)

**Filament Astart** is a powerful starter plugin for [FilamentPHP](https://filamentphp.com/), designed to kickstart Laravel admin panels with modular authentication, workflow logic, multilingual support, and prebuilt UI components.

---

📦 Included Dependencies
-----------------------

[](#-included-dependencies)

This package relies on the following AuroraWebSoftware components:

- 🛡️ [**AAuth**](https://github.com/AuroraWebSoftware/AAuth): Advanced authentication and role-permission management.
- 🔄 [**Arflow**](https://github.com/AuroraWebSoftware/Arflow): Workflow engine for dynamic state transitions.

---

🚀 Installation
--------------

[](#-installation)

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

### 📥 Post-Installation Setup

[](#-post-installation-setup)

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

#### 1️⃣ Register the plugin in your Filament panel provider

[](#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:

```
use AuroraWebSoftware\FilamentAstart\FilamentAstartPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            FilamentAstartPlugin::make(),
        ]);
}
```

#### 2️⃣ Update your User model

[](#2️⃣-update-your-user-model)

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.

### 🔐 Default Credentials

[](#-default-credentials)

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

```
Email:    user1@example.com
Password: password

```

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

---

🎨 Features
----------

[](#-features)

### Modern User Menu

[](#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`:

```
'user_menu_style' => env('ASTART_USER_MENU_STYLE', 'classic'),
// 'classic' = Default Filament user menu
// 'modern'  = Enhanced menu with avatar, role badge, org node, theme switcher
```

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)

[](#logiaudit-integration-optional)

Built-in read-only pages for [LogiAudit](https://github.com/AuroraWebSoftware/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`:

```
'LogiAuditLog' => ['view', 'view_any'],
'LogiAuditHistory' => ['view', 'view_any'],
```

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

```
'logiaudit_log' => ['active' => true, 'navigation_group_key' => null],
'logiaudit_history' => ['active' => true, 'navigation_group_key' => null],
```

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

### User Active/Passive Toggle

[](#user-activepassive-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

[](#avatar-support)

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

```
'avatar' => [
    'enabled' => env('ASTART_AVATAR_ENABLED', false),
],
```

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

### UserSelect / UserMultiSelect Components

[](#userselect--usermultiselect-components)

Reusable form components for selecting users with optional avatar display:

```
use AuroraWebSoftware\FilamentAstart\Forms\Components\UserSelect;
use AuroraWebSoftware\FilamentAstart\Forms\Components\UserMultiSelect;

UserSelect::make('user_id'),
UserMultiSelect::make('user_ids'),
```

### ABAC Rule Management

[](#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):

    ```
    use AuroraWebSoftware\AAuth\Interfaces\AAuthABACModelInterface;
    use AuroraWebSoftware\FilamentAstart\Traits\AStartAbacModel;

    class Document extends Model implements AAuthABACModelInterface
    {
        use AStartAbacModel;

        public static function getModelType(): string { return 'document'; }
        public static function getABACRules(): array { return []; }
    }
    ```

    > 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`:

    ```
    'abac' => [
        'enabled' => true,
        'models' => [
            'document' => [
                'class' => \App\Models\Document::class,
                'label' => 'Documents',
                'attributes' => [
                    'status' => ['type' => 'string', 'options' => ['draft', 'active']],
                    'amount' => ['type' => 'numeric'],
                ],
            ],
        ],
    ],
    ```
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`](docs/ABAC_USAGE.md)for the full guide.

---

⚙️ Manual Publish Options
-------------------------

[](#️-manual-publish-options)

You may publish each resource manually if needed:

### Config File

[](#config-file)

```
php artisan vendor:publish --tag="filament-astart-config"

```

### Language Files

[](#language-files)

```
php artisan vendor:publish --tag="filament-astart-lang"

```

### Seeders

[](#seeders)

```
php artisan vendor:publish --tag=filament-astart-seeders
php artisan db:seed --class=SampleFilamentDataSeeder

```

### Arflow Config

[](#arflow-config)

```
php artisan vendor:publish --tag=arflow-config

```

---

📘 Changelog
-----------

[](#-changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

---

🤝 Contributing
--------------

[](#-contributing)

Contributions are welcome! Please read the [CONTRIBUTING](.github/CONTRIBUTING.md) guide before submitting pull requests.

---

🛡️ Security
-----------

[](#️-security)

If you discover a security vulnerability, please review [our security policy](../../security/policy) for how to report it.

---

🙌 Credits
---------

[](#-credits)

- [AuroraWebSoftware](https://github.com/AuroraWebSoftware)

---

📄 License
---------

[](#-license)

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

###  Health Score

44

—

FairBetter than 91% of packages

Maintenance86

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 68.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~9 days

Recently: every ~2 days

Total

42

Last Release

32d ago

Major Versions

1.0.1 → 12.0.02025-05-09

4.0.0 → 12.0.232025-10-23

4.0.1 → 5.0.02026-02-04

5.0.2 → 12.1.02026-02-17

5.x-dev → 6.0.02026-05-25

PHP version history (3 changes)1.0.0PHP ^8.1

4.0.0PHP ^8.2

5.x-devPHP ^8.3

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/794216?v=4)[EA](/maintainers/emreakay)[@emreakay](https://github.com/emreakay)

---

Top Contributors

[![emreakay](https://avatars.githubusercontent.com/u/794216?v=4)](https://github.com/emreakay "emreakay (47 commits)")[![mfarukdev](https://avatars.githubusercontent.com/u/83613682?v=4)](https://github.com/mfarukdev "mfarukdev (22 commits)")

---

Tags

laravelAuroraWebSoftwarefilament-astart

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/aurorawebsoftware-filament-astart/health.svg)

```
[![Health](https://phpackages.com/badges/aurorawebsoftware-filament-astart/health.svg)](https://phpackages.com/packages/aurorawebsoftware-filament-astart)
```

###  Alternatives

[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3913.7k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

122157.7k1](/packages/stephenjude-filament-feature-flags)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17758.9k2](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger

About

104150.5k2](/packages/stephenjude-filament-debugger)[stephenjude/filament-two-factor-authentication

Filament Two Factor Authentication: Google 2FA + Passkey Authentication

84192.9k8](/packages/stephenjude-filament-two-factor-authentication)[a2insights/filament-saas

Filament Saas for A2Insights

171.5k](/packages/a2insights-filament-saas)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)