# Filament PWA: turn your Laravel admin panel into an installable app

> Make a Filament 5 panel installable on phones and desktops with tomatophp/filament-pwa: manifest, icons, iOS splash screens and shortcuts, all managed from a settings page.

*2026-11-10T05:04:25Z*

Your team opens the admin panel twenty times a day. On a phone, that means finding a bookmark in a browser tab. A **Progressive Web App (PWA)** fixes that: the panel gets an icon on the home screen, opens full-screen, and feels like an app, with no App Store.

`tomatophp/filament-pwa` adds that to any Filament panel, and you configure it from a settings page instead of hand-writing JSON.

## What the plugin gives you

- A generated **web app manifest** (name, short name, start URL, display mode, orientation, theme and background colors, status bar style).
- **App icons** from 72×72 to 512×512, uploaded once in the panel.
- **iOS splash screens** from 640×1136 up to 2048×2732.
- **Shortcuts** (long-press actions on the installed icon).
- A Blade directive, `@filamentPWA`, if you also want PWA tags on non-Filament pages.

## Compatibility

| Plugin version | Filament | Laravel | PHP |
|---|---|---|---|
| 5.x | 5.x | 12.x – 13.x | 8.2+ |
| 4.x | 4.x | | |
| 1.x | 3.x | | |

## Install in four steps

```bash
composer require tomatophp/filament-pwa
php artisan filament-settings-hub:install
php artisan filament-pwa:install
```

The PWA settings are stored with [Filament Settings Hub](/en/plugins/filament-settings-hub), which is why the second command creates the `settings` table.

Then register the plugin in your panel provider:

```php
use TomatoPHP\FilamentPWA\FilamentPWAPlugin;

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

Open the panel, go to the PWA settings page, fill in the app name and colors, upload your icons and splash images, and save.

## Configuration

Publish the config with `php artisan vendor:publish --tag=filament-pwa-config`. The options are short:

- `middlewares`: extra middleware for the PWA routes (default `[]`).
- `allow_routes`: register the plugin's routes (default `true`).
- `upload_disk`: where icons and splash images go (`FILAMENT_PWA_UPLOAD_DISK`, default `public`).

You can also publish the views (`filament-pwa-views`) and translations (`filament-pwa-lang`). Arabic is included, like the rest of TomatoPHP.

## Using it outside the panel

If your public site and your panel share a domain, add the directive before `</head>` in your layout:

```blade
@filamentPWA
```

## Tips that save you a support ticket

- **Serve over HTTPS.** Browsers only offer "Install app" on secure origins (localhost is the exception).
- **Use square PNG icons** with some padding, so Android's masked icons don't crop your logo.
- **Set the start URL to the panel path** (for example `/admin`) so the installed app opens straight to the dashboard.
- **Test install on iOS Safari** (Share → Add to Home Screen) and on Chrome for Android and desktop.

## What to add next

A panel people open from their home screen is usually a panel used on the go. Pair it with:

- [Filament Users](/en/plugins/filament-users) for user management.
- [Filament Language Switcher](/en/plugins/filament-language-switcher) for Arabic and English with RTL.
- [Filament Alerts](/en/plugins/filament-alerts) for notifications.

Or follow the full order in [Ship a Laravel admin panel in a day with Filament 5 and TomatoPHP](/en/blog/laravel-admin-panel-in-a-day-filament-tomatophp).

Want a panel built, branded and installed for your client? [White-label Laravel + Filament](https://fadymondy.com/en/services/white-label-laravel-filament).

---

Source: https://tomatophp.com/en/blog/filament-pwa-installable-admin-panel
