Weave Code
Filament Tomatophp Theme Laravel Package
tomatophp/filament-tomatophp-theme
A Filament PHP theme package from TomatoPHP that gives your admin panels a polished, branded look. It ships ready-made styling and layout tweaks so you can drop it into any Filament app and get a consistent TomatoPHP interface with minimal setup.
The TomatoPHP brand theme for FilamentPHP panels: the TomatoPHP mark, brand colors and screen-line styling
Frequently asked questions about Filament Tomatophp Theme
- How do I install tomatophp/filament-tomatophp-theme?
- Install it with Composer by running composer require tomatophp/filament-tomatophp-theme in the root of your Laravel project. Laravel package auto-discovery registers the service provider, so you normally do not need to edit config/app.php by hand. After that, point your Filament panel at the TomatoPHP theme in your panel provider and clear your cached assets so the new styles are picked up.
- Which Laravel and Filament versions does this theme support?
- The package targets modern Laravel applications running FilamentPHP v3-style panels, since it is built as a Filament theme rather than a standalone UI kit. Check the composer.json constraints on the repository page before installing to confirm the exact Laravel and Filament versions your project needs. If you are still on Filament v2, you will likely need a different theme approach because the panel theming API changed significantly.
- How do I register the theme in a Filament panel provider?
- Open the panel provider that defines your Filament panel, typically something like app/Providers/Filament/AdminPanelProvider.php, and reference the TomatoPHP theme in the panel configuration where themes are declared. Filament supports both compiled CSS themes and Vite-based themes, so use whichever method matches your Filament version and build setup. After registering it, run your asset build or clear the Filament cache to see the styling applied.
- Can I change the brand colors to match my own company?
- Yes. The theme ships with the TomatoPHP brand palette, but the underlying Filament color system lets you override primary, gray and other palette values in your panel provider or in custom CSS. If you need something more permanent, publish the theme assets and adjust the CSS variables directly. Keep in mind that overriding colors moves you away from the stock TomatoPHP look, which is fine if the branding is yours rather than theirs.
- Does the theme support dark mode?
- Filament panels support dark mode out of the box, and this theme styles the panel surfaces and screen-line accents so they remain readable in both light and dark modes. You can toggle dark mode availability through the panel configuration if you want to restrict users to a single mode. It is worth spot-checking your custom pages and widgets in both modes after installing, since third-party components may not inherit the theme styles.
- How do I replace the TomatoPHP logo mark with my own logo?
- Filament exposes brand logo and brand mark settings directly on the panel, so you can point them at your own asset URL and leave the rest of the theme styling intact. Because the package is a theme, keeping its colors and screen-line styling while swapping the mark is a common approach for agencies building client panels. If you want a truly clean brand, publish the theme files and replace the shipped mark asset rather than layering two logos.
- Can I use this theme on more than one Filament panel?
- Yes. Theme registration happens per panel provider, so any panel that points at the TomatoPHP theme gets the same styling. That makes it convenient when you have separate admin and staff panels that should look consistent. If only one panel should be branded, simply leave the theme off the other panel providers.
- Do I need Node and a Tailwind build step to use this theme?
- Filament panels generally ship with compiled CSS, so a plain CSS theme can be used without any frontend build tooling. Vite-based themes, however, require you to run npm install and npm run build as part of your deployment. Confirm which mode the package uses in its documentation before deciding whether your pipeline needs a Node step.
- Is this theme safe to use in a production Laravel application?
- It is a presentation-layer package, so the main risks are cosmetic rather than functional: broken styling after a Filament upgrade, or asset caching issues after deploy. Run php artisan filament:optimize or clear your caches as part of deployment, and test your panel in a staging environment first. Because it does not touch your database or business logic, rolling it back is as simple as removing the theme registration.
- How does this compare to writing my own custom Filament theme?
- Building a custom Filament theme means creating a CSS file, registering it on the panel and maintaining Tailwind configuration and asset builds yourself. This package gives you a ready-made branded look with brand colors and screen-line styling so you can skip that setup entirely. Choose the package if you like the TomatoPHP aesthetic or want a fast starting point, and build your own theme if you need full control over every design token.
Weaver
How can I help you explore Laravel packages today?