PHPackages                             vormiaphp/ui-livewireflux-admin - 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. [Admin Panels](/categories/admin)
4. /
5. vormiaphp/ui-livewireflux-admin

ActiveLibrary[Admin Panels](/categories/admin)

vormiaphp/ui-livewireflux-admin
===============================

Vormia UI Livewire Flux Admin - Admin panel components and routes for Laravel applications using Livewire Volt and Flux

v4.1.1(1mo ago)0158MITBladePHP ^8.2

Since Dec 2Pushed 1mo agoCompare

[ Source](https://github.com/vormiaphp/ui-livewireflux-admin)[ Packagist](https://packagist.org/packages/vormiaphp/ui-livewireflux-admin)[ RSS](/packages/vormiaphp-ui-livewireflux-admin/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (14)Versions (28)Used By (0)

Vormia UI Livewire Flux Admin
=============================

[](#vormia-ui-livewire-flux-admin)

[![Packagist](https://camo.githubusercontent.com/a0eeb0cfc6c9295a91f6f4d4c2c4528368a6f28e51d479633c347b816f3a1b97/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f766f726d69617068702f75692d6c69766577697265666c75782d61646d696e2e737667)](https://packagist.org/packages/vormiaphp/ui-livewireflux-admin)[![GitHub](https://camo.githubusercontent.com/53adeadfd3c0789f2be354aee38d616a8102c19b48582606b3e7ae39bee04de7/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f766f726d69617068702f75692d6c69766577697265666c75782d61646d696e2e737667)](https://github.com/vormiaphp/ui-livewireflux-admin)

A Laravel package that provides a complete admin panel solution with pre-built components, routes, and views for managing categories, inheritance, locations, availability, and admin users. Built with Livewire 4 and Flux for a modern, reactive admin interface.

What is This Package?
---------------------

[](#what-is-this-package)

**Vormia UI Livewire Flux Admin** is a comprehensive admin panel package for Laravel applications that includes:

- **AdminPanel View Component** - A reusable Blade component for consistent admin panel layouts
- **Pre-configured Admin Routes** - Complete CRUD routes for all admin sections
- **Livewire Components** - Single-file Livewire components for categories, inheritance, locations, availability, and admin management
- **Automatic Sidebar Integration** - Sidebar menu injection (requires livewire/flux)
- **Role Management** - See `docs/GUIDE.md#roles-assign-on-registration` for assigning roles on registration

This package is designed to work seamlessly with the Vormia ecosystem and follows Laravel best practices.

Laravel Compatibility
---------------------

[](#laravel-compatibility)

This package supports:

- **Laravel** ^12.0 or ^13.0
- **PHP** ^8.2

This package runs on **Vormia 5.4+** with **Livewire 4.1+** and **Flux 2.13.1+**. Required dependencies (installed automatically when you require this package):

- **vormiaphp/vormia** ^5.4
- **livewire/livewire** ^4.1
- **livewire/flux** ^2.13.1
- **laravel/fortify** ^1.34

Flux 1.x, Fortify 2.x, and older minors outside the ranges above are not in the supported matrix.

**Developer guide:** [`docs/GUIDE.md`](docs/GUIDE.md) — UI flow and style, AI promptbook, Fortify (`PasswordValidationRules`, `EnsureUserIsActive`), assigning roles on registration, and quick-reference layout patterns (YAML frontmatter at the top is for optional use as a Cursor project rule).

This package targets **Livewire 4** where Volt is bundled with Livewire. The admin page stubs are Livewire anonymous components (`new class extends Component`) and rely on your app’s **default Livewire layout**.

Installation Process
--------------------

[](#installation-process)

### Step 1: Install the Package

[](#step-1-install-the-package)

```
composer require vormiaphp/ui-livewireflux-admin
```

### Step 2: Run the Installation Command

[](#step-2-run-the-installation-command)

```
php artisan ui-livewireflux-admin:install
```

This command will:

1. ✅ Check for required dependencies
2. ✅ Copy package stubs into your application (views, `AdminPanel`, etc.)
3. ✅ Publish Laravel Fortify **support stubs only** (`--tag=fortify-support`: `PasswordValidationRules` and related files under `app/Actions/Fortify/` when `PasswordValidationRules` is not present yet). Fortify **database migrations are not** published by install (see **Fortify database (optional)** below and `docs/GUIDE.md#fortify-passwords-publish-and-active-users` for re-publish with `--force` on the support tag only)
4. ✅ Inject routes into `routes/web.php`
5. ✅ Inject sidebar menu
6. ✅ Copy `EnsureUserIsActive.php` — register it in Fortify per `docs/GUIDE.md#fortify-passwords-publish-and-active-users`
7. ✅ Clear application caches

### Step 3: Verify Installation

[](#step-3-verify-installation)

After installation, verify that:

- `app/View/Components/AdminPanel.php` and related views are present
- `app/Actions/Fortify/` contains the Fortify support stubs (including `PasswordValidationRules` when the publish step ran). New migration files under `database/migrations/` from Fortify appear only if **you** run `vendor:publish --tag=fortify-migrations` (install does not add them).
- Routes were added to `routes/web.php`
- Sidebar menu was added
- Caches were cleared

### Fortify database (optional)

[](#fortify-database-optional)

This package’s install command does **not** run `vendor:publish` for Fortify’s `fortify-migrations` tag. If you use Fortify two-factor authentication or passkeys **and** your database does not already have the required columns or `passkeys` table, publish migrations yourself, then migrate:

```
php artisan vendor:publish --tag=fortify-migrations
php artisan migrate
```

Many apps already have `two_factor_*` columns on `users` (for example from Jetstream, Breeze, or an earlier manual publish). If `php artisan migrate` fails with **duplicate column** errors on `two_factor_secret`, do not run the duplicate migration: remove the extra migration file if it was never applied, or adjust your schema/docs per [`docs/GUIDE.md#fortify-passwords-publish-and-active-users`](docs/GUIDE.md#fortify-passwords-publish-and-active-users).

Manual Configuration (If Needed)
--------------------------------

[](#manual-configuration-if-needed)

### Routes Not Injected Automatically

[](#routes-not-injected-automatically)

If the routes were not automatically injected into `routes/web.php`, manually add them:

1. Open `routes/web.php`
2. Find the `Route::middleware(['auth'])->group(function () { ... });` block
3. Add the routes from `vendor/vormiaphp/ui-livewireflux-admin/src/stubs/reference/routes-to-add.php` inside this block

**Example:**

```