PHPackages                             skyraptor/filament-navigation - 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. skyraptor/filament-navigation

ActiveLibrary[Utility & Helpers](/categories/utility)

skyraptor/filament-navigation
=============================

Build structured navigation menus in Filament.

0.3.2(4y ago)0513MITPHPPHP ^8.1

Since Apr 19Pushed 3y agoCompare

[ Source](https://github.com/bumbummen99/filament-navigation)[ Packagist](https://packagist.org/packages/skyraptor/filament-navigation)[ Docs](https://github.com/bumbummen99/filament-navigation)[ GitHub Sponsors](https://github.com/ryangjchandler)[ RSS](/packages/skyraptor-filament-navigation/feed)WikiDiscussions main Synced today

READMEChangelog (3)Dependencies (16)Versions (20)Used By (0)

Filament translateable Navigation
=================================

[](#filament-translateable-navigation)

[![Latest Version on Packagist](https://camo.githubusercontent.com/0c6a41498a013490c0413da0c6236415070538d0b73b3d5aaeeca0634904b6c7/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736b79726170746f722f66696c616d656e742d6e617669676174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/skyraptor/filament-navigation)[![GitHub Tests Action Status](https://camo.githubusercontent.com/3c250bcfd473ff2129475a0cab14ae7520b8510c2af432f62567ac776eb9a138/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f62756d62756d6d656e39392f66696c616d656e742d6e617669676174696f6e2f72756e2d74657374733f6c6162656c3d7465737473)](https://github.com/bumbummen99/filament-navigation/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/bdbd4c099cf61e1ef05722bfc23f52e8394f6636c2ec2f1a72cbbe95a5ba888a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f62756d62756d6d656e39392f66696c616d656e742d6e617669676174696f6e2f436865636b253230262532306669782532307374796c696e673f6c6162656c3d636f64652532307374796c65)](https://github.com/bumbummen99/filament-navigation/actions?query=workflow%3A%22Check+%26+fix+styling%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/5437244e27e5678594289f9cbac9f23f6520c4aaae6c10b6a73a22c3f40ebb73/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f736b79726170746f722f66696c616d656e742d6e617669676174696f6e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/skyraptor/filament-navigation)

This is a fork of [FilamentNavigation](https://github.com/ryangjchandler/filament-navigation) extended with translation support.

This plugin for Filament provides a `Navigation` resource that allows to build structural navigation menus with ease.

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

[](#installation)

Begin by installing this package via Composer:

```
composer require skyraptor/filament-navigation
```

Publish the package's assets:

```
php artisan vendor:publish --tag="filament-navigation-assets"
```

Usage
-----

[](#usage)

The `NavigationResource` is automatically registered with Filament so no configuration is required to start using it.

If you wish to customise the navigation group, sort or icon, you can use the respective `NavigationResource::navigationGroup()`, `NavigationResource::navigationSort()` and `NavigationResource::navigationIcon()` methods.

### Data structure

[](#data-structure)

Each navigation menu is required to have a `name` and `handle`. The `handle` should be unique and used to retrieve the menu.

Items are stored inside of a JSON column called `items`. This is a recursive data structure that looks like:

```
[
    {
        "label": "Home",
        "type": "external-link",
        "data": {
            "url": "/",
            "target": "_blank",
        },
        "children": [
            // ...
        ],
    }
]
```

The recursive structure makes it really simple to render nested menus / dropdowns:

```

    @foreach($menu->items as $item)

            {{ $item['label'] }}

            @if($item['children'])

                    {{-- Render the item's children here... --}}

            @endforeach

    @endforeach

```

### Retrieving a navigation object

[](#retrieving-a-navigation-object)

To retreive a navigation object, provide the handle to the `RyanChandler\FilamentNavigation\Facades\FilamentNavigation::get()` method.

```
use RyanChandler\FilamentNavigation\Facades\FilamentNavigation;

$menu = FilamentNavigation::get('main-menu');
```

### Custom item types

[](#custom-item-types)

Out of the box, this plugin comes with a single "item type" called "External link". This item type expects a URL to be provided and an optional "target" (same tab or new tab).

It's possible to extend the plugin with custom item types. Custom item types have a name and an array of Filament field objects that will be displayed inside of the "Item" modal.

This API allows you to deeply integrate navigation menus with your application's own entities and models.

```
use RyanChandler\FilamentNavigation\Facades\FilamentNavigation;

FilamentNavigation::addItemType('Post link', [
    Select::make('post_id')
        ->searchable()
        ->options(function () {
            return Post::pluck('title', 'id');
        })
]);
```

All custom fields for the item type can be found inside of the `data` property on the item.

### The `Navigation` field type

[](#the-navigation-field-type)

This plugin also provides a custom Filament field that can be used to search and select a navigation menu inside other forms and resources.

```
use RyanChandler\FilamentNavigation\Filament\Fields\NavigationSelect;

->schema([
    NavigationSelect::make('navigation_id'),
])
```

By default, this field will not be searchable and the value for each option will be the menu `id`.

To make the field searchable, call the `->searchable()` method.

```
->schema([
    NavigationSelect::make('navigation_id')
        ->searchable(),
])
```

If you wish to change the value for each option, call the `->optionValue()` method.

```
->schema([
    NavigationSelect::make('navigation_id')
        ->optionValue('handle'),
])
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Ryan Chandler](https://github.com/ryangjchandler)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

27

—

LowBetter than 47% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 53% 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 ~8 days

Total

9

Last Release

1469d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4533331?v=4)[Patrick](/maintainers/bumbummen99)[@bumbummen99](https://github.com/bumbummen99)

---

Top Contributors

[![ryangjchandler](https://avatars.githubusercontent.com/u/41837763?v=4)](https://github.com/ryangjchandler "ryangjchandler (44 commits)")[![bumbummen99](https://avatars.githubusercontent.com/u/4533331?v=4)](https://github.com/bumbummen99 "bumbummen99 (34 commits)")[![flxsource](https://avatars.githubusercontent.com/u/1785446?v=4)](https://github.com/flxsource "flxsource (1 commits)")[![justrau](https://avatars.githubusercontent.com/u/10882793?v=4)](https://github.com/justrau "justrau (1 commits)")[![lordjoo](https://avatars.githubusercontent.com/u/11289152?v=4)](https://github.com/lordjoo "lordjoo (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

laravelryangjchandlerfilament-navigation

###  Code Quality

TestsPest

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/skyraptor-filament-navigation/health.svg)

```
[![Health](https://phpackages.com/badges/skyraptor-filament-navigation/health.svg)](https://phpackages.com/packages/skyraptor-filament-navigation)
```

###  Alternatives

[rawilk/profile-filament-plugin

Profile & MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-jetstream

A Laravel starter kit built with Filament inspired by Jetstream.

17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-debugger

About

104162.2k2](/packages/stephenjude-filament-debugger)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

329530.5k29](/packages/codewithdennis-filament-select-tree)[malzariey/filament-daterangepicker-filter

This package uses daterangepciker library to filter date by a range or predefined date ranges (Today , Yesterday ...etc)

1772.3M23](/packages/malzariey-filament-daterangepicker-filter)[stephenjude/filament-feature-flags

Filament implementation of feature flags and segmentation with Laravel Pennant.

122177.8k1](/packages/stephenjude-filament-feature-flags)

PHPackages © 2026

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