PHPackages saeedhosan/laravel-menus - 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. [Utility & Helpers](/categories/utility) 4. / 5. saeedhosan/laravel-menus ActiveLibrary[Utility & Helpers](/categories/utility) saeedhosan/laravel-menus ======================== The package is for laravel menu builder v0.0.0(3mo ago)0458MITPHPPHP ^8.2.0CI passing Since Mar 27Pushed 2mo agoCompare [ Source](https://github.com/saeedhosan/laravel-menus)[ Packagist](https://packagist.org/packages/saeedhosan/laravel-menus)[ RSS](/packages/saeedhosan-laravel-menus/feed)WikiDiscussions main Synced today READMEChangelog (1)Dependencies (21)Versions (4)Used By (0) Laravel Menus ============= [](#laravel-menus) Simple, flexible menu builder for Laravel. Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11, 12, or 13 Installation ------------ [](#installation) ``` composer require saeedhosan/laravel-menus ``` The service provider is auto-discovered. To publish the config and views: ``` php artisan vendor:publish --tag=laravel-menus-config php artisan vendor:publish --tag=laravel-menus-views ``` Creating a Menu --------------- [](#creating-a-menu) Create a class that extends `MenuBuilder` and define your items: ``` use SaeedHosan\Menus\MenuBuilder; class AdminMenu extends MenuBuilder { public function items(): array { return [ [ 'name' => 'Dashboard', 'slug' => 'admin.dashboard', 'link' => route('admin.dashboard'), 'icon' => '', 'active' => request()->routeIs('admin.dashboard'), ], [ 'name' => 'Users', 'slug' => 'admin.users', 'link' => route('admin.users.index'), 'active' => request()->routeIs('admin.users.*'), 'access' => 'manage-users', ], ]; } } ``` ### Item Properties [](#item-properties) KeyTypeDescription`name``string`Display label`slug``string`Unique identifier used for positioning`link``string`URL (optional)`icon``string`Icon HTML (defaults to a bullet dot)`active``bool`Marks item as active`access``string|array`Permission(s) checked via access callback`badge``string|array`Badge text, or `['text', 'css-class']``separator``bool`Renders as a section heading`submenu``array`Nested menu itemsRegistering Menus ----------------- [](#registering-menus) Register your menus in a service provider: ``` use SaeedHosan\Menus\Menu; // Root menu Menu::create(AdminMenu::class); // Child menu — items appended to AdminMenu Menu::create(ReportsMenu::class, AdminMenu::class); ``` Positioning Child Items ----------------------- [](#positioning-child-items) Control where child items are placed using the fluent filter API: ``` // Insert after a specific slug Menu::create(ReportsMenu::class, AdminMenu::class)->after('admin.users'); // Insert before a specific slug Menu::create(ReportsMenu::class, AdminMenu::class)->before('admin.users'); // Insert into a specific item's submenu Menu::create(ReportsMenu::class, AdminMenu::class)->whereSlug('admin.settings'); // Force as submenu of matched item Menu::create(ReportsMenu::class, AdminMenu::class)->asSubmenu()->whereSlug('admin.settings'); // Filter which items get merged Menu::create(ReportsMenu::class, AdminMenu::class)->filter(fn ($item) => $item['slug'] !== 'hidden'); ``` Updating a Menu's Parent ------------------------ [](#updating-a-menus-parent) Move an existing menu registration to a different parent: ``` Menu::update(ReportsMenu::class, NewParentMenu::class)->after('some.slug'); ``` Rendering --------- [](#rendering) ### As Array [](#as-array) ``` $items = Menu::make()->items(); return view('layouts.app', ['items' => $items]); ``` ### As HTML [](#as-html) The package ships with Blade views compatible with Metronic/Bootstrap sidebar menus: ``` {!! Menu::make()->toHtml() !!} ``` You can customize the views after publishing them: ``` php artisan vendor:publish --tag=laravel-menus-views ``` Views are published to `resources/views/vendor/laravel-menus`. Access Control -------------- [](#access-control) Items with an `access` key are filtered through a configurable callback. The default uses Laravel's `Gate`: ``` // config/laravel-menus.php 'access_callback' => \SaeedHosan\Menus\Access\GateAccessCallback::class, ``` Define permissions on your items: ``` [ 'name' => 'Reports', 'slug' => 'reports', 'access' => 'view-reports', // single permission // 'access' => ['view-reports', 'admin'], // multiple permissions ] ``` To use a custom callback, create an invokable class: ``` class MyAccessCallback { public function __invoke(string|array $permissions): bool { // your logic } } ``` Renderable Condition -------------------- [](#renderable-condition) Control whether a menu renders at all by overriding `renderable()`: ``` class AdminMenu extends MenuBuilder { public function renderable(): bool { return auth()->user()?->isAdmin() ?? false; } public function items(): array { return [ /* ... */ ]; } } ``` Badges ------ [](#badges) `MenuBuilder` provides badge helpers you can use in your items: ``` class AdminMenu extends MenuBuilder { public function items(): array { return [ [ 'name' => 'Feature', 'slug' => 'feature', 'badge' => $this->badgeNew(), // "New" green badge // 'badge' => $this->badgeBeta(), // "Beta" primary badge // 'badge' => $this->badgeSoon(), // "Soon" light badge // 'badge' => $this->badgeInfo(), // "info" info badge ], ]; } } ``` Testing ------- [](#testing) ``` composer test ``` License ------- [](#license) MIT ### Health Score 38 — LowBetter than 83% of packages Maintenance83 Actively maintained with recent releases Popularity15 Limited adoption so far Community6 Small or concentrated contributor base Maturity38 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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 ~15 days Total 3 Last Release 99d ago Major Versions v0.0.0 → v1.1.02026-03-27 ### Community Maintainers ![](https://www.gravatar.com/avatar/1f8ebeaa5852b0579934881dcb0e479ab2c970960774be27e224db9ee005cffe?d=identicon)[saeedhosan](/maintainers/saeedhosan) --- Top Contributors [![saeedhosan](https://avatars.githubusercontent.com/u/78552486?v=4)](https://github.com/saeedhosan "saeedhosan (9 commits)") ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint Type Coverage Yes ### Embed Badge ![Health badge](/badges/saeedhosan-laravel-menus/health.svg) ``` [![Health](https://phpackages.com/badges/saeedhosan-laravel-menus/health.svg)](https://phpackages.com/packages/saeedhosan-laravel-menus) ``` ### Alternatives [markwalet/nova-modal-response A Laravel Nova asset for Modal responses on an action. 17878.9k](/packages/markwalet-nova-modal-response)[crumbls/layup A visual page builder plugin for Filament 5 — Divi-style grid layouts with extensible widgets. 592.7k1](/packages/crumbls-layup)[team-nifty-gmbh/tall-datatables Server-side rendered datatables for Laravel and Livewire 1320.9k4](/packages/team-nifty-gmbh-tall-datatables)[tomshaw/electricgrid A feature-rich Livewire package designed for projects that require dynamic, interactive data tables. 119.4k](/packages/tomshaw-electricgrid) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)