PHPackages                             dfsmania/laradminlte - 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. dfsmania/laradminlte

ActiveLibrary[Admin Panels](/categories/admin)

dfsmania/laradminlte
====================

AdminLTE v4 for Laravel

v1.0.0-beta1(2mo ago)25695↓50%2MITPHPCI passing

Since Mar 1Pushed 1mo ago11 watchersCompare

[ Source](https://github.com/dfsmania/LaradminLTE)[ Packagist](https://packagist.org/packages/dfsmania/laradminlte)[ Fund](https://www.paypal.com/donate/?hosted_button_id=TWUHZDRW7EKWL)[ GitHub Sponsors](https://github.com/dfsmania)[ RSS](/packages/dfsmania-laradminlte/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

[![Total Downloads](https://camo.githubusercontent.com/3e622b3ef71c669aa95933cfd0117b129957480905b6edc4b11952aa02ec69ff/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6466736d616e69612f4c617261646d696e4c54453f6c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465266c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/dfsmania/LaradminLTE)[![Pint Code Style](https://github.com/dfsmania/LaradminLTE/actions/workflows/run-pint.yml/badge.svg)](https://github.com/dfsmania/LaradminLTE/actions/workflows/run-pint.yml)

LaradminLTE: AdminLTE v4 for Laravel
====================================

[](#laradminlte-adminlte-v4-for-laravel)

**LaradminLTE** is a Laravel package that seamlessly integrates the powerful [AdminLTE v4](https://adminlte-v4.netlify.app) dashboard template into [Laravel](https://laravel.com/) (v10 or higher). Designed for modern web applications, this package provides a fast and flexible way to build responsive, maintainable, and feature-rich admin panels by using a Laravel [Blade component](https://laravel.com/docs/blade#components) to quick access the layout and configuration files to customize it.

Caution

**Active Development**: **LaradminLTE** is currently under active development. Features, configuration options, and behavior are subject to change until the first stable release.

Requirements
------------

[](#requirements)

- **Laravel**: 10 or higher
- **PHP**: 8.1 or higher

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

[](#installation)

Follow these steps to install **LaradminLTE** in your Laravel application:

### 1. Install the Package

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

Use [Composer](https://getcomposer.org/) to add the package to your Laravel project:

```
composer require dfsmania/laradminlte:^1.0@beta
```

Alternatively, if you want to install the latest development version, you can run:

```
composer require dfsmania/laradminlte:dev-main --prefer-stable
```

### 2. Publish Required Package Resources

[](#2-publish-required-package-resources)

Run the following commands to publish the basic package's assets and configuration files:

```
php artisan vendor:publish --tag="ladmin-assets" --tag="ladmin-config"
```

This command will publish the following elements to your application:

- **Assets**: The set of **AdminLTE v4** distribution files (`CSS`, `JS`) and some images in the `public/vendor/ladmin` folder of your Laravel application.
- **Config**: The package configuration files in the `config/ladmin` folder of your Laravel application.

### 3. Other Publishable Resources (Optional)

[](#3-other-publishable-resources-optional)

#### Translations

[](#translations)

Additionally, you can also publish the translation files if you want to customize them or add new languages:

```
php artisan vendor:publish --tag="ladmin-translations"
```

Translation files will be published to the `resources/lang/vendor/ladmin` folder of your Laravel application.

#### Migrations

[](#migrations)

If you plan to use the built-in authentication scaffolding with the **profile images feature**, you should publish the package's migrations:

```
php artisan vendor:publish --tag="ladmin-migrations"
```

Migrations will be published to the `database/migrations` folder of your Laravel application. These migrations will create the necessary columns on the `users` table to support user profile images. You can run migrations by executing:

```
php artisan migrate
```

Usage
-----

[](#usage)

Follow these steps to use, configure and test **LaradminLTE** in your Laravel application:

### 1. Create a Dedicated Route and View

[](#1-create-a-dedicated-route-and-view)

Set up a route in your `routes/web.php` file, for example:

```
Route::get('ladmin_welcome', function () {
    return view('laradminlte-welcome');
});
```

Next, create a Blade view to test the package's functionality. The package provides a main blade component that should be used to render the full admin layout. As example, save the following content in `resources/views/laradminlte-welcome.blade.php`:

```

    {{-- Setup the content header --}}

                    Welcome to LaradminLTE!

    {{-- Setup the content body --}}

            Now, start building your next administration panel with ease and flexibility.

    {{-- Push inline scripts if needed --}}
    @push('js')

            console.log('LaradminLTE is successfully loaded!');

    @endpush

```

- The `title` attribute of the main component sets the page title, which is automatically appended to your application's name and shown in the browser's title bar.
- The `contentHeader` slot is used to define the header section of the content area.
- The content body is placed directly within the main component tags (as the default `slot` of the component).
- The `@push('js')` directive allows you to add custom JavaScript code that will be included in the layout.
- The `@push('css')` directive can also be used to add custom CSS styles if needed.

### 2. Enable the Authentication Scaffolding (Optional)

[](#2-enable-the-authentication-scaffolding-optional)

Important

To use the authentication scaffolding, you need to have the default Laravel's migrations for users already set up in your database. If this is not your case, then you can can install Laravel's default migrations by running: `php artisan migrate`.

Important

The authentication scaffolding relies on **Laravel Fortify**, so you need to install its resources in your application. You can do this by running: `php artisan fortify:install`. This step is required for having **Fortify Actions** available in your application, which are used by the package's authentication scaffolding. In the future we will work on a way to avoid this requirement, if possible.

If you want to use the built-in authentication scaffolding, make sure to have it enabled in the `config/ladmin/auth.php` file, and setup the `home_path`. The `home_path` is the place where users will be redirected after login. Then protect your routes using the `auth` middleware:

```
// config/ladmin/auth.php:
'enabled' => true,
'home_path' => '/ladmin_welcome',
```

```
// routes/web.php:
Route::middleware(['auth'])->group(function () {
    Route::get('ladmin_welcome', function () {
        return view('laradminlte-welcome');
    });

    // Add other protected routes here...
});
```

After this, all the routes within this group will require authentication to be accessed.

### 3. Test your Route/View

[](#3-test-your-routeview)

To test the admin layout, open your browser and navigate to:

```
http://your-app.test/ladmin_welcome
```

Replace `your-app.test` with your local development URL. If authentication is enabled, a login screen will appear. Then, you should see the default admin layout rendered using the package’s out-of-the-box configuration:

[!["LaradminLTE Layout Example"](docs/public/images/layout-example.png "LaradminLTE Layout Example")](docs/public/images/layout-example.png)

Finally, to define your admin panel menu entries, you can edit the `config/ladmin/menu.php` file. This file allows you to customize the sidebar and navbar menu structure and items according to your application's needs. Remember that each new menu entry that renders a page should provide a blade view that extends the main layout component (``) to ensure the admin layout is applied correctly.

### 4. Customize Configuration

[](#4-customize-configuration)

Explore and modify the package's configuration files to suit your needs:

- `config/ladmin/main.php`: General settings for the admin panel.
- `config/ladmin/menu.php`: Define the menu structure.
- `config/ladmin/plugins.php`: Manage plugins and extensions.
- `config/ladmin/auth.php`: Configure authentication scaffolding.

For detailed usage instructions, advanced configuration options, and customization guides, refer to the [Official LaradminLTE Documentation](https://dfsmania.github.io/LaradminLTE).

Contributing
------------

[](#contributing)

Thank you for your interest in contributing to *LaradminLTE*! We welcome and appreciate all contributions that help improve the project. Please take a moment to review our guidelines on [the Contribute page](https://github.com/dfsmania/LaradminLTE/contribute) before getting started.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance87

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity20

Early-stage or recently created project

 Bus Factor1

Top contributor holds 98.8% 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

Unknown

Total

1

Last Release

78d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1dc9a517dee02b72589bef7334582d1def20e098e3497dfbef4ca31e479b105f?d=identicon)[dsmania](/maintainers/dsmania)

---

Top Contributors

[![dfsmania](https://avatars.githubusercontent.com/u/63609705?v=4)](https://github.com/dfsmania "dfsmania (337 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (4 commits)")

---

Tags

admin-dashboardadminlte-4laravellaraveladmin-paneladminlte 4

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/dfsmania-laradminlte/health.svg)

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

PHPackages © 2026

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