README

Filament Topbar

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

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 5.x

Installation

You can install the package via composer:

composer require jeffersongoncalves/filament-topbar:^3.0

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

Usage

Add in AdminPanelProvider.php

use JeffersonGoncalves\Filament\Topbar\TopbarPlugin;

->plugins([
    TopbarPlugin::make(),
])

How it works

The package:

1. Registers a new custom topbar component that replaces the default one
2. 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

• Jèfferson Gonçalves
• All Contributors

License

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