PHPackages                             nowo-tech/pwa-bundle - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. nowo-tech/pwa-bundle

ActiveSymfony-bundle[Utility & Helpers](/categories/utility)

nowo-tech/pwa-bundle
====================

Symfony bundle to turn any application into a fully configurable Progressive Web App (manifest, service worker, offline, install prompt)

v1.3.0(2w ago)0362MITPHPPHP >=8.2 <8.6CI passing

Since Jul 5Pushed 1w agoCompare

[ Source](https://github.com/nowo-tech/PwaBundle)[ Packagist](https://packagist.org/packages/nowo-tech/pwa-bundle)[ Docs](https://github.com/nowo-tech/PwaBundle)[ GitHub Sponsors](https://github.com/HecFranco)[ RSS](/packages/nowo-tech-pwa-bundle/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (9)Dependencies (38)Versions (12)Used By (0)

PWA Bundle
==========

[](#pwa-bundle)

[![CI](https://github.com/nowo-tech/PwaBundle/actions/workflows/ci.yml/badge.svg)](https://github.com/nowo-tech/PwaBundle/actions/workflows/ci.yml) [![codecov](https://camo.githubusercontent.com/e5f8d10930556410313913a4dc2360c73e5142d4075aa5e9b58b7e10e6e15c22/68747470733a2f2f636f6465636f762e696f2f67682f6e6f776f2d746563682f50776142756e646c652f67726170682f62616467652e737667)](https://codecov.io/gh/nowo-tech/PwaBundle) [![Packagist Version](https://camo.githubusercontent.com/657abeadc022b9dd1148429a87a501841e1822cff39cee7132508379082f00cc/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6e6f776f2d746563682f7077612d62756e646c652e7376673f7374796c653d666c6174)](https://packagist.org/packages/nowo-tech/pwa-bundle) [![Packagist Downloads](https://camo.githubusercontent.com/33dd5df1741783f58ef007852aa5c21c488ed3fdf8c9edde1135c2e2c60d6147/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6e6f776f2d746563682f7077612d62756e646c652e737667)](https://packagist.org/packages/nowo-tech/pwa-bundle) [![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](LICENSE) [![PHP](https://camo.githubusercontent.com/3f99b197569aa2dcfbefff17ecc68d74098e7f929d8b52dc40f3a898f740eae1/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870)](https://php.net) [![Symfony](https://camo.githubusercontent.com/d1d79515b840c074d19d41fa43744eef2c666cb55b757f7f2ff71e50555cfeb8/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f53796d666f6e792d372e34253242253230253743253230382e302532422d3030303030303f6c6f676f3d73796d666f6e79)](https://symfony.com) [![GitHub stars](https://camo.githubusercontent.com/eb57fb4b1a8f23319bfcfaa6702dbdaddb321ca6aa108f4b0f0e9de367abad8a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6e6f776f2d746563682f50776142756e646c652e7376673f7374796c653d736f6369616c266c6162656c3d53746172)](https://github.com/nowo-tech/PwaBundle)

> ⭐ **Found this useful?** Give it a **star** on [GitHub](https://github.com/nowo-tech/PwaBundle) 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.

[![FrankenPHP Friendly Worker Mode](docs/images/frankenphp-friendly.png)](docs/images/frankenphp-friendly.png)

This bundle is **FrankenPHP worker mode friendly**.

Features
--------

[](#features)

- **Web App Manifest** generated from `nowo_pwa.yaml` (name, icons, shortcuts, theme, display mode, scope, start URL)
- **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()`, and `nowo_pwa_install_links()` with route targeting (`all` / `only` / `except`, route names or URL paths)
- **Install prompt modes** — `banner`, `flash` (inline), or `modal`; dismiss remind / never-ask-again options
- **Override-friendly** Twig templates with install/offline blocks, 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`)
- Works with Symfony **7.4+** and **8.x**; no database required

Installation
------------

[](#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:

```

    {{ nowo_pwa_head() }}

    {% block body %}{% endblock %}
    {{ nowo_pwa_install_prompt() }}
    {{ nowo_pwa_install_links() }}

```

See [Installation](docs/INSTALLATION.md) and [Configuration](docs/CONFIGURATION.md).

Documentation
-------------

[](#documentation)

- [GitHub Actions CI requirements](docs/GITHUB_CI.md)
- [Installation](docs/INSTALLATION.md)
- [Configuration](docs/CONFIGURATION.md)
- [Usage](docs/USAGE.md)
- [Contributing](docs/CONTRIBUTING.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Changelog](docs/CHANGELOG.md)
- [Upgrading](docs/UPGRADING.md)
- [Release process](docs/RELEASE.md)
- [Security](docs/SECURITY.md)
- [Engram](docs/ENGRAM.md)
- [Spec-driven development](docs/SPEC-DRIVEN-DEVELOPMENT.md)
- [GitHub Spec Kit](docs/SPEC-KIT.md)

### Additional documentation

[](#additional-documentation)

- [Demo with FrankenPHP](docs/DEMO-FRANKENPHP.md)

Tests and coverage
------------------

[](#tests-and-coverage)

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

License
-------

[](#license)

MIT — see [LICENSE](LICENSE).

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance97

Actively maintained with recent releases

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 52.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

9

Last Release

18d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7947bfc3f2ce9574a18a2c60f3d95b5d1b0740e65dc929332c92f1df21f75ab?d=identicon)[HecFranco](/maintainers/HecFranco)

---

Top Contributors

[![HecFranco](https://avatars.githubusercontent.com/u/24323276?v=4)](https://github.com/HecFranco "HecFranco (27 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (18 commits)")[![actions-user](https://avatars.githubusercontent.com/u/65916846?v=4)](https://github.com/actions-user "actions-user (6 commits)")

---

Tags

frankenphpphpprogressive-web-apppwaservice-workersymfonysymfony-bundlephpsymfonySymfony Bundleofflinepwaservice workerProgressive Web Appweb-app-manifest

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/nowo-tech-pwa-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/nowo-tech-pwa-bundle/health.svg)](https://phpackages.com/packages/nowo-tech-pwa-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k18.3M430](/packages/easycorp-easyadmin-bundle)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k6.0M780](/packages/sylius-sylius)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k3.9M536](/packages/pimcore-pimcore)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.8M682](/packages/shopware-core)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1617.3k16](/packages/2lenet-crudit-bundle)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)