| Name | Modified | Size | Downloads / 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:
renderThumbnailHTMLincore/pages.jsnow natively renders every page's background theme directly frompageData.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-wrapperand.ts-glass-paneloverlay 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()incore/history.jsnow strictly isolates background theme styling intop.themeSettingsand prevents theme wrappers or empty ghost boxes from pollutingp.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 triggersgenerateThumbnail(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:
- Independent Thumbnail Trees: Every page in the sidebar renders as its own lightweight DOM subtree inside
.page-thumb, scaled smoothly using CSStransform: scale(...). - True Theme Parity: Every thumbnail independently renders its own gradient, texture overlay, and computed CSS filters without needing to clone or query the active
#papercanvas. - Instant Responsiveness: Previews update immediately without base64 conversions, image captures, or requestAnimationFrame loops.
- 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-wrapperwith.ts-glass-paneldivs) was mounted directly todocument.bodyatz-index: 90to mirror canvas dragging. An 800mssetInterval(buildMap) cleared all non-active panels (inner.innerHTML = '') and cloned#paperexclusively into the panel matching a singlelockedIndex. When navigating between pages or adding new pages,lockedIndexdesynchronized fromstate.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-wrapperand.ts-glass-panelinextensions/legacy-fixes.jsandstyle.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 usingdocument.querySelectorAll('.op-theme-container')anddocument.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,stealthBackgroundsattached a capturingmousedownlistener towindowthat stripped thepub-elementclass from all[data-is-theme="true"]nodes. When clicking a sidebar thumbnail to switch pages,mousedownfired first and strippedpub-element. Next,switchPage()ranserializeCurrentPage(), which selectedpaper.querySelectorAll('.pub-element:not(.master-page-element)'). Becausepub-elementwas 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 strippingpub-element.
4. Missing Native themeSettings in Thumbnail Rendering
- Root Cause:
renderThumbnailHTML()incore/pages.jsonly checkedpageData.background || '#ffffff'and then looped throughpageData.elements. Because theme attributes (colors, gradients, textures, filters) are stored inpageData.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
renderThumbnailHTMLto natively readpageData.themeSettings. It builds the solid/gradient background div, attaches the texture image with configurable opacity, and applies the computed CSSfilterdirectly 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': ''}) instate.pages[i].elements. - Solution in v5.6.0:
serializeCurrentPage()incore/history.jsnow strictly filters out theme wrappers and ghost boxes fromp.elements. In addition,renderPage()incore/pages.jsautomatically 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.htmlupdated 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