README

⭐ Found this useful? Give it a star on GitHub so more developers can find it.

Turn any Symfony application into a Progressive Web App with a fully configurable manifest, service worker, offline page, and install prompt — no vendor lock-in, no hardcoded assets.

This bundle is FrankenPHP worker mode friendly.

This includes running when the kernel is not rebooted between requests (reset_kernel false); see FrankenPHP worker audit.

Install prompt open over the demo page, themed by the host UiKit tokens and slots

_{Install prompt — host UiKit theme, brand mark from a one-block override}

Offline fallback page on the self-contained UiKit status layout

_{Offline fallback — self-contained status page cached by the service worker}

Features

Web App Manifest generated from nowo_pwa.yaml (name, icons, shortcuts, theme, display mode, scope, start URL)
Manifest overlay — implement ManifestOverlayProviderInterface (tag nowo_pwa.manifest_overlay_provider, autoconfigured) to overlay brand/colors onto the manifest
Service worker with configurable cache strategy (network-first, cache-first, stale-while-revalidate), precache URLs, and offline fallback
Twig helpers nowo_pwa_head(), nowo_pwa_install_prompt(), nowo_pwa_install_links(), and nowo_pwa_enabled() with route targeting (all / only / except, route names or URL paths)
Web Profiler panel nowo_pwa (manifest/SW status in debug)
Install prompt modes — banner, flash (inline), or modal; dismiss remind / never-ask-again options
UiKit page contract (REQ-UI-003, nowo-tech/ui-kit-bundle ^2.2) — widgets on UiKit theme slots and tokens, offline page on the self-contained UiKit status layout (templates)
Override-friendly Twig templates with install/offline blocks (@!NowoPwaBundle one-block overrides), bundled pwa.css tokens, and translations (en, es, fr, it, pt, de, nl; REQ-TWIG-001 / REQ-I18N-001)
TypeScript client for SW registration and install banner (Vite build → pwa.js)
Web Push (optional) — WebPushSenderInterface (minishlink/web-push 11, VAPID, anti-SSRF endpoint guard), dependency checks at compile time, and an opt-in CSRF-protected test notification endpoint (nowo_pwa_push_test)
Push diagnostics — push-checks.ts + Stimulus peer push-diagnostics + partial pwa/push_diagnostics.html.twig (per-step checklist: support, VAPID, permission, service worker, subscription/key match, server copy)
Browser hints — Stimulus peer browser-hint + partials pwa/browser_hint.html.twig / pwa/browser_guide.html.twig (per-browser install + push help)
Works with Symfony 7.4+ and 8.x; no database required

Installation

composer require nowo-tech/pwa-bundle

# config/packages/nowo_pwa.yaml
nowo_pwa:
    manifest:
        name: 'My Application'
        short_name: MyApp
        theme_color: '#0f172a'
        icons:
            - { src: '/icons/icon-192.png', sizes: '192x192', type: image/png }
            - { src: '/icons/icon-512.png', sizes: '512x512', type: image/png }
    service_worker:
        precache_urls: ['/', '/offline']
        offline_url: '/offline'

In your base layout:

<head>
    {{ nowo_pwa_head() }}
</head>
<body>
    {% block body %}{% endblock %}
    {{ nowo_pwa_install_prompt() }}
    {{ nowo_pwa_install_links() }}
</body>

See Installation and Configuration.

Documentation

Additional documentation

Tests and coverage

PHP: 100% (composer test-coverage-100 enforces --min-percent=100)
TS/JS: 100% (Vitest thresholds in vitest.config.ts)

make test
make test-ts
make test-coverage
make release-check   # includes demo healthcheck on port 8025

Playwright end-to-end tests and the README screenshots (WebP under docs/images/demo/): make -C demo/symfony8 test-e2e and make -C demo/symfony8 demo-screenshots (REQ-DEMO-013).

License

MIT — see LICENSE.

nowo-tech / pwa-bundle

Package info

Security

Fund package maintenance!

Statistics