jeffersongoncalves/filament-topbar

A simple yet effective Filament plugin that automatically adds a customized topbar to your Filament admin panel. This plugin enhances your Filament panel's user experience by replacing the default topbar component with an improved version that displays navigation and user interface elements in strat

1.0.1 2025-08-02 01:22 UTC

This package is auto-updated.

Last update: 2025-08-02 01:36:50 UTC


README

Filament Topbar

Filament Topbar

Latest Version on Packagist GitHub Code Style Action Status Total Downloads

Description

A simple yet effective Filament plugin that automatically adds a customized topbar to your Filament admin panel. This plugin enhances your Filament panel's user experience by replacing the default topbar component with an improved version that displays navigation and user interface elements in strategic locations.

Preview

Preview Topbar Navigation

Preview Topbar Navigation Mobile

Features

  • 🎨 Custom Topbar Component: Replaces the default Filament topbar with an enhanced version
  • 🔧 Easy Integration: Automatically integrates with your existing Filament panels
  • 🚀 Zero Configuration: Works out of the box after installation
  • 📱 Responsive Design: Maintains Filament's responsive design principles
  • 🔄 Backward Compatible: Preserves the original topbar functionality while adding enhancements

Requirements

  • PHP 8.2 or higher
  • Filament 3.x

Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-topbar:^1.0

The package will automatically register its service provider and replace the default Filament topbar component.

Usage

Once installed, the package works automatically. No additional configuration is required. The enhanced topbar will be displayed in all your Filament admin panels.

$panel
  ->topbarNavigation();

How it works

The package:

  1. Backs up the original Filament topbar component as filament-panels::topbar-backup
  2. Registers a new custom topbar component that replaces the default one
  3. Uses a custom Blade view that enhances the topbar functionality

Customization

If you need to customize the topbar view, you can publish the views:

php artisan vendor:publish --tag="filament-topbar-views"

This will publish the topbar view to resources/views/vendor/filament-topbar/components/topbar.blade.php where you can modify it according to your needs.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.