PHPackages                             filafly/filament-logo-tools - 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. filafly/filament-logo-tools

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

filafly/filament-logo-tools
===========================

Enhanced logo controls for Filament panel sidebars — icon logos, collapse button positioning, and inverted logo sections.

v0.1.0(2mo ago)12MITPHPPHP ^8.2

Since Feb 19Pushed 2mo agoCompare

[ Source](https://github.com/filafly/filament-logo-tools)[ Packagist](https://packagist.org/packages/filafly/filament-logo-tools)[ Docs](https://filafly.com/plugins/filament-logo-tools)[ RSS](/packages/filafly-filament-logo-tools/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (8)Versions (3)Used By (0)

Logo Tools for Filament
=======================

[](#logo-tools-for-filament)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a10202305048cb7dbe934a5a10f951607a59421b55d20d3131e88416809abbdf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66696c61666c792f66696c616d656e742d6c6f676f2d746f6f6c732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/filafly/filament-logo-tools)[![Total Downloads](https://camo.githubusercontent.com/2ebb47894eb4d16f6c05513bb5767bb78ed59cae207ea2ba6bc16b93ff169696/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66696c61666c792f66696c616d656e742d6c6f676f2d746f6f6c732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/filafly/filament-logo-tools)

A Filament plugin that adds enhanced logo and sidebar controls to your panel. All features are implemented through Filament's native plugin system, render hooks, and CSS — no view overrides required.

Requirements
------------

[](#requirements)

- PHP 8.2+
- Filament v4 or v5

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

[](#installation)

You can install the package via Composer:

```
composer require filafly/filament-logo-tools
```

Publish the assets:

```
php artisan filament:assets
```

Register the plugin in your panel provider:

```
use Filafly\LogoTools\LogoToolsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugin(LogoToolsPlugin::make());
}
```

Icon Logo
---------

[](#icon-logo)

Display a compact icon when the sidebar is collapsed, replacing the full brand logo. Only renders when the panel has `sidebarCollapsibleOnDesktop()` enabled.

```
LogoToolsPlugin::make()
    ->iconLogo('img/icon.svg')
    ->darkModeIconLogo('img/icon-dark.svg')
    ->iconLogoHeight('1.5rem')
```

### `iconLogo(string | Htmlable | Closure | null $logo)`

[](#iconlogostring--htmlable--closure--null-logo)

The icon shown when the sidebar is collapsed. Accepts a file path (rendered as ``), an `Htmlable` instance (rendered inline), or a `Closure`.

```
// Image path
->iconLogo('img/icon.svg')

// Inline SVG
->iconLogo(fn () => new HtmlString('...'))
```

### `darkModeIconLogo(string | Htmlable | Closure | null $logo)`

[](#darkmodeiconlogostring--htmlable--closure--null-logo)

A separate icon for dark mode. When set, the light and dark variants swap automatically. If not set, the single `iconLogo` is used in both modes.

### `iconLogoHeight(string | Closure | null $height)`

[](#iconlogoheightstring--closure--null-height)

The CSS height of the icon logo. Defaults to `1.5rem`.

```
->iconLogoHeight('2rem')
```

Logo Section
------------

[](#logo-section)

Control the appearance of the logo section area in the topbar and sidebar header.

### `logoSectionBackground(array | string | bool $color = true)`

[](#logosectionbackgroundarray--string--bool-color--true)

Adds an inverted background to the logo section — dark background in light mode, light background in dark mode. The full brand logo's light/dark variants are swapped automatically to match.

```
// Default dark/light inversion
->logoSectionBackground()

// Filament color (array)
->logoSectionBackground(Color::Blue)

// Filament color name
->logoSectionBackground('primary')

// Hex code
->logoSectionBackground('#1e3a5f')

// CSS color function
->logoSectionBackground('oklch(0.5 0.2 240)')

// Tailwind class
->logoSectionBackground('bg-gray-900')
```

### `logoSectionBorder(string | Closure | null $color = 'rgb(0 0 0 / 0.1)')`

[](#logosectionborderstring--closure--null-color--rgb0-0-0--01)

Adds a vertical border on the trailing edge of the logo section. Works with or without `logoSectionBackground()`.

```
// Default subtle black border
->logoSectionBorder()

// Custom color (e.g. for use with logoSectionBackground)
->logoSectionBorder('rgb(255 255 255 / 0.1)')
```

### `logoSectionPadding(string | Closure | null $padding)`

[](#logosectionpaddingstring--closure--null-padding)

Adds inline-start padding to the logo section.

```
->logoSectionPadding('1rem')
```

### `collapsedLogoSectionWidth(string | Closure | null $width)`

[](#collapsedlogosectionwidthstring--closure--null-width)

Overrides the collapsed width of the logo section in the topbar. Filament's `--collapsed-sidebar-width` CSS variable (`4.5rem`) is not always visually accurate, so this lets you fine-tune alignment.

```
->collapsedLogoSectionWidth('5.5rem')
```

Collapse Button
---------------

[](#collapse-button)

Customize the sidebar collapse/expand button appearance and behavior.

### `collapseButtonPosition(CollapseButtonPosition $position)`

[](#collapsebuttonpositioncollapsebuttonposition-position)

Controls whether the collapse button appears to the left or right of the logo. Automatically set to `Right` when an icon logo is configured.

When positioned right, the button is rendered as a small edge button sitting on the border of the logo section — similar to apps like Linear and Notion.

```
use Filafly\LogoTools\Enums\CollapseButtonPosition;

->collapseButtonPosition(CollapseButtonPosition::Right)
```

### `collapseButtonStyle(CollapseButtonStyle | string $style)`

[](#collapsebuttonstylecollapsebuttonstyle--string-style)

Sets the shape of the collapse button when positioned on the logo section edge. Accepts the enum or a string (`'circle'`, `'rounded'`, `'square'`).

```
use Filafly\LogoTools\Enums\CollapseButtonStyle;

->collapseButtonStyle(CollapseButtonStyle::Circle)   // full circle (default)
->collapseButtonStyle(CollapseButtonStyle::Rounded)  // slightly rounded corners
->collapseButtonStyle('square')                      // sharp corners
```

### `expandButtonIcon(string | BackedEnum | null $icon)`

[](#expandbuttoniconstring--backedenum--null-icon)

Overrides the icon shown on the expand button (when sidebar is collapsed).

```
use Filament\Support\Icons\Heroicon;

// Enum
->expandButtonIcon(Heroicon::OutlinedChevronRight)

// String
->expandButtonIcon('heroicon-o-arrow-right')
```

### `collapseButtonIcon(string | BackedEnum | null $icon)`

[](#collapsebuttoniconstring--backedenum--null-icon)

Overrides the icon shown on the collapse button (when sidebar is expanded).

```
->collapseButtonIcon(Heroicon::OutlinedChevronLeft)
```

Full Example
------------

[](#full-example)

```
use Filafly\LogoTools\LogoToolsPlugin;
use Filafly\LogoTools\Enums\CollapseButtonStyle;
use Filament\Support\Colors\Color;

->plugin(
    LogoToolsPlugin::make()
        ->iconLogo('img/icon.svg')
        ->darkModeIconLogo('img/icon-dark.svg')
        ->iconLogoHeight('1.25rem')
        ->logoSectionBackground(Color::Blue)
        ->logoSectionBorder('rgb(255 255 255 / 0.1)')
        ->logoSectionPadding('0.5rem')
        ->collapsedLogoSectionWidth('5.5rem')
        ->collapseButtonStyle('rounded')
        ->expandButtonIcon('heroicon-o-arrow-right')
        ->collapseButtonIcon('heroicon-o-arrow-left')
)
```

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)

- [Nolan Nordlund](https://github.com/nolanos)
- [All Contributors](../../contributors)

License
-------

[](#license)

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

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance84

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity37

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

Every ~6 days

Total

2

Last Release

82d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e8e5241b3b450ab4c64dd7ad1a868a00c3eef90731d0a6024385ec4246d4b3dd?d=identicon)[filafly](/maintainers/filafly)

---

Top Contributors

[![nolannordlund](https://avatars.githubusercontent.com/u/11064008?v=4)](https://github.com/nolannordlund "nolannordlund (2 commits)")

---

Tags

pluginlaravelfilamentlogosidebar

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/filafly-filament-logo-tools/health.svg)

```
[![Health](https://phpackages.com/badges/filafly-filament-logo-tools/health.svg)](https://phpackages.com/packages/filafly-filament-logo-tools)
```

###  Alternatives

[pboivin/filament-peek

Full-screen page preview modal for Filament

253319.6k12](/packages/pboivin-filament-peek)[awcodes/filament-badgeable-column

Filament Tables column to append and prepend badges.

142419.3k3](/packages/awcodes-filament-badgeable-column)[dotswan/filament-map-picker

Easily pick and retrieve geo-coordinates using a map-based interface in your Filament applications.

124139.3k2](/packages/dotswan-filament-map-picker)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[aymanalhattami/filament-context-menu

context menu (right click menu) for filament

9838.0k](/packages/aymanalhattami-filament-context-menu)[tapp/filament-google-autocomplete-field

Filament plugin that provides a Google Autocomplete field

3098.1k](/packages/tapp-filament-google-autocomplete-field)

PHPackages © 2026

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