Repository navigation
Releases
Release v1.16.0
v1.16.0
Changelog
Identifier-keyed push subscription port (REQ-ARCH-001 rule 3). No change is required: an existing
PushSubscriptionProviderInterface keeps working. See UPGRADING.
Added
PushRecipientSubscriptionProviderInterface(findRecipientSubscriptions(string $userIdentifier),
removeRecipientSubscription(string $userIdentifier, PushSubscriptionData)): the push test endpoint looks
subscriptions up by the authenticated user's identifier, with no Symfony security type in the port. It is preferred
when the host defines it (also when the same class implements the old port).- Internal
LegacyPushSubscriptionProviderAdapter(wired byPushSubscriptionProviderPass) bridges a host
PushSubscriptionProviderInterface: it only answers for the user of the current security token and passes that same
user object, so recipients are exactly those of 1.15 and a push never reaches another user's devices.
Deprecated
PushSubscriptionProviderInterface(keyed bySymfony\Component\Security\Core\User\UserInterface), removed in
2.0. ImplementPushRecipientSubscriptionProviderInterfaceinstead; a deprecation is triggered when the adapter is
built.
Tests
- Equivalence of the old and new ports (
PushRecipientPortEquivalenceTest: same responses, sent endpoints and
removals per scenario, users alternating on one controller), adapter tests, and a DDD host kernel test
(DddHostPushTest: XML-mapped host entity on a dedicated entity manager, user referenced by id, only the new port;
1,500 requests alternating alice, bob and a guest on one kernel withoutservices_resetter, flat memory).
Documentation
- USAGE: "Standard Symfony host" and "DDD / hexagonal host" sections; examples use the new port.
- USAGE: new section "Using it from a DDD / hexagonal application" (where the bundle sits in a hexagonal host, the ports, events and DTOs to build an anti-corruption layer on, and the known limitations).
What's Changed
- chore(deps): bump the phpstan group with 2 updates by @dependabot[bot] in #67
- chore(deps): Dependabot batch 2026-11-09 by @HecFranco in #72
- ci: run the PR title check on pull_request by @HecFranco in #74
- docs: using it from a DDD / hexagonal application by @HecFranco in #73
- ci: run the igor worker-state audit by @HecFranco in #75
- feat(webpush): identifier-keyed push subscription port (REQ-ARCH-001) by @HecFranco in #76
Full Changelog: v1.15.0...v1.16.0
Release v1.15.0
v1.15.0
Changelog
Optional brand consumer (spec 220 S4). No change for hosts without a nowo-tech/brand-contracts brand provider. See
UPGRADING.
Added
- Brand from a
BrandProviderInterfaceservice (nowo-tech/brand-contracts^1.0, optional): when the app has a
brand provider (InstanceSettingsBundle's opt-in brand bridge, or a small host class), the manifest and the head tags
read the brand. Thenowo_pwaconfiguration stays the fallback for everything the brand does not give, and for
everything when there is no provider or the provider fails (the error is logged, the manifest and the page never
fail because of the brand).- Manifest (new
BrandManifestOverlayProvider, tagnowo_pwa.manifest_overlay_provider, priority 1024, so host
overlays still run after it):theme_colorfrom the lightprimary,background_colorfrom the lightpaper,
andiconsfrom theapp_iconslot (after the contract's fallback chain to a squaremarkof 512 px or more)
when it is PNG, JPEG or WebP, square and at least 192 px: oneanyentry and, for anapp_iconof 512 px or
more, onemaskableentry. SVG, ICO and other images are never used as icons; the configuredmanifest.icons
then stay.nameandshort_namecome from the brand only when it is not the default brand (Beacon's rule),
unlessbrand.override_name: true. - Head (
nowo_pwa_head()and the context of the install prompt and links): the twotheme-colormeta tags from
the light and darkpaper, the same manifest values, the Apple title from the brand short name when the name
applies, the brand icon asapple-touch-iconwhere the configuration declares one, and the manifest URL with
?v=<Brand::$version>, so browsers fetch the new manifest as soon as the brand changes. - Manifest HTTP cache: with a brand, the response carries an
ETagbuilt fromBrand::$versionand a hash of the
body, and a matchingIf-None-Matchgets a304.Cache-Controlis unchanged.
- Manifest (new
nowo_pwa.brand:mode: auto(default) oroff,override_name: false(default).brand: offis accepted as a
shorthand.nowo-tech/brand-contractsinrequire-devandsuggest, with aconflicton<1.0 || >=2.0.
Security
- The brand values reach the manifest only through
JsonResponse's escaping (<,>,&, quotes as\u00XX) and the
head only through Twig auto-escaping; colours are#rrggbb(contract-checked); icon URLs are re-checked with
BrandAsset::isSafeUrl()(root-relative orhttps://only); only raster icons are used. Audited: Appendix IU,
Pass-Low. IU-L2: the icons use the full-size original upload until BrandContracts 1.1 adds variant URLs; IU-I6 / IU-I7
(overlay scope and per-session providers) are documented in USAGE and SECURITY.
What's Changed
- feat(brand): optional brand-contracts consumer for the manifest and head tags (spec 220 S4) by @HecFranco in #66
Full Changelog: v1.14.1...v1.15.0
Release v1.14.1
v1.14.1
Changelog
"Not now" works in the modal install prompt (HC-L1).
Fixed
- Install prompt,
display: modal: the "Not now" button now stores the dismissal and closes the prompt. Every element with an install action is bound, not only the first one; in modal mode the backdrop came first and took the onlydismiss-remindlistener (audit HC-L1, Low, since 1.1.0).pwa.jsrebuilt. No change inbannerorflashmode, nor in the markup.
Security
- HC-L1 fix. Audited: Appendix IE, Pass (good) / Info.
What's Changed
- fix(install-prompt): Not now works in modal mode (HC-L1) by @HecFranco in #65
Full Changelog: v1.14.0...v1.14.1
Release v1.14.0
v1.14.0
Changelog
Changed
- Install prompt motion: the banner, flash and modal displays open and close on UiKit's
--nowo-ui-motion-medium*,--nowo-ui-motion-scaleand easing tokens (own fallbacks: 200 ms in, 150 ms out, scale 0.98). The close waits for the fade beforehidden, with a timer iftransitionendnever fires. Reduced motion keeps an 80 ms fade with no movement;html[data-motion="full"]keeps the full effect. No!important. - Turbo: running fades finish on
turbo:before-cache, so that a cached page never holds a half-closed surface. Install prompt: audit finding HW-L5.
What's Changed
- feat(motion): install prompt opens and closes on the motion tokens by @HecFranco in #64
Full Changelog: v1.13.0...v1.14.0
Release v1.13.0
v1.13.0
Changelog
Host control of the install prompt buttons and more pwa.css tokens. No change for hosts that change nothing. The
service worker, the manifest and what they cache are untouched. See UPGRADING.
Added
nowo_pwa.install_prompt.button_paint(kitby default, orhost): withhostthe install prompt buttons carry
only the UiKit slot classes andpwa.cssdoes not paint them, so host button classes win without specificity
overrides. The actions wrapper is__actions-hostin that mode.pwa.csstokens for values that were hard-coded:--nowo-pwa-install-z-index,-banner-max-width,
-banner-inset-x,-banner-offset-bottom,-banner-offset-top,-flash-max-width,-modal-padding,
-modal-panel-padding,-eyebrow-font-weight,-eyebrow-letter-spacing,-title-line-height,
-button-border-color,--nowo-pwa-install-links-font-size,-links-font-weight,-links-line-height. Their
defaults are the previous values.
Documentation
src/push-checks.tsis declared a public entry covered by semver, with a test that pins its exports.
Security
- REQ-SEC-004 audit: Pass (good) / Low (2026-11-06). No advisory needed. The service worker, the manifest, their scope and their cache rules did not change.
- Known issue, also in 1.12.0: with
install_prompt.display: modalthe "Not now" button has no effect; "Don't ask again" and a backdrop click work. A fix follows in a patch release.
What's Changed
- chore(deps): bump the phpstan group across 1 directory with 2 updates by @dependabot[bot] in #61
- chore(deps): bump nowo-tech/ui-kit-bundle from 2.17.2 to 2.17.5 by @dependabot[bot] in #60
- chore(deps): Symfony security release 2026-11-04 by @HecFranco in #62
- feat(install-prompt): host button paint option and more pwa.css tokens by @HecFranco in #63
Full Changelog: v1.12.0...v1.13.0
Release v1.12.0
v1.12.0
Changelog
Bundle-level HTTP timeouts on Web Push deliveries (REQ-RUNTIME-001). See UPGRADING.
Added
nowo_pwa.web_push.timeout(default5.0s, total) andnowo_pwa.web_push.connect_timeout(default3.0s,
connect / inactivity): bundle-level deadlines on every Web Push delivery (REQ-RUNTIME-001). A host Symfony
Psr18Clientis kept and cloned with these deadlines; without a host client the bundle builds a Symfony
Psr18Clientwith them (whensymfony/http-clientis installed); other PSR-18 clients are used as-is.WebPushHttpClientFactory(resolves the PSR-18 client with the deadlines) and a timeout test against an
unresponsive local socket.
Fixed
- A push service that sends headers and then stalls the body is now reported as a failed delivery instead of a
SymfonyTransportExceptionescapingMinishlinkWebPushSender::send().
What's Changed
- chore(deps): bump nowo-tech/ui-kit-bundle from 2.6.1 to 2.7.0 by @dependabot[bot] in #55
- chore(deps): bump vite from 8.3.4 to 8.3.5 by @dependabot[bot] in #56
- feat(web-push): bundle-level HTTP timeouts on push deliveries (REQ-RUNTIME-001) by @HecFranco in #57
Full Changelog: v1.11.0...v1.12.0
Release v1.11.0
Release v1.11.0
release-check: OK 1753783
Changelog
Added
nowo_pwa.install_prompt.mark_template: a Twig template included as the install prompt's brand mark (for example an
inline SVG that follows the site theme), so a host no longer overridespwa/install_prompt.html.twigfor it; wins
overmark_asset.
Full Changelog: v1.10.2...v1.11.0
Release v1.10.2
v1.10.2
Changelog
Controllers in coverage scope, translation key parity, Web Push timeout docs, demo smoke fixes. See UPGRADING.
Changed
- Controllers are part of the PHPUnit coverage scope again (
src/Controllerno longer excluded); new tests for the disabled-feature guards and cacheable manifest responses keep lines at 100% (REQ-TEST-003). validate-translationschecks key parity across the shipped locales (REQ-MAKE-004).- Docs: Web Push HTTP timeout guidance (REQ-RUNTIME-001), documented route-loader exception to attribute routes (REQ-SF-004), PSR evaluation updated for the Web Push sender (PSR-3, PSR-7/17, PSR-18) (REQ-CS-007).
- Demo DNS block commented (REQ-DEMO-009); new
Demo smokeworkflow (tags, weekly, manual) (REQ-TEST-011).
Fixed
.scripts/check-no-cursor-coauthor.shalso runs inside git worktrees (.gitfile instead of directory).- Demo
make upinstalls Composer dependencies in a one-off container before FrankenPHP starts (a fresh checkout crash-looped the worker on the missingvendor/, somake demo-smokefailed). - Pending Rector code-quality suggestions applied (
PwaControlleroffline URL concatenation,PwaRouteTargetinglegacy pattern check) sorector-dryis clean again.
Full Changelog: v1.10.1...v1.10.2
Release v1.10.1
v1.10.1
Changelog
Dependency refresh (bundle and demos), php-cs-fixer ParallelConfig(2). See UPGRADING.
Changed
- Dependencies refreshed (Composer and pnpm/npm lock files of the bundle and its demos, campaign 2026-10-19); shipped assets rebuilt.
.php-cs-fixer.dist.php:new ParallelConfig(2)(REQ-CS-001).- Documentation: wave-1 REQ compliance — README standard badge line (order, Symfony 7.4 | 8.0 | 8.1+, Coverage badge), canonical FrankenPHP claim line and documentation list order, CONTRIBUTING Cursor Agent settings and post-release-commit trailer check, CODEOWNERS header and canonical bug-report template, demo
.env.examplecomments, doc TOCs, Spec Kit inventory refresh (64/64).
What's Changed
- chore(deps): bump jsdom from 30.1.2 to 30.1.3 by @dependabot[bot] in #53
- chore(deps): bump nowo-tech/phpstan-frankenphp from 1.2.3 to 1.3.0 by @dependabot[bot] in #54
Full Changelog: v1.10.0...v1.10.1
Release v1.10.0
v1.10.0
Changelog
Install prompt and offline page on the UiKit 2.2 page contract (REQ-UI-003): theme slots, one-block @!NowoPwaBundle overrides (namespace now registered), self-contained offline status page; show_never_option: false honoured. See UPGRADING.
Added
- UiKit page contract (REQ-UI-003) — requires
nowo-tech/ui-kit-bundle^2.2. The install prompt, install links
and push diagnostics read the UiKit theme slots ofNowoPwaBundle(card,card_title,card_intro,muted,
toolbar,btn_primary,btn_secondary,btn_link,btn_sm;nowo_ui_attrs('card' | 'toolbar')), so a host
themes them once innowo_ui_kit.theme(ortheme.bundles.NowoPwaBundle). Widget roots carry
data-nowo-ui-bundle="NowoPwaBundle"(per-bundle tokens) anddata-testid="pwa-install-prompt". - Install prompt blocks for one-block
@!overrides:pwa_install_backdrop,pwa_install_panel,pwa_install_text,
pwa_install_message,pwa_install_button_install,pwa_install_button_remind,pwa_install_button_never
(existing:pwa_install_mark,pwa_install_eyebrow,pwa_install_title,pwa_install_actions); install links:
pwa_install_link,pwa_uninstall_link. nowo_pwa.web_ui.templates.{head,install_prompt,install_links,offline}andnowo_pwa.web_ui.layout_template
(layout of the offline page;null=@NowoUiKit/layout/status.html.twig).Nowo\PwaBundle\View\OfflinePage::create()— the offline page view model (UiKitAuthPage).docs/TEMPLATES.md; contract test (PageContractTestCase) and widget tests with a stub theme.- Demo: UiKit document layout with a host theme (tokens + class map), a one-block install prompt override, Playwright
e2e (make -C demo/symfony8 test-e2e) and README screenshots (make -C demo/symfony8 demo-screenshots, REQ-DEMO-013).
Changed
- Offline page (
pwa/offline.html.twig): renders on the self-contained UiKit status layout (inline critical CSS
with the request CSP nonce, theme tokens, no stylesheet / script request) with thepage/authpanel regions and
slots; the 1.x standalone page (dark--nowo-pwa-offline-*palette) moved topwa/offline_standalone.html.twig. pwa.css: the--nowo-pwa-install-*tokens fall back to the UiKit--nowo-ui-*tokens (surface, text, muted, border,
radius, primary); the panel (not the root) is the painted surface;[hidden]always hides the prompt.- Install prompt markup: eyebrow / title / message wrapped in
.nowo-pwa-install__text;aria-describedbyon the root.
Deprecated
nowo_pwa.templates.*→nowo_pwa.web_ui.templates.*.nowo_pwa.install_prompt.button_class/dismiss_button_class/never_button_class→ UiKit theme slots
btn_primary/btn_secondary/btn_link(nowo_ui_kit.theme.bundles.NowoPwaBundle.classes.*). Still applied
when set.pwa/offline_standalone.html.twig(1.x offline page, opt-in).
Fixed
@!NowoPwaBundle/…is now registered (the bundle templates without the app overrides), so a host override can extend
the bundle template and redefine one block instead of copying the file.install_prompt.show_never_option: falsehides the "Don't ask again" button (the Twigdefaultfilter turned
falseintotrue).
Full Changelog: v1.9.1...v1.10.0