| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| OpenPublisher-5-x86_64.AppImage | 2026-09-30 | 166.4 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-09-30 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-09-30 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-09-30 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-09-30 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-09-30 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-09-30 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-09-30 | 156.2 MB | |
| 5.1.12_ Web App Manifest _ iOS PWA Installation Engine source code.tar.gz | 2026-09-30 | 22.1 MB | |
| 5.1.12_ Web App Manifest _ iOS PWA Installation Engine source code.zip | 2026-09-30 | 22.4 MB | |
| README.md | 2026-09-30 | 8.0 kB | |
| openpublisher5_amd64-freebsd.pkg | 2026-09-30 | 185.5 MB | |
| Totals: 12 Items | 1.7 GB | 0 | |
π Summary
Version 5.1.12 resolves a long-standing issue where Open Publisher could not be installed as a standalone Progressive Web App (PWA) on iOS (iPad/iPhone) and Android/Desktop browsers.
Previously, adding the site to the home screen on iOS opened as a standard Safari browser tab with URL bars rather than a standalone app, and browsers never displayed an in-app "Install Web App" prompt or button. This release provides a fully compliant W3C manifest, native Apple iOS web app meta tags, a lightweight background Service Worker, and a dedicated PWA installation engine that guides users through installing Open Publisher on any device.
π Root Cause Analysis
Investigation revealed four fundamental reasons why web app installation was failing:
- Manifest Specification Gaps in
site.webmanifest: - Missing
start_url: The W3C specification and Chromium PWA criteria mandate astart_url. Without it, browsers declare the manifest non-installable. - Missing
idandscope: The web app lacked a unique manifest ID and explicit scope boundary. - Only Maskable Icons Defined:
site.webmanifestspecified onlypurpose: "maskable". Chromium and Android strictly require at least one icon withpurpose: "any". When only maskable icons are present, Chromium audits fail the installability criteria. -
Divergent Manifest Files: The repository contained both
manifest.jsonandsite.webmanifestwith mismatched schemas. -
Absence of a Registered Service Worker (
sw.js): -
Modern Chromium-based browsers (Chrome, Edge, Samsung Internet, Brave) will never fire the
beforeinstallpromptevent or display an install button in the address bar without an active Service Worker containing afetchevent handler. -
Missing iOS Apple Web App Meta Tags in
index.html: -
iOS Safari does not use
beforeinstallprompt. Instead, it reads Apple-specific meta tags:<meta name="apple-mobile-web-app-capable" content="yes">was missing, causing iOS to treat home screen shortcuts as generic browser bookmarks rather than standalone full-screen web apps.<meta name="apple-mobile-web-app-status-bar-style">and<meta name="apple-mobile-web-app-title">were absent.<meta name="theme-color" content="var(--ui-theme-color)">was invalid: HTML meta tags do not evaluate CSS custom properties (var(...)), causing mobile browsers to ignore the theme color.
-
No In-App Install Prompt or iOS Guidance:
- iOS Safari intentionally omits automatic install banners. To allow users to install directly from the website, client-side detection is required to present an intuitive "Add to Home Screen" walkthrough.
π οΈ Fixes & Implementation Details
1. Compliant W3C Web Manifests (manifest.json & site.webmanifest)
Synchronized both manifest files to standard-compliant W3C definitions:
- Added explicit
"start_url": "./?source=pwa"and"scope": "./". - Set
"id": "openpublisher-pwa"and"display": "standalone". - Defined dual-purpose icons: provided separate entries for both
"purpose": "any"and"purpose": "maskable"across 192x192 and 512x512 resolutions, plus the 180x180 Apple touch icon. - Added descriptive metadata, categories (
productivity,design,office), and theme colors (#007670).
2. Apple & Mobile Meta Tags (index.html)
Overhauled mobile and platform tags in <head>:
<meta name="theme-color" content="#007670">(valid static hex color).<meta name="apple-mobile-web-app-capable" content="yes">(activates standalone app mode on iOS).<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">.<meta name="apple-mobile-web-app-title" content="Open Publisher">.<meta name="mobile-web-app-capable" content="yes">.<link rel="apple-touch-icon" sizes="180x180" href="apple-touch-icon.png">.<link rel="manifest" href="manifest.json">.
3. Lightweight Service Worker (sw.js)
Created a clean background Service Worker fulfilling PWA offline/installability criteria:
- Implemented
install(withskipWaiting()),activate(with cache eviction andclients.claim()), and network-firstfetchrouting with cache fallback.
4. PWA Installation Engine (extensions/pwa-install.js)
Added a responsive installation manager on window.PwaInstallSystem:
- Desktop Wrapper Isolation: Automatically detects native desktop wrapper environments (NW.js / Electron / Desktop IPC) and safely suppresses PWA prompts so desktop app users are never prompted to install.
- Standalone Mode Detection: Detects if Open Publisher is already running in standalone mode (
display-mode: standaloneornavigator.standalone === true) and hides install controls. - Chromium Native Flow: Listens for
beforeinstallprompt, reveals in-app install buttons, and triggers the native install dialog when clicked. - iOS Safari Guide Modal: When clicked on iOS Safari, displays a step-by-step visual dialog showing how to tap the Share button (), scroll to Add to Home Screen (), and tap Add.
- Mobile Floating Banner: On mobile screens (iOS/Android), displays a discreet floating installation card at the bottom of the screen with a 7-day dismissal cooldown.
- Integrated UI Triggers:
- Titlebar quick-access button:
#pwa-install-btnin the top controls. - File Ribbon tool button:
#pwa-install-ribbon-btnin the Share & App group.
5. Official V5 Web App Branding & Icons
- Updated web app icon assets (
apple-touch-icon.png,web-app-manifest-192x192.png,web-app-manifest-512x512.png, and favicons) to match the official Open Publisher V5 application design, ensuring installed PWAs render the modern V5 branding on mobile home screens, docks, and task switchers.
π§ͺ Verification & Automated Testing
All updates were validated with an automated Playwright test suite (scratch/test_pwa_install.py):
| Test / Check | Target | Result | Details |
|---|---|---|---|
| Manifest Schema Validation | manifest.json & site.webmanifest |
Passed | Verified name, start_url, id, display, and any/maskable 192px/512px icon purposes |
| Service Worker Syntax | sw.js |
Passed | Clean JavaScript execution, verified fetch handler |
| Apple iOS Meta Tags | index.html |
Passed | Verified apple-mobile-web-app-capable, status-bar-style, title, and valid #007670 theme color |
| PwaInstallSystem Init | extensions/pwa-install.js |
Passed | Initialized cleanly on window without console errors |
| iOS Step-by-Step Modal | PwaInstallSystem.showIOSModal() |
Passed | Renders dialog box with Safari Share and Add to Home Screen instructions |
| Install Prompt Response | beforeinstallprompt event |
Passed | Event capture successfully reveals #pwa-install-btn and UI controls |
β Checklist Completed
- [x]
manifest.json&site.webmanifest: Overhauled both manifests withstart_url,id,scope,standalone, and dualany/maskableicons. - [x]
index.html: Added Apple iOS meta tags, valid#007670theme color, titlebar install button, and File ribbon install button. - [x]
sw.js: Created standard PWA Service Worker with lifecycle andfetchevent handling. - [x]
extensions/pwa-install.js: Created cross-platform install engine with iOS visual guide, Chromiumbeforeinstallpromptbinding, and desktop wrapper isolation. - [x] Web App Icons: Updated web app icons (
apple-touch-icon.png,web-app-manifest-192x192.png,web-app-manifest-512x512.png) to match official V5 branding. - [x] Cachebuster Bump: Bumped all script, stylesheet, and asset cachebusters across
index.htmlandui/dashboard.jsfrom?v=5.1.11to?v=5.1.12.
π Version 5.1.12 - Open Publisher