Download Latest Version openpublisher5g_amd64-windows.exe (81.1 MB)
Home / 5.6.0
Name Modified Size InfoDownloads / Week
Parent folder
OpenPublisher-5-x86_64.AppImage 2026-10-08 166.4 MB
openpublisher5_amd64-windows-portable.exe 2026-10-08 183.2 MB
openpublisher5_amd64-windows.exe 2026-10-08 165.2 MB
openpublisher5_amd64-macos.dmg 2026-10-08 233.1 MB
openpublisher5_amd64-linux.run 2026-10-08 193.4 MB
openpublisher5_amd64-linux.rpm 2026-10-08 215.4 MB
openpublisher5_amd64-linux.flatpak 2026-10-08 153.6 MB
openpublisher5_amd64-linux.deb 2026-10-08 156.2 MB
5.6.0_ Perfect Previews _ Multi-Page Theme Isolation source code.tar.gz 2026-10-08 22.5 MB
5.6.0_ Perfect Previews _ Multi-Page Theme Isolation source code.zip 2026-10-08 22.7 MB
README.md 2026-10-08 11.2 kB
openpublisher5_amd64-freebsd.pkg 2026-10-07 185.5 MB
Totals: 12 Items   1.7 GB 0

🚀 Summary

Version 5.6.0 of Open Publisher introduces yet another architectural overhaul, this time to the page preview and thumbnail system in the sidebar, permanently resolving long-standing fragility where thumbnails would blank out to solid white, swap visual contents with other pages, fail to show background themes, or duplicate invisible elements during page transitions.

Previous attempts to stabilize the sidebar previews patched around a legacy overlay workaround rather than diagnosing the conflicting rendering engines, global query selectors, and serialization boundaries beneath it. In v5.6.0, the entire thumbnail pipeline is unified into a native, high-performance DOM scaling architecture with strict per-page styling isolation.

Key enhancements in this release:

  • Native DOM Thumbnail Engine: renderThumbnailHTML in core/pages.js now natively renders every page's background theme directly from pageData.themeSettings, including solid colors, linear gradients, texture images with opacity, and computed CSS filters (saturation, brightness, contrast, hue rotation).
  • Per-Page Theme Studio Slider Isolation: Live slider adjustments in the Theme Studio (Hue Shift, Saturation, Brightness, Contrast, Texture Opacity, Pattern Zoom) are now strictly scoped to the active canvas and the active page's thumbnail, completely eliminating global filter leakage onto other page previews.
  • Decommissioned Glass Vault Minimap: Completely removed the obsolete #ts-overlay-wrapper and .ts-glass-panel overlay subsystem, eliminating a 60 FPS position tracker loop and an 800ms DOM cloning interval that was causing cross-page thumbnail swapping and visual desynchronization.
  • Clean Theme vs. Content Serialization Boundary: serializeCurrentPage() in core/history.js now strictly isolates background theme styling into p.themeSettings and prevents theme wrappers or empty ghost boxes from polluting p.elements.
  • Ghost Box & Element Sanitization: Page restoration now automatically filters out legacy empty boxes and orphaned theme containers from older save states, eliminating element accumulation across page roundtrips.
  • Real-Time Thumbnail Synchronization: pushHistory() immediately triggers generateThumbnail(state.currentPageIndex), ensuring that swatch picks, slider adjustments, and element additions update the active thumbnail instantly.
  • Comprehensive Cachebuster Synchronization: Synchronized all asset queries in index.html, Service Worker cache (open-publisher-v5-6-0), and subsystem headers to v5.6.0.

🎨 Architecture Overhaul: Native Scaled Previews

In earlier versions, OpenPublisher relied on a floating DOM overlay ("Glass Vault Minimap") to mirror canvas elements into floating panels positioned over the sidebar. This system had a single locked index and actively cleared non-active panels, causing severe thumbnail swapping and whiteouts whenever pages were added or switched.

In v5.6.0, OpenPublisher transitions entirely to a pure CSS-scaled native DOM thumbnail engine:

  1. Independent Thumbnail Trees: Every page in the sidebar renders as its own lightweight DOM subtree inside .page-thumb, scaled smoothly using CSS transform: scale(...).
  2. True Theme Parity: Every thumbnail independently renders its own gradient, texture overlay, and computed CSS filters without needing to clone or query the active #paper canvas.
  3. Instant Responsiveness: Previews update immediately without base64 conversions, image captures, or requestAnimationFrame loops.
  4. Infinite Page Scaling: Whether a publication contains 2 pages or 50 pages, each thumbnail accurately and independently displays its unique theme and content.

🔍 Problems Solved & Technical Enhancements

1. Conflicting "Glass Vault Minimap" Overlay and Thumbnail Swapping

  • Root Cause: In version 4.3.0, a floating DOM overlay (#ts-overlay-wrapper with .ts-glass-panel divs) was mounted directly to document.body at z-index: 90 to mirror canvas dragging. An 800ms setInterval (buildMap) cleared all non-active panels (inner.innerHTML = '') and cloned #paper exclusively into the panel matching a single lockedIndex. When navigating between pages or adding new pages, lockedIndex desynchronized from state.currentPageIndex, cloning the active page's contents into the wrong sidebar slot and leaving other thumbnails blank.
  • Solution in v5.6.0: Completely decommissioned #ts-overlay-wrapper and .ts-glass-panel in extensions/legacy-fixes.js and style.css. Removed the 60 FPS animation loop and the 800ms cloning interval. All previews now render as standard, lightweight DOM nodes directly within #sidebar.

2. Live Theme Studio Slider Leakage Across Page Previews

  • Root Cause: In extensions/theme-studio.js, updateLiveFilters() queried elements document-wide using document.querySelectorAll('.op-theme-container') and document.querySelectorAll('.op-theme-tex'). Because native thumbnails in the sidebar each contain .op-theme-container, moving any slider (such as pulling Saturation to 0% for black and white) broadcast the CSS filter to every thumbnail in the application.
  • Solution in v5.6.0: Scoped DOM updates in updateLiveFilters() strictly to the active canvas (paper.querySelectorAll(...)) and exclusively to the active page's thumbnail (#thumb-[state.currentPageIndex]). Inactive thumbnails remain completely untouched at their respective saved settings.

3. Capturing Mouse Stealth Stripping Theme Element Classes

  • Root Cause: In extensions/legacy-fixes.js, stealthBackgrounds attached a capturing mousedown listener to window that stripped the pub-element class from all [data-is-theme="true"] nodes. When clicking a sidebar thumbnail to switch pages, mousedown fired first and stripped pub-element. Next, switchPage() ran serializeCurrentPage(), which selected paper.querySelectorAll('.pub-element:not(.master-page-element)'). Because pub-element was stripped, the theme element was lost from the page model.
  • Solution in v5.6.0: Neutralized destructive class stripping in stealthBackgrounds, scoping selection suppression to harmless class management without stripping pub-element.

4. Missing Native themeSettings in Thumbnail Rendering

  • Root Cause: renderThumbnailHTML() in core/pages.js only checked pageData.background || '#ffffff' and then looped through pageData.elements. Because theme attributes (colors, gradients, textures, filters) are stored in pageData.themeSettings, any time a page was inactive or stealthed, the thumbnail fell back to #ffffff, rendering as a blank white rectangle.
  • Solution in v5.6.0: Updated renderThumbnailHTML to natively read pageData.themeSettings. It builds the solid/gradient background div, attaches the texture image with configurable opacity, and applies the computed CSS filter directly onto the thumbnail container.

5. Ghost Box Duplication and Element Roundtrip Accumulation

  • Root Cause: On page roundtrips, restoreThemeFromSave() recreated theme wrappers on #paper. Because elements were serialized as generic boxes without distinguishing theme wrappers from user objects, repeated page transitions accumulated empty box elements ({'type': 'box', 'inner': ''}) in state.pages[i].elements.
  • Solution in v5.6.0: serializeCurrentPage() in core/history.js now strictly filters out theme wrappers and ghost boxes from p.elements. In addition, renderPage() in core/pages.js automatically sanitizes incoming elements, filtering out legacy ghost boxes from older publications.

📁 Files Modified

File Changes
core/pages.js Updated renderThumbnailHTML() to natively render solid, gradient, and textured themeSettings with CSS filters. Added master page thumbnail support. Sanitized renderPage() to filter out legacy ghost boxes. Guarded updateThumbnails() to safely serialize before generation.
core/history.js Updated serializeCurrentPage() to strictly exclude theme wrapper elements and empty ghost boxes from p.elements, preserving them cleanly in p.themeSettings. Updated pushHistory() to immediately trigger generateThumbnail().
extensions/legacy-fixes.js Decommissioned obsolete Glass Vault Minimap overlay and removed its 60 FPS position tracker and 800ms cloning interval. Scoped passive background defenders strictly to #paper and removed destructive pub-element class stripping.
extensions/theme-studio.js Scoped updateLiveFilters() strictly to active #paper and the active page thumbnail (#thumb-[index]), preventing live slider filter leakage to other page previews. Added container deduplication in restoreThemeFromSave().
extensions/ui-interactions.js Updated debounced window.updateThumbnails to serialize active page state before generating thumbnails.
style.css Neutralized #ts-overlay-wrapper and .ts-glass-panel rules. Updated version headers to v5.6.0.
sw.js Bumped Service Worker version and cache name to open-publisher-v5-6-0.
index.html Updated all 82 script, stylesheet, worker, and asset cachebuster queries to ?v=5.6.0.
ui/dashboard.js Bumped template index and template file fetch queries to ?v=5.6.0.
ui/sidebar-context.js Updated header comment to v5.6.0.
ui/modals/options-modal.js Updated header comment to v5.6.0.
tools/proofing/spellcheck-engine.js Updated engine header docstring to v5.6.0.

✅ Complete v5.6.0 Feature & Verification Checklist

  • [x] Native Scaled Previews: Sidebar thumbnails render natively with pure CSS transforms across all pages.
  • [x] Zero Whiteouts: Inactive and newly created pages maintain their background colors, gradients, and textures without blanking.
  • [x] Zero Cross-Page Swapping: Eliminated the Glass Vault Minimap overlay, preventing active canvas contents from overwriting inactive thumbnail slots.
  • [x] Per-Page Slider Filter Isolation: Adjusting Saturation, Hue Shift, Brightness, Contrast, or Texture Opacity on one page strictly updates that page and its preview without leaking to other pages.
  • [x] Zero Ghost Box Duplication: Verified that page element counts remain strictly stable across repeated page switches (0 ghost boxes accumulated).
  • [x] User Element Parity: Text boxes, shapes, images, and tables render accurately on top of theme layers in both the canvas and sidebar thumbnails.
  • [x] Complete .opub Save & Reload Lifecycle: Documents with per-page themes and customized slider settings serialize, load, and restore with 100% fidelity.
  • [x] Cachebuster Synchronization: All 82 script, stylesheet, worker, and asset cachebuster queries in index.html updated to ?v=5.6.0.
  • [x] Service Worker Cache: Bumped cache name to open-publisher-v5-6-0.
  • [x] Automated Testing: 100% pass rate across multi-page, slider isolation, regression, and persistence test suites.

🎉 Version 5.6.0 - Open Publisher

Source: README.md, updated 2026-10-08