Laravel PWA — Progressive Web App Setup

Auto-Generate Files

Automatically compiles and updates the PWA manifest and service worker files directly into your public folder.

Install Prompts

Configurable "Add to Home Screen" install buttons and banner flows with zero complex client-side javascript code.

Blade Directives

Includes simple directives like `@PwaHead` and `@RegisterServiceWorkerScript` to link metadata and service workers.

Multi-Framework Ready

Works out of the box with default Blade layouts, Livewire components, Inertia Vue pages, or React routes.

Dynamic Logo Uploads

In-built features to upload, validate, resize, and update PWA logos and splash images directly through controller endpoints.

Facade API

Update application names, icons, background themes, and display modes programmatically via the `PWA` Facade API.

PWA Easy Setup for Laravel

Erag Laravel PWA is a package designed to seamlessly integrate Progressive Web Application (PWA) functionality into your Laravel projects. With this package, you can easily configure, update the manifest, and register service workers, enabling any Laravel app to function as a PWA. It requires minimal configuration and works out of the box with Blade, Livewire, Vue, and React environments.

Frequently Asked Questions

Does this package require HTTPS?

Yes. Progressive Web Application features, including service workers and installation prompts, require a secure HTTPS connection to function. On local development, localhost is treated as a secure context, but testing on external devices or staging/production servers requires SSL setup.

Is it compatible with Livewire wire:navigate?

Absolutely. By setting 'livewire-app' => true in your configuration, the package adds the data-navigate-once attribute to the service worker scripts to prevent duplicate registrations and script leaks during page transitions.

How do I update the application logo?

Simply replace the PNG logo at public/logo.png (must be at least 512x512 pixels) and run the php artisan erag:update-manifest command to regenerate the manifest icons.

Can I update the PWA manifest at runtime?

Yes. The package includes a PWA Facade that allows you to dynamically merge and update manifest values inside your controller actions or background jobs.

Laravel PWAPWA Easy Setup for Laravel