PHPackages                             jeffersongoncalves/filafluxkitv5 - 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. jeffersongoncalves/filafluxkitv5

ActiveProject[Admin Panels](/categories/admin)

jeffersongoncalves/filafluxkitv5
================================

FilaFluxKit — Laravel 13 + Filament v5 starter kit with multi-panel structure (Admin, App, Guest), multi-guard auth and Livewire Flux UI components via filament-flux plugin.

5.6.6(1w ago)60MITPHPPHP ^8.3CI passing

Since May 9Pushed 1w ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/filafluxkitv5)[ Packagist](https://packagist.org/packages/jeffersongoncalves/filafluxkitv5)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-filafluxkitv5/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (4)Dependencies (20)Versions (8)Used By (0)

[![FilaFluxKit](https://raw.githubusercontent.com/jeffersongoncalves/filafluxkitv5/main/art/jeffersongoncalves-filafluxkitv5.png)](https://raw.githubusercontent.com/jeffersongoncalves/filafluxkitv5/main/art/jeffersongoncalves-filafluxkitv5.png)

FilaFluxKit Start Kit Filament 5.x and Laravel 13.x
===================================================

[](#filafluxkit-start-kit-filament-5x-and-laravel-13x)

About FilaFluxKit
-----------------

[](#about-filafluxkit)

FilaFluxKit is a robust starter kit built on Laravel 13.x and Filament 5.x, designed to accelerate the development of modern web applications with a ready-to-use multi-panel structure and Livewire Flux UI components integrated via the [`jeffersongoncalves/filament-flux`](https://github.com/jeffersongoncalves/filament-flux) plugin.

Features
--------

[](#features)

- **Laravel 13.x** - The latest version of the most elegant PHP framework
- **Filament 5.x** - Powerful and flexible admin framework
- **Livewire 4.x + Flux 2.x** - Modern reactive UI primitives wired into every panel
- **filament-flux plugin** - Native Filament Form Fields, Table Columns, Infolist Entries and Actions backed by Livewire Flux
- **Tailwind CSS v4** - Configured per-panel theme with Flux palette safelist
- **Multi-Panel Structure** - Includes three pre-configured panels:
    - Admin Panel (`/admin`) - For system administrators
    - App Panel (`/app`) - For authenticated application users
    - Guest Panel (frontend interface) - For visitors
- **Multi-Guard Authentication** - Separate `Admin` and `User` models, tables, guards and login pages
- **Environment Configuration** - Centralized configuration through the `config/filafluxkit.php` file

System Requirements
-------------------

[](#system-requirements)

- PHP 8.3 or higher
- Composer
- Node.js and PNPM

Installation
------------

[](#installation)

Clone the repository

```
laravel new my-app --using=jeffersongoncalves/filafluxkitv5 --database=mysql
```

### Using FilaFluxKit CLI

[](#using-filafluxkit-cli)

Or use [FilaFluxKit CLI](https://github.com/jeffersongoncalves/filafluxkit-cli) for a simplified setup:

```
filafluxkit new my-app --kit=jeffersongoncalves/filafluxkitv5
```

> Install FilaFluxKit CLI: `composer global require jeffersongoncalves/filafluxkit-cli`

### Easy Installation

[](#easy-installation)

FilaFluxKit can be easily installed using the following command:

```
php install.php
```

This command automates the installation process by:

- Installing Composer dependencies
- Setting up the environment file
- Generating application key
- Setting up the database
- Running migrations
- Installing Node.js dependencies
- Building assets
- Configuring Herd (if used)

### Manual Installation

[](#manual-installation)

Install JavaScript dependencies

```
pnpm install
```

Install Composer dependencies

```
composer install
```

Set up environment

```
cp .env.example .env
php artisan key:generate
```

Configure your database in the .env file

Run migrations

```
php artisan migrate
```

Run the server

```
php artisan serve
```

Installation with Docker
------------------------

[](#installation-with-docker)

Clone the repository

```
laravel new my-app --using=jeffersongoncalves/filafluxkitv5 --database=mysql
```

Move into the project directory

```
cd my-app
```

Install Composer dependencies

```
composer install
```

Set up environment

```
cp .env.example .env
```

Configuring custom ports may be necessary if you have other services running on the same ports.

```
# Application Port (ex: 8080)
APP_PORT=8080

# MySQL Port (ex: 3306)
FORWARD_DB_PORT=3306

# Redis Port (ex: 6379)
FORWARD_REDIS_PORT=6379

# Mailpit Port (ex: 1025)
FORWARD_MAILPIT_PORT=1025
```

Start the Sail containers

```
./vendor/bin/sail up -d
```

You won’t need to run `php artisan serve`, as Laravel Sail automatically handles the development server within the container.

Attach to the application container

```
./vendor/bin/sail shell
```

Generate the application key

```
php artisan key:generate
```

Install JavaScript dependencies

```
pnpm install
```

Authentication Structure
------------------------

[](#authentication-structure)

FilaFluxKit comes pre-configured with a custom authentication system that supports different types of users:

- `Admin` - For administrative panel access
- `User` - For application panel access

Development
-----------

[](#development)

```
# Run the development server with logs, queues and asset compilation
composer dev

# Or run each component separately
php artisan serve
php artisan queue:listen --tries=1
pnpm run dev
```

Customization
-------------

[](#customization)

### Panel Configuration

[](#panel-configuration)

Panels can be customized through their respective providers:

- `app/Providers/Filament/AdminPanelProvider.php`
- `app/Providers/Filament/AppPanelProvider.php`
- `app/Providers/Filament/GuestPanelProvider.php`

Alternatively, these settings are also consolidated in the `config/filafluxkit.php` file for easier management.

### Themes and Colors

[](#themes-and-colors)

Each panel can have its own color scheme, which can be easily modified in the corresponding Provider files or in the `filafluxkit.php` configuration file.

### Configuration File

[](#configuration-file)

The `config/filafluxkit.php` file centralizes the configuration of the starter kit, including:

- Panel routes
- Middleware for each panel
- Branding options (logo, colors)
- Authentication guards

Livewire Flux UI — jeffersongoncalves/filament-flux
---------------------------------------------------

[](#livewire-flux-ui--jeffersongoncalvesfilament-flux)

This kit ships with [`filament-flux`](https://github.com/jeffersongoncalves/filament-flux) (`^1.11`) preinstalled and registered on every panel. Resources keep calling native Filament classes — the plugin swaps them for Flux subclasses or rewrites the rendered Blade markup at three layers:

```
FilamentFluxPlugin::make()
    ->useEverywhere()       // Form Fields (container bindings)
    ->useFluxNavigation()   // Sidebar + topbar items
    ->useFluxComponents();  // Atomic  Blade components
```

Plugin registration lives in:

- `app/Providers/Filament/AdminPanelProvider.php`
- `app/Providers/Filament/AppPanelProvider.php`
- `app/Providers/Filament/GuestPanelProvider.php`

Each panel theme imports Flux + filament-flux CSS:

```
@import '../../../../vendor/filament/filament/resources/css/theme.css';
@import '../../../../vendor/livewire/flux/dist/flux.css';
@import '../../../../vendor/jeffersongoncalves/filament-flux/dist/filament-flux.css';
```

To wire it on a new panel run:

```
php artisan filament-flux:install --panel={panel-id}
pnpm build
```

### `useEverywhere()` — Form Field auto-replace

[](#useeverywhere--form-field-auto-replace)

Container bindings rewrite every native Form Field call to its Flux subclass. No code changes in your Resources.

SlugFilament nativeFlux replacement`input``TextInput``FluxInput``textarea``Textarea``FluxTextarea``select``Select``FluxSelect``checkbox``Checkbox``FluxCheckbox``checkboxList``CheckboxList``FluxCheckboxGroup``radio``Radio``FluxRadio``toggle``Toggle``FluxSwitch``otp``OneTimeCodeInput``FluxOtpInput`Granular opt-out:

```
FilamentFluxPlugin::make()->useEverywhere([
    'select' => false,    // keep native
    'otp' => false,
]);
```

### `useFluxNavigation()` — Sidebar + topbar

[](#usefluxnavigation--sidebar--topbar)

Replaces Filament's sidebar/topbar Blade items with `` / `` markup while keeping Filament's data layer (active state, badges, child items, registered Resources/Pages) intact.

```
FilamentFluxPlugin::make()->useFluxNavigation([
    'sidebar' => true,
    'topbar' => true,
    'shell' => false,         // outer / shell — invasive, opt-in
    'themeSwitcher' => false, // single  theme switcher — opt-in
]);
```

### `useFluxComponents()` — Atomic Blade components

[](#usefluxcomponents--atomic-blade-components)

Replaces `` with ``. Each slug is opt-in.

SlugFilament viewFlux replacement`badge``filament::components.badge````avatar``filament::components.avatar````icon``filament::components.icon````iconButton``filament::components.icon-button````link``filament::components.link````breadcrumbs``filament::components.breadcrumbs````callout``filament::components.callout````card``filament::components.card````fieldset``filament::components.fieldset````section``filament::components.section``` w/ heading + collapsible/persist`dropdown``filament::components.dropdown``` + ```dropdownHeader``filament::components.dropdown.header````modalHeading``filament::components.modal.heading````modalDescription``filament::components.modal.description````schemaText``filament-schemas::components.text````statsCard``filament-widgets::stats-overview-widget.stat``` + heading/subheading/text`notifications``filament-notifications::notifications``` envelope`pagination``filament::components.pagination.index```Granular opt-out:

```
FilamentFluxPlugin::make()->useFluxComponents([
    'badge' => true,
    'avatar' => true,
    'icon' => true,
    // omit/false → keep Filament's view
]);
```

Mixed icon sets (Heroicons + Font Awesome / Tabler / Lucide / Phosphor / Material / etc.) are detected by the bundled `HeroiconNormalizer` and routed back through Blade Icons when needed — only Heroicons go through ``.

### Plugin options

[](#plugin-options)

```
FilamentFluxPlugin::make()
    ->scopeClass('filament-flux-scope')   // CSS scope wrapper; pass null to use Flux's native zinc palette
    ->injectAppearance(true)              // @fluxAppearance in  + theme bridge
    ->injectScripts(true);                // @fluxScripts before
```

Reference:

User Profile — joaopaulolndev/filament-edit-profile
---------------------------------------------------

[](#user-profile--joaopaulolndevfilament-edit-profile)

This project already comes with the Filament Edit Profile plugin integrated for the Admin and App panels. It adds a complete profile editing page with avatar, language, theme color, security (tokens, MFA), browser sessions, and email/password change.

- Routes (defaults in this project):
    - Admin: /admin/my-profile
    - App: /app/my-profile
- Navigation: by default, the page does not appear in the menu (shouldRegisterNavigation(false)). If you want to show it in the sidebar menu, change it to true in the panel provider.

Where to configure

- Panel providers

    - Admin: app/Providers/Filament/AdminPanelProvider.php
    - App: app/Providers/Filament/AppPanelProvider.php In these files you can adjust:
    - ->slug('my-profile') to change the URL (e.g., 'profile')
    - ->setTitle('My Profile') and ->setNavigationLabel('My Profile')
    - ->setNavigationGroup('Group Profile'), ->setIcon('heroicon-o-user'), ->setSort(10)
    - ->shouldRegisterNavigation(true|false) to show/hide it in the menu
    - Shown forms: ->shouldShowEmailForm(), ->shouldShowLocaleForm(\[...\]), ->shouldShowThemeColorForm(), ->shouldShowSanctumTokens(), ->shouldShowMultiFactorAuthentication(), ->shouldShowBrowserSessionsForm(), ->shouldShowAvatarForm()
- General settings: config/filament-edit-profile.php

    - locales: language options available on the profile page
    - locale\_column: column used in your model for language/locale (default: locale)
    - theme\_color\_column: column for theme color (default: theme\_color)
    - avatar\_column: avatar column (default: avatar\_url)
    - disk: storage disk used for the avatar (default: public)
    - visibility: file visibility (default: public)

Migrations and models

- The required columns are already included in this kit’s default migrations (users and admins): avatar\_url, locale and theme\_color, using the names defined in config/filament-edit-profile.php.
- The App\\Models\\User and App\\Models\\Admin models already read the avatar using the plugin configuration (getFilamentAvatarUrl).

Avatar storage

- Make sure the filesystem disk is configured and that the storage link exists: php artisan storage:link
- Adjust the disk and visibility in the config file according to your infrastructure.

Quick access

- Via direct URL: /admin/my-profile or /app/my-profile
- To make it visible in the sidebar navigation, set shouldRegisterNavigation(true) in the respective Provider.

Reference

- Plugin repository:

Resources
---------

[](#resources)

FilaFluxKit includes support for:

- User and admin management
- Multi-guard authentication system
- Tailwind CSS integration
- Database queue configuration
- Customizable panel routing and branding

License
-------

[](#license)

This project is licensed under the [MIT License](LICENSE).

Credits
-------

[](#credits)

Developed by [Jefferson Gonçalves](https://github.com/jeffersongoncalves).

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance98

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 61.9% 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 ~6 days

Total

4

Last Release

10d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (459 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (168 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (101 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (7 commits)")[![achyutkneupane](https://avatars.githubusercontent.com/u/30431426?v=4)](https://github.com/achyutkneupane "achyutkneupane (2 commits)")[![mmonari](https://avatars.githubusercontent.com/u/131320557?v=4)](https://github.com/mmonari "mmonari (2 commits)")[![zdearo](https://avatars.githubusercontent.com/u/110416695?v=4)](https://github.com/zdearo "zdearo (1 commits)")[![andrefelipe18](https://avatars.githubusercontent.com/u/96439642?v=4)](https://github.com/andrefelipe18 "andrefelipe18 (1 commits)")[![josenetoz](https://avatars.githubusercontent.com/u/74790000?v=4)](https://github.com/josenetoz "josenetoz (1 commits)")

---

Tags

filamentfilament-fluxfilament-starter-kitfilament-v5flux-uilaravellaravel-13laravel-starter-kitlivewirelivewire-4livewire-fluxmulti-guardmulti-panelstarter-kittailwind-v4tailwindcsslaravellivewirefilamentstarter-kitlaravel-starter-kitfilament-starter-kittailwindcssfilament-v5livewire 4multi-panellaravel-13tailwind-v4flux-uimulti-guardlivewire-fluxfilament-flux

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jeffersongoncalves-filafluxkitv5/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-filafluxkitv5/health.svg)](https://phpackages.com/packages/jeffersongoncalves-filafluxkitv5)
```

###  Alternatives

[raugadh/fila-starter

Laravel Filament Starter.

625.1k](/packages/raugadh-fila-starter)[ercogx/laravel-filament-starter-kit

This is a Filament v5 Starter Kit for Laravel 13, designed to accelerate the development of Filament-powered applications.

441.7k](/packages/ercogx-laravel-filament-starter-kit)

PHPackages © 2026

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