Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.1.12
Name Modified Size InfoDownloads / 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:

  1. Manifest Specification Gaps in site.webmanifest:
  2. Missing start_url: The W3C specification and Chromium PWA criteria mandate a start_url. Without it, browsers declare the manifest non-installable.
  3. Missing id and scope: The web app lacked a unique manifest ID and explicit scope boundary.
  4. Only Maskable Icons Defined: site.webmanifest specified only purpose: "maskable". Chromium and Android strictly require at least one icon with purpose: "any". When only maskable icons are present, Chromium audits fail the installability criteria.
  5. Divergent Manifest Files: The repository contained both manifest.json and site.webmanifest with mismatched schemas.

  6. Absence of a Registered Service Worker (sw.js):

  7. Modern Chromium-based browsers (Chrome, Edge, Samsung Internet, Brave) will never fire the beforeinstallprompt event or display an install button in the address bar without an active Service Worker containing a fetch event handler.

  8. Missing iOS Apple Web App Meta Tags in index.html:

  9. 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.
  10. No In-App Install Prompt or iOS Guidance:

  11. 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 (with skipWaiting()), activate (with cache eviction and clients.claim()), and network-first fetch routing 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: standalone or navigator.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-btn in the top controls.
  • File Ribbon tool button: #pwa-install-ribbon-btn in 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 with start_url, id, scope, standalone, and dual any/maskable icons.
  • [x] index.html: Added Apple iOS meta tags, valid #007670 theme color, titlebar install button, and File ribbon install button.
  • [x] sw.js: Created standard PWA Service Worker with lifecycle and fetch event handling.
  • [x] extensions/pwa-install.js: Created cross-platform install engine with iOS visual guide, Chromium beforeinstallprompt binding, 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.html and ui/dashboard.js from ?v=5.1.11 to ?v=5.1.12.

πŸŽ‰ Version 5.1.12 - Open Publisher

Source: README.md, updated 2026-09-30