Laravel PWA
nyoncode/laravel-pwa udělá z Laravel aplikace instalovatelnou Progressive Web App: jedna aplikace na jedné adrese, která na desktopu běží v okně s tlačítky Zpět a Obnovit, na telefonu a tabletu na celou obrazovku, funguje bez připojení, přežije údržbu a nainstalovaná zůstane přihlášená.
Podporuje Laravel 12 a 13 a PHP 8.2+. Postavený je na nyoncode/laravel-package-toolkit.
Z čeho se skládá
| Část | Co dělá | Stránka |
|---|---|---|
| Manifest | /manifest.webmanifest z configu a fluent API, režim zobrazení, ikony, integrace do OS | Manifest, Režim zobrazení |
| Komponenty | <x-pwa::head/>, <x-pwa::nav/>, <x-pwa::install/> | Komponenty |
| Service worker | /sw.js sestavený z Vite buildu, strategie cache, aktualizace | Service worker |
| Offline | offline obrazovka, stránky dostupné offline, fronta akcí | Offline |
| Session | remember-me v nainstalované aplikaci, keep-alive, obnova CSRF | Trvalé přihlášení |
| Údržba | obrazovka údržby, pwa:down, rozlišení 503 od výpadku sítě | Údržba |
| Nouzové vypnutí | pwa:disable odstraní service worker ze všech zařízení | Nouzové vypnutí |
| Klient | window.Pwa, události pwa:* | JavaScript klient |
| Push | volitelně: kanál pro notifikace, Pwa.push, odběry po zařízeních; nebo místo pro vlastní push systém | Push notifikace |
| AI | MCP server, skill a reference pro coding agenty | AI agenti |
Co balíček nedělá
- Sám od sebe push neposílá. Modul push je vypnutý, dokud ho nezapnete, a prohlížeč se na oprávnění zeptá, až když váš kód zavolá
Pwa.push.subscribe(). Viz Push notifikace. - Nebuildí frontend. Assety bere z Vite buildu aplikace (
public/build/manifest.json). - Nerozhoduje o tom, co je offline. Žádná stránka se neuloží, dokud to server nepovolí middlewarem
pwa.cache.
Nejrychlejší cesta
bash
composer require nyoncode/laravel-pwa
php artisan pwa:install
php artisan pwa:icons resources/pwa/icon.pngblade
<head>
<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
<x-pwa::head/>
</head>Pokračujte na Instalaci.