yezzmedia/laravel-dashboard

Dashboard layer for the Yezz Media Laravel website platform. Provides a unified shell with navbar, sidebar, and bottom-bar above the User Center.

0.2.4 2026-07-17 07:56 UTC

Requires

• php: ^8.5
• filament/filament: ^5.0
• illuminate/contracts: ^13.0
• illuminate/support: ^13.0
• spatie/laravel-package-tools: ^1.93
• yezzmedia/laravel-foundation: ^0.2

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.29
• livewire/livewire: ^4.1
• mockery/mockery: ^1.6
• orchestra/testbench: ^11.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-laravel: ^4.0

Suggests

• yezzmedia/laravel-account: Account integration — registers dashboard navigation items for key user-facing pages.

MIT

• Yezz Media

Published on Packagist.org on 2026-07-17 07:56 UTC

README

Laravel Dashboard

yezzmedia/laravel-dashboard is the shared navigation shell for Yezz Media user-facing packages.

It provides a consistent Blade layout with navbar, collapsible sidebar, bottom-bar zone, and dynamic hub page — extended by laravel-account, laravel-user-projects, laravel-user-consent, and laravel-user-support through stable navigation and extension registries.

Version

Current release: 0.2.0

Requirements

• PHP ^8.5
• Laravel ^13.0 components
• filament/filament ^5.0
• spatie/laravel-package-tools ^1.93
• yezzmedia/laravel-foundation ^0.2

Optional:

• yezzmedia/laravel-account — registers user-facing navigation items for the account surface

Installation

composer require yezzmedia/laravel-dashboard

The service provider is auto-discovered.

What The Package Provides

Navigation Shell

DashboardServiceProvider registers the shared layouts/dashboard.blade.php layout with:

• Responsive navbar with user dropdown and theme toggle
• Collapsible sidebar with active-state left-border indicators
• Bottom-bar zone via BottomBarLinkRegistry
• Mobile sidebar with gradient brand header
• Context-aware sidebar footer

Hub Page

The dashboard hub page (/dashboard) displays a widget-based overview with:

• Page header with icon and dynamic user greeting
• Left sidebar: account card, quick links grouped by navigation categories
• Main area: registered hub widgets from consumer packages
• Empty states when no widgets are registered

Extension Registries

Package integrates with foundation through:

• DashboardExtensionRegistry — consumer packages register hub widgets
• DashNavigationRegistry — consumer packages register sidebar navigation items
• UserMenuRegistry — consumer packages extend the user dropdown menu
• BottomBarLinkRegistry — consumer packages add bottom-bar links

Install Steps

Two foundation-aligned install steps ensure the host is correctly configured:

• EnsureFilamentPanelHasDefaultInstallStep — adds ->default() to the generated AdminPanelProvider so filament()->getDefaultPanel() resolves
• EnsureAppCssHasDarkVariantInstallStep — ensures @variant dark and package source paths exist in the host resources/css/app.css

These run automatically during php artisan website:install.

Routes

The package registers:

• GET /dashboard — hub page
• POST /logout — session logout

Development

composer test
composer analyse
composer format

License

MIT