africatech25 / tailadmin-dashboard

v1.1.1 2026-09-03 13:20 UTC

Requires

• php: ^8.2
• illuminate/support: ^12.0|^13.0

MIT

Published on Packagist.org on 2026-09-03 13:20 UTC

README

Reusable TailAdmin dashboard package for Laravel applications. It installs a ready-to-use /admin dashboard based on TailAdmin Laravel, with isolated Blade views, components, frontend assets, and public images.

Compatibility

This package supports Laravel 12.x and Laravel 13.x.

Future Laravel major versions should be added after testing because Laravel can introduce breaking changes between major releases.

Installation From GitHub

If this package is not published on Packagist yet, add the GitHub repository to the host application's composer.json:

"repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/Africatech25/tailadmin-dashboard"
    }
]

Then require it:

composer require africatech25/tailadmin-dashboard:^1.0
php artisan tailadmin:install

Local Development

Add the package repository to the host application's composer.json:

"repositories": [
    {
        "type": "path",
        "url": "packages/tailadmin-dashboard",
        "options": {
            "symlink": true
        }
    }
]

Require the package locally:

composer require africatech25/tailadmin-dashboard:"dev-main"
php artisan tailadmin:install

Install the frontend dependencies used by TailAdmin:

npm install alpinejs axios apexcharts flatpickr jsvectormap @fullcalendar/core @fullcalendar/daygrid @fullcalendar/interaction @fullcalendar/list @fullcalendar/timegrid @floating-ui/dom @popperjs/core prismjs swiper
npm install -D @tailwindcss/vite tailwindcss vite laravel-vite-plugin

Add the TailAdmin inputs to vite.config.js:

laravel({
    input: [
        'resources/css/app.css',
        'resources/js/app.js',
        'resources/css/tailadmin/admin.css',
        'resources/js/tailadmin/admin.js',
    ],
    refresh: true,
})

Build the assets:

npm run build

The dashboard is available at /admin by default.

Configuration

Publish and edit the config file:

php artisan vendor:publish --tag=tailadmin-config

Useful options:

'route_prefix' => 'admin',
'middleware' => ['web'],

For a private dashboard, set middleware to something like:

'middleware' => ['web', 'auth'],