Download the PHP package dowhile/filament-tweaks without Composer

Filament Tweaks

An opinionated collection of defaults for Filament panels — the settings you would otherwise copy into every project by hand.

It applies sensible global defaults (non-native selects, striped tables, centered form actions, translated labels, date/time and currency formats), ships a handful of macros and reusable filters, and includes CSS fixes for RTL panels. Every tweak is a config flag, so you can turn off anything you disagree with.

Installation

Install the package via composer:

Register the plugin on any panel you want it applied to:

Optionally publish the config file:

Panel defaults

These are applied to every panel the plugin is registered on, and are not configurable:

• brandName() falls back to APP_NAME when the panel does not set one.
• resourceCreatePageRedirect('view') and resourceEditPageRedirect('view') — after create/edit, land on the view page.
• SPA mode ($panel->spa()) is enabled on all registered panels by the service provider.

If joaopaulolndev/filament-edit-profile is installed, its edit_profile_form, edit_password_form and browser_sessions_form Livewire components are aliased so they can be rendered by name.

Features

Each feature is toggled by a key under features in config/filament-tweaks.php.

Formats

Uncomment any of these to set panel-wide display defaults. Each one is skipped when left unset:

date, time, datetime and currency are applied to both Table and Schema defaults; timezone is passed to FilamentTimezone::set().

Relation managers on edit pages

This one is off by default — it changes what existing pages render, so you opt in:

Once enabled, every EditRecord page of those panels behaves as if it declared:

Relation managers keep showing up on view pages and on ManageRelatedRecords pages — only edit pages are emptied. It is implemented as a Livewire component hook, so no page or resource needs to be touched.

A page opts out in either of two ways:

The opt-out is detected per page class: declaring getRelationManagers() on the page (or on your own base edit page class) is enough to be left alone.

Macros

A column keeps the last word wherever allColumnsToggleable() is called from: one that declares ->toggleable(isToggledHiddenByDefault: true) still starts hidden, and one that declares ->toggleable(false) stays out of the column manager. A hidden column — including one whose ->visible() is decided per record — is never toggleable, which is Filament's own rule.

Used panel-wide, a condition is still evaluated per table, but the default it switches on covers every table built after it in the same request. Call the macro after ->columns([...]) when the condition has to be answered per table.

IDE completion

Macros are registered at runtime, so editors cannot see them on their own. The package ships an ide.php stub file that declares them; VS Code (Intelephense) and PhpStorm index vendor/ automatically, so completion for the macros works with no setup. The file is never autoloaded and every declaration in it sits behind if (false), so PHP never executes it.

The macros are registered by the package's service provider, not by the plugin, because they live on the component classes rather than on a panel. A plugin only boots on a request that goes through a panel, so registering them there would leave them undefined in tests, console commands and queued jobs — the macro would exist or not depending on whether something had already hit a panel route in that process.

Filters

Both filters render an active indicator built from the filter label. Note that RangeFilter currently uses hard-coded Hebrew labels for its min/max inputs.

Navigation icons

HasActiveNavigationIcon derives the active icon from the regular one by swapping the outline heroicon for its solid variant (heroicon-o-users → heroicon-s-users):

Dowhile\FilamentTweaks\Pages\Dashboard is a drop-in Filament dashboard with the trait already applied.

Styling

A stylesheet is registered automatically with the panel. It covers:

• [x-cloak] hiding, and .dir-rtl / .dir-ltr direction utilities.
• Centered modal footer actions on larger screens.
• Autogrowing textareas (textarea.autogrow).
• A single-tenant tenant menu rendered without a dropdown icon or hover state.
• RTL fixes: LTR-aligned email/tel inputs and columns, a mirrored nprogress bar, button group borders, and flipped alignment/undo/redo icons in the rich editor.

When the date range picker filter package is installed, a second stylesheet fixes its RTL layout (calendar direction, arrows, ranges panel and buttons).

When show_pagination_overview_on_small_screens is enabled (the default), a small inline <style> block is injected into the panel head (via a HEAD_END render hook) that turns the pagination nav into a size container and re-shows the results overview on its own centered row once the bar drops below 56rem.

Testing

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

• zvizvi
• All Contributors

License

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