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(8mo ago)251.8k—0%4[1 PRs](https://github.com/solutionforest/filament-header-select/pulls)MITBladePHP ^8.1

Since Sep 4Pushed 8mo 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 1mo ago

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 Soruces.

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.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ0MTc0NTIsIm5iZiI6MTc3NDQxNzE1MiwicGF0aCI6Ii82ODIxMTk3Mi80ODU3NDQ1NjAtYWQ3ODAxMDAtM2NmNC00NzAxLTgyM2QtMmY2YmM1ZjQxMWMwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzI1VDA1MzkxMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFhZmY5ZWUzN2QxNzhjYTQyNjViYWZhMTFjZWFmYTRlZDgzZTMyZTllMjI3YzI1NDY2MjNmMzBmYzk2YmIwMWQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.xzYZKjCMMfuLhB7Pj7TkGuaAQ27yxeWbHi0szm4kHnk)](https://private-user-images.githubusercontent.com/68211972/485744560-ad780100-3cf4-4701-823d-2f6bc5f411c0.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzQ0MTc0NTIsIm5iZiI6MTc3NDQxNzE1MiwicGF0aCI6Ii82ODIxMTk3Mi80ODU3NDQ1NjAtYWQ3ODAxMDAtM2NmNC00NzAxLTgyM2QtMmY2YmM1ZjQxMWMwLnBuZz9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjAzMjUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwMzI1VDA1MzkxMlomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPWFhZmY5ZWUzN2QxNzhjYTQyNjViYWZhMTFjZWFmYTRlZDgzZTMyZTllMjI3YzI1NDY2MjNmMzBmYzk2YmIwMWQmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.xzYZKjCMMfuLhB7Pj7TkGuaAQ27yxeWbHi0szm4kHnk)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

35

—

LowBetter than 80% of packages

Maintenance60

Regular maintenance activity

Popularity30

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity34

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

Unknown

Total

1

Last Release

256d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/9499120912b47a170291b3b795ea0255f060d8500bd2988535e4e6faccee5c8d?d=identicon)[solutionforest](/maintainers/solutionforest)

---

Top Contributors

[![lam0819](https://avatars.githubusercontent.com/u/68211972?v=4)](https://github.com/lam0819 "lam0819 (8 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.

2223.9M151](/packages/filament-support)[guava/filament-knowledge-base

A filament plugin that adds a knowledge base and help to your filament panel(s).

206120.5k1](/packages/guava-filament-knowledge-base)[ralphjsmit/laravel-filament-seo

A package to combine the power of Laravel SEO and Filament Admin.

15398.7k10](/packages/ralphjsmit-laravel-filament-seo)[andreia/filament-ui-switcher

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

233.8k](/packages/andreia-filament-ui-switcher)[geo-sot/filament-env-editor

Access .env file though Filament admin panel

2432.3k1](/packages/geo-sot-filament-env-editor)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)

PHPackages © 2026

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