| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| 5.5.3_ Per-Page Individual Themes _ Multi-Page Theme Studio Customization Persistence source code.tar.gz | 2026-10-07 | 22.5 MB | |
| 5.5.3_ Per-Page Individual Themes _ Multi-Page Theme Studio Customization Persistence source code.zip | 2026-10-07 | 22.7 MB | |
| README.md | 2026-10-07 | 12.4 kB | |
| OpenPublisher-5-x86_64.AppImage | 2026-10-07 | 166.4 MB | |
| openpublisher5_amd64-windows-portable.exe | 2026-10-07 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-10-07 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-10-07 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-10-07 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-10-07 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-10-07 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-10-07 | 156.2 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-10-07 | 185.5 MB | |
| Totals: 12 Items | 1.7 GB | 0 | |
π Summary
Version 5.5.3 of Open Publisher introduces a major creative enhancement: Per-Page Individual Themes, allowing every page in a multi-page publication to have its own completely independent background theme, custom color palette, and fine-tuned slider adjustments (or remain completely unthemed).
Prior to this release, background themes were treated as document-wide styling, meaning changing a theme affected every page uniformly. While resolving a multi-page background state desynchronization issue found by @tallulah95 in the Theme Studio, the entire background and theme lifecycle was decoupled and refactored to support true page-by-page independence.
Users who previously adjusted Theme Studio sliders (Hue Shift, Saturation, Contrast, Brightness, Texture Opacity, and Pattern Zoom) on a page also encountered a visual reset when navigating between multiple pages: upon switching to another page and returning, the live canvas reverted to its unadjusted default appearance until a slider was touched, even though the UI sliders remained in their custom positions and exported prints retained the custom hue.
With v5.5.3:
- Per-Page Individual Themes: Each page now possesses its own dedicated
themeSettingsprofile. Page 1 can feature a concrete texture with an emerald 180Β° hue shift, Page 2 can use a rich black leather texture with 75Β° hue, and Page 3 can remain clean, unthemed white. - Robust .opub Metadata Persistence: Every page's individual theme ID, palette colors, texture URL, and all 6 slider adjustments are serialized directly into the
.opubfile format underdocData.pages[i].themeSettings. Saving, closing, and reloading a document restores every page's exact styling with 100% fidelity. - Synchronous Theme Restoration: Moved theme reconstruction to execute synchronously at the end of
renderPage(), eliminating DOM destruction race conditions and eradicating the 500ms visual flash. - Immediate CSS Filter Reapplication: Background containers now receive their computed CSS
filterdirectly upon restoration, ensuring the canvas instantly matches the slider values without requiring user interaction. - Complete Attribute Synchronization: Synchronized all six theme adjustment attributes (
sat,bri,con,hue,tex,size) using strict definedness checks (!== undefined), ensuring 0Β° hue values and custom contrast/sizes are never lost. - Unthemed Page Isolation: Unthemed and
ignoreBackgroundpages cleanly purge alldata-theme-*attributes, remove orphan theme containers, and reset the Theme Studio UI controls to clean defaults viawindow.resetThemeStudioUI(). - Clean Document Loading & Index Reset:
io/publisher-file-loader.jsnow resetsstate.currentPageIndex = 0on document load and safely migrates legacy document-level theme metadata without overwriting per-page styles. - Comprehensive Cachebuster Synchronization: Synchronized all asset queries in
index.html, Service Worker cache (open-publisher-v5-5-3), and subsystem headers to v5.5.3.
π¨ New Feature: Per-Page Individual Themes
Publications often require distinct visual atmospheres across different sections: a dramatic dark cover page, textured feature spreads, and clean white body pages. In v5.5.3, Open Publisher gives users total freedom over every page's background:
- Independent Theme Selection: Selecting a theme from the Page Design ribbon or Theme Studio applies strictly to the currently active page.
- Individual Fine-Tuning: Adjusting Hue Shift, Saturation, Brightness, Contrast, Texture Opacity, or Pattern Zoom applies only to the current page. Switching pages instantly updates the UI sliders, badges, and gradient tracks to reflect that specific page's adjustments.
- Unthemed Flexibility: Add blank pages or toggle "Ignore Background" without losing theme styling on other pages. Unthemed pages display a crisp white canvas with controls reset to defaults.
- WYSIWYG Print & Export Alignment: The editor canvas, thumbnail sidebar previews, HTML export, and native PDF print spooler all render the exact per-page theme layers in perfect parity.
πΎ .opub File Format & Metadata Storage
Individual page themes are fully preserved when saving to Open Publisher's native .opub (JSON) format.
Page Object Structure in .opub:
:::json
{
"title": "My Magazine",
"orientation": "portrait",
"format": "A4",
"dpi": 96,
"pages": [
{
"id": 1728340192831,
"width": "794px",
"height": "1123px",
"background": "#ffffff",
"themeSettings": {
"saved": true,
"id": "concrete-wall",
"name": "Concrete Wall",
"type": "texture",
"c1": "#94a3b8",
"c2": "",
"url": "https://www.transparenttextures.com/patterns/concrete-wall.png",
"sat": "100",
"bri": "100",
"con": "100",
"hue": "180",
"tex": "100",
"size": "100"
},
"elements": []
},
{
"id": 1728340195123,
"width": "794px",
"height": "1123px",
"background": "#ffffff",
"themeSettings": {
"saved": true,
"id": "black-leather",
"name": "Black Leather",
"type": "texture",
"c1": "#1e293b",
"c2": "",
"url": "https://www.transparenttextures.com/patterns/leather.png",
"sat": "100",
"bri": "100",
"con": "100",
"hue": "75",
"tex": "100",
"size": "100"
},
"elements": []
},
{
"id": 1728340197456,
"width": "794px",
"height": "1123px",
"background": "#ffffff",
"themeSettings": null,
"elements": []
}
]
}
Key Metadata Guarantees:
- Full Adjustment Fidelity: Every slider value (
sat,bri,con,hue,tex,size) is stored as explicit strings, preserving values likehue: "0"orcon: "125". - Unthemed Cleanliness: Unthemed pages store
"themeSettings": null, guaranteeing that blank pages never inherit leftover theme layers upon reopening. - Backward Compatibility: When opening older
.opubfiles that contain a top-leveldocData.themeSettingsobject without per-page themes,io/publisher-file-loader.jssmoothly migrates the root theme onto Page 1 while leaving subsequent pages intact.
π Problems Solved & Technical Enhancements
- Canvas Filter Desynchronization on Multi-Page Navigation:
- Root Cause:
core/pages.jscalledrestoreThemeFromSave()beforepaper.innerHTML = '', destroying the restored theme container. While an asynchronous 500mssetIntervalbackup eventually recreated the DOM node, it never computed or assignedcontainer.style.filter. Because the slider inputs already matched the page's saved values,needsUpdateevaluated tofalse, strandingcontainer.style.filterempty until manual slider movement. -
Solution in v5.5.3: Moved
restoreThemeFromSave()to run synchronously at the very end ofrenderPage()after all page elements exist. Both the container reconstruction routine and the existing visual verification routine now immediately invokeupdateLiveFilters(), applying the CSSfilterdirectly to.op-theme-container. -
Missing Theme Attributes in Page Synchronization:
- Root Cause:
renderPage()previously omittedts.con(contrast),ts.hue(hue shift), andts.size(pattern zoom) when mappingthemeSettingsontopaperattributes, and truthy checks skipped0values. -
Solution in v5.5.3: Added full attribute synchronization in
core/pages.jsfor all six parameters using!== undefinedguards. -
Theme Bleed and Residue on Unthemed Pages:
- Root Cause: When navigating from a themed page to an unthemed or blank page,
renderPage()did not removedata-theme-savedordata-theme-*attributes from#paper. -
Solution in v5.5.3: When
renderPage()encounters a page withoutthemeSettingsor withignoreBackground: true, it explicitly removesdata-theme-savedand alldata-theme-*attributes, removes any lingering[data-is-theme="true"]DOM elements, and callswindow.resetThemeStudioUI()to return all sliders, numeric badges, and gradient tracks to default values. -
Document Loader Viewport Index Alignment:
- Root Cause: In
io/publisher-file-loader.js,loadDocumentData()setstate.pages = data.pages;and calledrenderPage(state.pages[0]), but omitted settingstate.currentPageIndex = 0. If a user opened a file while on page 2 or 3 of an earlier session,state.currentPageIndexremained at the previous index, corrupting subsequent page switch serializations. - Solution in v5.5.3: Added explicit
state.currentPageIndex = 0;upon document loading, ensuring seamless page navigation from the moment a file is opened.
π Files Modified
| File | Changes |
|---|---|
core/pages.js |
Synchronized all six theme adjustment attributes (sat, bri, con, hue, tex, size) with !== undefined guards. Added unthemed page attribute cleanup and container removal. Moved restoreThemeFromSave() to the end of renderPage() for synchronous restoration. |
core/history.js |
Updated serializeCurrentPage() to set page.themeSettings = null when data-theme-saved !== 'true'. |
extensions/theme-studio.js |
Added resetThemeStudioUI(). Guarded updateLiveFilters() against writing to unthemed pages. Ensured restoreThemeFromSave() immediately executes updateLiveFilters() on both reconstructed and existing containers when filters mismatch. |
io/publisher-file-loader.js |
Added state.currentPageIndex = 0; on load. Safeguarded legacy data.themeSettings migration so it only populates pages[0] if pages[0].themeSettings does not already exist. |
sw.js |
Bumped Service Worker version and cache name to open-publisher-v5-5-3. |
style.css |
Updated header comments to v5.5.3. |
tools/proofing/spellcheck-engine.js |
Updated engine header docstring to v5.5.3. |
ui/dashboard.js |
Bumped template index and template file fetch queries to ?v=5.5.3. |
ui/modals/options-modal.js |
Updated modal header comment to v5.5.3. |
ui/sidebar-context.js |
Updated sidebar context header comment to v5.5.3. |
index.html |
Updated all 81 script, stylesheet, worker, and asset cachebuster queries to ?v=5.5.3. |
β Complete v5.5.3 Feature & Verification Checklist
- [x] Individual Per-Page Themes: Verified independent themes, palettes, and slider fine-tuning per page across multi-page publications.
- [x] Complete .opub Save & Reload Lifecycle: Serialized document to
.opubJSON structure, loaded viahandlePublisherFileLoad, and verified that all pages retain their exact themes, hue adjustments, and unthemed state. - [x] Instant Filter Application (0ms - 10ms): Verified that
#paper .op-theme-containerhas its computed CSSfilterset synchronously without requiring manual slider movement upon page switching. - [x] Unthemed Page Isolation: Verified that blank and "Ignore Background" pages completely clear theme layers, attributes, and reset Theme Studio UI controls to clean defaults.
- [x] Document Loader Viewport Index Alignment: Verified that
loadDocumentDataresetsstate.currentPageIndex = 0on file load, preventing page overwrite bugs. - [x] Legacy .opub Compatibility: Verified older
.opubfiles with root-levelthemeSettingsgracefully load onto Page 0 without crashing or corrupting multi-page workflows. - [x] Cachebuster Synchronization: All 81 script, stylesheet, worker, and asset cachebuster queries in
index.htmlupdated to?v=5.5.3. - [x] Service Worker Cache: Bumped cache name to
open-publisher-v5-5-3. - [x] Automated Testing: 100% pass rate across automated visual, multi-page, and persistence test suites.
π Version 5.5.3 - Open Publisher