PHPackages                             solution-forest/filament-header-select - 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. solution-forest/filament-header-select

ActiveLibrary[Admin Panels](/categories/admin)

solution-forest/filament-header-select
======================================

A simple, powerful header select component for Filament admin panels

v0.0.1(10mo ago)252.1k↑18.8%4[1 issues](https://github.com/solutionforest/filament-header-select/issues)MITBladePHP ^8.1

Since Sep 4Pushed 2mo agoCompare

[ Source](https://github.com/solutionforest/filament-header-select)[ Packagist](https://packagist.org/packages/solution-forest/filament-header-select)[ RSS](/packages/solution-forest-filament-header-select/feed)WikiDiscussions main Synced today

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

[![](https://github.com/solutionforest/.github/raw/main/docs/images/sf.png?raw=true)](https://solutionforest.com)

About Solution Forest
---------------------

[](#about-solution-forest)

[Solution Forest](https://solutionforest.com) Web development agency based in Hong Kong. We help customers to solve their problems. We Love Open Sources.

We have built a collection of best-in-class products:

- [InspireCMS](https://inspirecms.net): A full-featured Laravel CMS with everything you need out of the box. Build smarter, ship faster with our complete content management solution.
- [Filaletter](https://filaletter.solutionforest.net): Filaletter - Filament Newsletter Plugin
- [Website CMS Management](https://filamentphp.com/plugins/solution-forest-cms-website): A hands-on Filament CMS plugin for those who prefer more manual control over their website content management.

Filament Header Select
======================

[](#filament-header-select)

A modern header navigation component for Filament Admin with **global rounded styling** and **proper color system**.

✨ Features
----------

[](#-features)

✅ **Global Rounded Styling** - Apply consistent rounded corners to all navigation elements
✅ **Filament Color System** - Uses native Filament colors (primary, gray, info, success, warning, danger)
✅ **URL Navigation** - Direct links to pages
✅ **Dropdown Selects** - Interactive dropdowns with onChange callbacks
✅ **Dynamic Options** - Refresh dropdown options from database
✅ **No Selection Highlighting** - Clean UI without persistent highlighting
✅ **Responsive Design** - Desktop-optimized, mobile-hidden

[![HeaderSelect](https://private-user-images.githubusercontent.com/68211972/485744560-ad780100-3cf4-4701-823d-2f6bc5f411c0.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MDgwMzksIm5iZiI6MTc4MjcwNzczOSwicGF0aCI6Ii82ODIxMTk3Mi80ODU3NDQ1NjAtYWQ3ODAxMDAtM2NmNC00NzAxLTgyM2QtMmY2YmM1ZjQxMWMwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA0MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTEzZDY2ODAyOTQyNmI1Nzg0ZmQ2NTAwNDYxZDVlNGFhOTMyMWEyM2YxOTk1Nzk5ODMzYTBkNzVhNDIwYTg2YzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.CP5RxYHft6yxPyWDbnBLy3WNGQmjcs74IO0sBVscmUA)](https://private-user-images.githubusercontent.com/68211972/485744560-ad780100-3cf4-4701-823d-2f6bc5f411c0.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI3MDgwMzksIm5iZiI6MTc4MjcwNzczOSwicGF0aCI6Ii82ODIxMTk3Mi80ODU3NDQ1NjAtYWQ3ODAxMDAtM2NmNC00NzAxLTgyM2QtMmY2YmM1ZjQxMWMwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA2MjklMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNjI5VDA0MzUzOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTEzZDY2ODAyOTQyNmI1Nzg0ZmQ2NTAwNDYxZDVlNGFhOTMyMWEyM2YxOTk1Nzk5ODMzYTBkNzVhNDIwYTg2YzImWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0JnJlc3BvbnNlLWNvbnRlbnQtdHlwZT1pbWFnZSUyRnBuZyJ9.CP5RxYHft6yxPyWDbnBLy3WNGQmjcs74IO0sBVscmUA)Installation
------------

[](#installation)

```
composer require solution-forest/filament-header-select
```

Quick Start
-----------

[](#quick-start)

```
use SolutionForest\FilamentHeaderSelect\HeaderSelectPlugin;
use SolutionForest\FilamentHeaderSelect\Components\HeaderSelect;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            HeaderSelectPlugin::make()
                ->rounded('rounded-lg') // Global rounded corners
                ->selects([
                    // URL Link
                    HeaderSelect::make('admin')
                        ->label('Admin')
                        ->url(fn() => route('filament.admin.pages.dashboard'))
                        ->color('primary'),

                    // Dropdown with Navigation
                    HeaderSelect::make('agent_config')
                        ->label('Agent Config')
                        ->options([
                            'my_agent_1' => 'My Agent 2025-08-29 16:24',
                            'my_agent_2' => 'My Agent 2025-08-29 16:20',
                            'new_agent' => '+ New AI Agent',
                        ])
                        ->icon('heroicon-o-cog-6-tooth')
                        ->color('info')
                        ->keepOriginalLabel(true)
                        ->refreshable(true)
                        ->onChange(function ($value) {
                            return match($value) {
                                'my_agent_1' => '/admin/agents/my-agent-1',
                                'my_agent_2' => '/admin/agents/my-agent-2',
                                'new_agent' => '/admin/agents/create',
                                default => null,
                            };
                        }),
                ])
        ]);
}
```

Configuration
-------------

[](#configuration)

### Global Rounded Corners

[](#global-rounded-corners)

```
HeaderSelectPlugin::make()
    ->rounded('rounded-lg')      // Large rounded corners
    ->rounded('rounded-full')    // Pill-like styling
```

### Colors

[](#colors)

```
HeaderSelect::make('item')
    ->color('primary')    // Indigo blue
    ->color('gray')       // Neutral gray
    ->color('info')       // Blue
    ->color('success')    // Green
    ->color('warning')    // Amber
    ->color('danger')     // Red
```

Methods
-------

[](#methods)

MethodDescriptionExample`label(string $label)`Set display label`->label('Admin')``url(string|Closure $url)`Set navigation URL`->url('/admin')``options(array|Closure $options)`Set dropdown options`->options(['key' => 'Label'])``color(string $color)`Set color theme`->color('primary')``icon(string $icon)`Set Heroicon`->icon('heroicon-o-home')``keepOriginalLabel(bool $keep)`Keep original label`->keepOriginalLabel(true)``refreshable(bool $refreshable)`Add refresh button`->refreshable(true)``onChange(Closure $callback)`Handle selection changes`->onChange(fn($value) => route('page', $value))`Examples
--------

[](#examples)

### URL Navigation

[](#url-navigation)

```
HeaderSelect::make('dashboard')
    ->label('Dashboard')
    ->url(fn() => route('filament.admin.pages.dashboard'))
    ->icon('heroicon-o-home')
    ->color('primary')
```

### Dropdown with Redirect

[](#dropdown-with-redirect)

```
HeaderSelect::make('categories')
    ->label('Categories')
    ->options([
        'electronics' => 'Electronics',
        'clothing' => 'Clothing',
        'books' => 'Books',
    ])
    ->icon('heroicon-o-squares-2x2')
    ->color('success')
    ->onChange(function ($value) {
        return "/admin/categories/{$value}";
    })
```

### Dynamic Options from Database

[](#dynamic-options-from-database)

```
HeaderSelect::make('agents')
    ->label('AI Agents')
    ->options(fn() => Agent::pluck('name', 'id'))
    ->refreshable(true)
    ->color('info')
    ->onChange(function ($value) {
        return "/admin/agents/{$value}";
    })
```

Troubleshooting
---------------

[](#troubleshooting)

**Rounded corners not working?**

- Use global `->rounded()` on HeaderSelectPlugin
- Clear cache: `php artisan view:clear`

**Wrong colors showing?**

- Use proper color names: `primary`, `gray`, `info`, `success`, `warning`, `danger`
- Clear cache: `php artisan config:clear`

**onChange redirects not working?**

- Return URL string from onChange callback
- Use `return '/admin/page'` instead of `redirect()->to('/admin/page')`

License
-------

[](#license)

MIT License. See [LICENSE.md](LICENSE.md) for details.

Credits
-------

[](#credits)

- **[Solution Forest](https://github.com/solution-forest)** - Package development
- **[Filament](https://filamentphp.com)** - Laravel admin framework

###  Health Score

39

—

LowBetter than 84% of packages

Maintenance72

Regular maintenance activity

Popularity30

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

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

303d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/68211796?v=4)[Solution Forest](/maintainers/solutionforest)[@solutionforest](https://github.com/solutionforest)

---

Top Contributors

[![lam0819](https://avatars.githubusercontent.com/u/68211972?v=4)](https://github.com/lam0819 "lam0819 (9 commits)")[![silasrm](https://avatars.githubusercontent.com/u/197187?v=4)](https://github.com/silasrm "silasrm (3 commits)")[![solutionforestteam](https://avatars.githubusercontent.com/u/53035878?v=4)](https://github.com/solutionforestteam "solutionforestteam (2 commits)")

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/solution-forest-filament-header-select/health.svg)

```
[![Health](https://phpackages.com/badges/solution-forest-filament-header-select/health.svg)](https://phpackages.com/packages/solution-forest-filament-header-select)
```

###  Alternatives

[filament/support

Core helper methods and foundation code for all Filament packages.

2331.0M245](/packages/filament-support)[tallstackui/tallstackui

TallStackUI is a powerful suite of Blade components that elevate your workflow of Livewire applications.

725173.2k14](/packages/tallstackui-tallstackui)[rawilk/profile-filament-plugin

Profile &amp; 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)[andreia/filament-ui-switcher

Add a modal with options to switch between different UI layouts and styles (colors, fonts, font sizes).

246.4k](/packages/andreia-filament-ui-switcher)[mradder/filament-logger

Audit logging, activity tracking, exports, alerts, and dashboards for Filament admin panels.

2317.4k](/packages/mradder-filament-logger)

PHPackages © 2026

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