🌟 Laravel PWA Kit v1.0 — Installable PWA, Offline Support & Livewire/SPA Ready

🌟 Laravel PWA Kit v1.0 — Installable PWA, Offline Support & Livewire/SPA Ready

This initial release introduces full PWA support for Laravel apps, including installable apps, offline pages, service worker registration, and Livewire/Vue/React SPA compatibility. Set up your Laravel project as a Progressive Web App with minimal configuration.

---

✅ What's New / Fixed:

• 📦 PWA Core Setup

  • Automatic generation of manifest.json, sw.js, offline.html, and default logo.png.
  • Configure theme color, background color, icons, shortcuts, and display mode via config/laravel-pwa-kit.php.

• 📲 Add-to-Home-Screen Install Toast

  • Easy install prompt for users with customizable design.
  • Fully works with Blade, Livewire v3, Vue 3, and React SPAs.

• ⚡ Offline Support & Caching

  • Offline page displayed when users lose internet connection.
  • Service worker handles caching strategies for fast loading and offline usability.

• 🧩 Livewire & SPA Friendly

  • Integrates seamlessly with Livewire apps.
  • Compatible with modern frontend frameworks like Vue 3 and React.

• 🔧 Logo & Manifest Management

  • PwaKit::updatePWALogo() allows safe upload and validation of PWA logos.
  • createOrUpdate() and update() methods to manage manifest.json programmatically.

• 🌱 Treeware License

  • Open source under Treeware. Contributions help plant trees globally.

---

✅ Upgrade / Installation Guide:

1. Install via Composer:

composer require devrabiul/laravel-pwa-kit

2. Publish configuration and assets:

php artisan vendor:publish --provider="Devrabiul\PwaKit\PwaKitServiceProvider"

3. Configure PWA in config/laravel-pwa-kit.php:

return [
    'enable_pwa' => true,
    'install-toast-show' => true,
    'livewire-app' => true,
    'manifest' => [
        'name' => env('APP_NAME', 'Laravel'),
        'short_name' => 'LPT',
        'start_url' => '/',
        'theme_color' => '#FF5733',
        'background_color' => '#ffffff',
        'display' => 'standalone',
        'icons' => [
            ['src' => 'logo.png', 'sizes' => '512x512', 'type' => 'image/png']
        ],
    ],
];

4. Include PWA assets in your Blade layout:

{!! PwaKit::head() !!}
{!! PwaKit::scripts() !!}

---

🎉 First Release of Laravel PWA Kit!

Thanks to all early testers and contributors who helped shape this into a fast, reliable, and user-friendly package. 🚀