| Name | Modified | Size | Downloads / Week |
|---|---|---|---|
| Parent folder | |||
| openpublisher5_amd64-windows-portable.exe | 2026-09-24 | 183.2 MB | |
| openpublisher5_amd64-windows.exe | 2026-09-24 | 165.2 MB | |
| openpublisher5_amd64-macos.dmg | 2026-09-24 | 233.1 MB | |
| openpublisher5_amd64-linux.run | 2026-09-24 | 193.4 MB | |
| openpublisher5_amd64-linux.rpm | 2026-09-24 | 215.4 MB | |
| openpublisher5_amd64-linux.flatpak | 2026-09-24 | 153.6 MB | |
| openpublisher5_amd64-linux.deb | 2026-09-24 | 156.2 MB | |
| openpublisher5_amd64-linux.AppImage | 2026-09-24 | 176.6 MB | |
| openpublisher5_amd64-freebsd.pkg | 2026-09-24 | 185.5 MB | |
| 5.1.0_ Unified Cross-Platform Clipboard Synchronization source code.tar.gz | 2026-09-24 | 21.4 MB | |
| 5.1.0_ Unified Cross-Platform Clipboard Synchronization source code.zip | 2026-09-24 | 21.7 MB | |
| README.md | 2026-09-24 | 78.3 kB | |
| Totals: 12 Items | 1.7 GB | 0 | |
Welcome to OpenPublisher Release 5.1.0. This milestone release represents a huge transformation of OpenPublisher into a professional, native desktop publishing suite. Version 5.1.0 unites performance engineering, bulletproof file integrity, deep operating system integration, and a refined creative workspace across Windows, macOS, Linux, and FreeBSD.
Every single subsystem has been audited, overhauled, and polished. Below is the complete, comprehensive documentation of all 72 architectural enhancements, features, and fixes that comprise the OpenPublisher V5.1.0 release.
[!NOTE] Flagship Architectural Achievement: Unified Cross-Platform Clipboard Hijack & Synchronization
OpenPublisher V5.1.0 completely resolves longstanding desktop clipboard synchronization challenges across Windows, macOS, Linux, and FreeBSD with an authoritative client-side clipboard subsystem and capture-phase ribbon event interceptor.
- Zero Double-Pasting: Completely eliminates duplicate ghost element pasting when alternating between in-app canvas objects and external operating system images or text.
- 100% Ribbon Bar Parity: Physical Ribbon toolbar Copy, Cut, and Paste buttons now exhibit identical behavior and priority dispatching to native operating system keyboard shortcuts (
Ctrl+C,Ctrl+X,Ctrl+V/Cmd+C,Cmd+X,Cmd+V).- Flawless Multi-Platform Synchronization: Bidirectional IPC synchronization (
OP_ELEMENT_COPIED) guarantees rock-solid clipboard parity, automated format detection, and strict text box token protection across all supported platforms.
Master Feature Index & Table of Contents (72 new V5.1.0 Client-Only features)
Below is the complete quick-reference index of all 72 features, architectural upgrades, and bug fixes included in the V5.1.0 release. Click any item or section link to jump directly to its detailed breakdown:
Architecture, Runtime & Platform Integration
- Uncapped Engine Memory Limits - 8GB RAM and 4GB GPU VRAM allocation ceiling (Jump to § 2.1)
- Native FreeBSD Port & Standalone Package Pipeline - Electron runtime bridge, native
.pkgbuild, and 60 FPS resizing (Jump to § 2.2) - Cross-Platform Dynamic Accelerators & Filesystem Audit - Platform-native hotkeys (
Cmd/Ctrl) and path safety (Jump to § 2.3) - Single-Instance Enforcement & Argument Routing - Direct OS document forwarding without duplicate processes (Jump to § 2.4)
- Multi-Window Lifecycle & Cascading Teardown - Clean termination of all auxiliary subwindows on exit (Jump to § 2.5)
- MyDockFinder Menubar Integration & Process Identity - Native 64-bit hook DLL for macOS-style global menus (Jump to § 2.6)
- Linux Emoji Font Integration & Asset Restore - Bundled Noto Color Emoji font preventing tofu rendering boxes (Jump to § 2.7)
- Workspace Directory Organization & Cleanup - Modular subwindow and asset hierarchy (Jump to § 2.8)
- Multi-Resolution Windows Icon Generation - 10-frame high-DPI
.icomaster bundles up to 256x256 (Jump to § 2.9) - Universal Linux Flatpak Package & Immutable OS Support - Distribution-agnostic sandboxed runtime for Fedora Silverblue, SteamOS, and standard distros (Jump to § 2.10)
Data Integrity, Saving, Backups & Recovery Systems
- Non-Blocking Saves & Asynchronous IPC Data Stream - UI-freeze elimination via serialized stream (Jump to § 3.1)
- 4-Step Atomic Save Pipeline - Corruption-free saves with temporary verification and atomic rename (Jump to § 3.2)
- Dedicated System Backup Directory Relocation - Safe-saves moved to centralized user AppData (Jump to § 3.3)
- Interactive Backup Manager & System Tray Recovery - Draggable modal with real-time backup search and restore (Jump to § 3.4)
- Document-Centric Previous Versions & 15-Minute Snapshots - Background shadow snapshots with 50-version retention (Jump to § 3.5)
- External File Modification Watcher - Automatic change detection and seamless document reloads (Jump to § 3.6)
- Chromium Idle Background Auto-Save Engine - Automated saving of named files after 10 minutes away (Jump to § 3.7)
- Non-Stacking In-App Idle Save Notice - Non-intrusive modal for unnamed documents (Jump to § 3.8)
- Save Notifications & Visual Confirmation - Native OS banner notifications on successful saves (Jump to § 3.9)
- Power Management & Keep-Awake Engine - Prevents OS sleep and screen locking during exports (Jump to § 3.10)
- Renderer Crash Recovery & Process Auto-Restart - Automatic recovery launch upon memory or engine crash (Jump to § 3.11)
- Automated Desktop Diagnostic Crash Logging - Detailed hardware, uptime, and memory dump on failure (Jump to § 3.12)
- Safe Mode Startup Flag & Cache Reset Subsystem - Diagnostic launch flag clearing corrupted cache (Jump to § 3.13)
- Safe Mode Reboot Action & Titlebar Status Badge - Visual titlebar indicator and one-click normal reboot (Jump to § 3.14)
Canvas, Typography & Editing Subsystems
- Unified Client-Side Clipboard Hijack & Priority Synchronization - Complete cross-OS clipboard parity, eliminating double-pasting and ribbon paste locks (Jump to § 4.1)
- Physical Ribbon Bar Copy, Cut & Paste Event Parity - Full 1:1 behavioral parity between physical toolbar buttons and keyboard shortcuts (Jump to § 4.2)
- Intelligent Paste Image Separation - Extracts web images from rich text into independent canvas objects (Jump to § 4.3)
- Automated Clipboard Scrapbook & Ribbon Drawer - 25-item background OS image cache with slide-out drawer (Jump to § 4.4)
- Drag-and-Drop Image Asset Import - Direct image placement without full-screen drop overlays (Jump to § 4.5)
- Tactile Image Drop Shockwave, Sparkle & Badge - High-contrast visual burst feedback on asset placement (Jump to § 4.6)
- HTML5 Frosted Glass File Drag Overlay - Drag-and-drop overlay for
.opubdocument files (Jump to § 4.7) - Document Content Pour Animation & Zero-Flicker Fix - Cascade element entrance with pre-paint clamp (Jump to § 4.8)
- Full Canvas Pasteboard & Shift + Scroll Horizontal Navigation - Smooth horizontal wheel panning (Jump to § 4.9)
- Native Spellcheck & Bundled Hunspell Dictionaries - Red squiggly underlines with offline US/GB dictionaries (Jump to § 4.10)
- Windows System Fonts Registry Discovery - Merged local TrueType/OpenType and Google Web fonts (Jump to § 4.11)
- Safari-Style Subpixel Font Rendering - Crisp typography smoothing and geometric vector precision (Jump to § 4.12)
- Restored Smooth Image Interpolation - Bilinear anti-aliasing for scaled ribbon icons and clipart (Jump to § 4.13)
- Dashboard Default Page State Guard - Eliminates blank document corruption on dashboard exit (Jump to § 4.14)
Window Management, Shell Integration & Navigation
- Window State, Geometry & Multi-Monitor Persistence - Preserves size, position, and layout across monitors (Jump to § 5.1)
- Window Shadows, Rounded Corners & Omnidirectional Resizing - DWM alpha compositing and 8-point resize handles (Jump to § 5.2)
- *Dynamic Titlebar Dirty State Asterisk () Indicator - Real-time visual unsaved changes marker (Jump to § 5.3)
- Smart Exit Modal with Dirty State Checking - Skips exit warnings when documents have no unsaved changes (Jump to § 5.4)
- Exit Modal Visual Modernization - Compact 380px native dialog styling (Jump to § 5.5)
- Window Controls Contrast & Auto-Healing Color Fix - Guaranteed white controls across all 105 themes (Jump to § 5.6)
- Topbar Client Controls & Solid Icon Integration - Unboxed toolbar buttons with Font Awesome 6 Solid icons (Jump to § 5.7)
- Titlebar Recent Documents Dropdown & Native Load Sync - 10-document history list with glowing load bar (Jump to § 5.8)
- Titlebar "Show in File Explorer" Action - Direct Explorer launch highlighting the active document (Jump to § 5.9)
- Always-on-Top Window Pinning - Floating pushpin control for reference multitasking (Jump to § 5.10)
- Native Fullscreen Toggle with F11 Focus Protection - True borderless fullscreen view (Jump to § 5.11)
- Global OS Keyboard Shortcut Restoration -
Ctrl+Shift+O/Photkeys bring the app forward from anywhere (Jump to § 5.12) - System Tray Integration & Professional Jump List - Taskbar tray icon with rich productivity menu (Jump to § 5.13)
- "Close to System Tray" User Preference - Minimizes window to tray instead of quitting (Jump to § 5.14)
- Prevent Accidental Wrapper Selection & Dragging - Eliminates blue text selection boxes on chrome UI (Jump to § 5.15)
- Native Taskbar Indeterminate Progress Animation - Marquee progress on OS taskbar during background saves (Jump to § 5.16)
- Taskbar Attention Flashing on Completion - Taskbar glows when background exports and saves finish (Jump to § 5.17)
Export, Presentation & Multi-Page Output
- Standalone Export & Print Queue Monitor & Multi-Page Print - Dedicated tearaway window and vector print spooling (Jump to § 6.1)
- Standalone Document Presentation Preview - Distraction-free live presentation window (
doc_preview.html) (Jump to § 6.2) - Scoped Teal-on-Dark Custom Scrollbars - Custom scrollbar theme for secondary dialogs (Jump to § 6.3)
- OS Process Priority Elevation During Exports - Elevates CPU priority to above normal during rendering (Jump to § 6.4)
- Native Dock and Taskbar Export Progress Bars - Real-time numeric progress fill on taskbar/dock (Jump to § 6.5)
Visual Identity, Themes & Onboarding
- Interactive Glassmorphic First Run Wizard - 8-step onboarding tour with Frosted Glass UI (Jump to § 7.1)
- Unified Flow UI Splash Screen & Boot Synchronization - Single splash screen with live boot console (Jump to § 7.2)
- Adaptive Dual-Theme Startup Screen Modernization - Official V5 SVG vector branding in light/dark studio modes (Jump to § 7.3)
- Dynamic OS Splash Edition Labeling & Icon Array - Dynamic platform name and illuminated OS logos (Jump to § 7.4)
- Dynamic Theme Synchronization & Storage Persistence - Zero-flicker launch with persistent webview storage (Jump to § 7.5)
- Client Modal & HUD UI Overhaul - Standardized 46px header profiles and rounded corners (Jump to § 7.6)
Developer Mode, Diagnostics & Easter Eggs
- Developer Mode Subsystem & UI Live Reload - Floating debug HUD with
Ctrl+Shift+Dand CSS file watcher (Jump to § 8.1) - Standalone Tearaway Pop-Out Developer HUD - Detachable floating multi-monitor window (
hud.html) (Jump to § 8.2) - Real-Time Bidirectional IPC Traffic Sniffer - Uniform 14px pill badges for incoming/outgoing events (Jump to § 8.3)
- Memory Footprint Bar Chart & Live Allocation Monitor - Auto-zooming graph and real-time RSS change rate (Jump to § 8.4)
- Developer HUD "Open AppData" Quick Action - Direct one-click folder access (Jump to § 8.5)
- Microsoft Agent (Clippy) Assistant Integration - Remote MKLab fetch, 41 animations & 101 tips (Jump to § 8.6)
1. Executive Summary & Architecture Highlights
OpenPublisher V5.1.0 shifts from a standard wrapped web application to a true native hybrid desktop suite:
- Flagship Native Clipboard Subsystem: A ground-up re-engineering of the cross-platform clipboard pipeline across Windows, macOS, Linux, and FreeBSD. The new bidirectional IPC synchronization (
OP_ELEMENT_COPIED), capture-phase click interceptor, and priority-ordered client paste dispatcher (handleClientPaste) completely eliminate double-pasting bugs, ribbon paste locks, and token leakage into text boxes while achieving full 1:1 parity with keyboard shortcuts. - Zero-Friction Performance: Process memory limits uncapped up to 8GB RAM and 4GB GPU VRAM, combined with non-blocking asynchronous IPC pipelines.
- Fail-Safe Data Integrity: The 4-step Atomic Save pipeline, dedicated backup directories, 15-minute background shadow snapshots, and external file modification watchers protect your work against power failures, crashes, and sync collisions.
- Deep Desktop Integration: Native system tray with dynamic jump lists, global OS window hotkeys (
Ctrl+Shift+O/P), taskbar progress indicators, and attention flashing. - True Multi-Platform Support: Tier-1 support across Windows, macOS, Linux, and FreeBSD, including universal Linux Flatpak distribution (
.flatpak) for immutable operating systems, native FreeBSD Electron packages (.pkg), dynamic menu accelerators, and bundled emoji fonts. - Refined Creative Workspace: The new Clipboard Scrapbook drawer, smart text/object copy-paste separation, smooth canvas pour animations, Safari-grade subpixel typography, and offline Hunspell spellchecking.
- Modern User Experience: A glassmorphic 8-step First Run onboarding wizard, unified Flow UI boot sequencing, dynamic theme persistence, and customizable Developer HUD.
2. Core Architecture, Runtime & Platform Integration
2.1 Uncapped Engine Memory Limits
Log Reference: memory_limits_uncap_update.txt
- Problem: Large publications with hundreds of vector shapes, high-resolution photographs, and complex multi-page spreads were previously vulnerable to Chromium V8 out-of-memory crashes and renderer freezes.
- Implementation: Uncapped runtime memory limits via
package.jsonflags: --js-flags="--max-old-space-size=8192": Increases the V8 JavaScript heap ceiling to 8GB.--force-gpu-mem-available-mb=4096": Allocates up to 4GB of dedicated video memory for GPU canvas compositing and scaling.- Low-End Hardware Safety: These flags establish a ceiling rather than a pre-allocated reservation. On systems with 4GB or less RAM, the engine boots with standard lightweight footprints and gracefully utilizes operating system virtual memory pagefiles if publication demands peak.
2.2 Native FreeBSD Port & Standalone Package Pipeline
Log Reference: freebsd_electron_port_and_standalone_pkg_architecture.txt
- Architecture: Engineered a native FreeBSD port utilizing FreeBSD Electron to overcome the lack of official NW.js binaries and Linuxulator glibc incompatibilities.
- Dual-Runtime Bridge: Created a zero-overhead preload layer (
electron-preload.js) that polyfills the entire NW.js API surface (nw.Window,nw.App,nw.Menu,nw.MenuItem,nw.Clipboard,nw.Shell), allowing the existing desktop codebase to run unmodified under Electron. - Real-Time Resizing: Completely eliminated the legacy, flicker-prone "ghostwin" helper architecture. Implemented 8 dedicated in-window perimeter resize hitboxes driven by hardware-synchronized
requestAnimationFrameand directsetBoundscalls for smooth 60 FPS resizing on X11 window managers. - Standalone
.pkgDistribution: Createdbuild-pkg.shproducing self-containedopenpublisher-5.pkgpackages with bundled Electron runtime, desktop entries, MIME associations for.opub, and scalable vector branding icons.
2.3 Cross-Platform Architecture & Readiness Audit
Log Reference: cross_platform_compatibility_update.txt
- Dynamic Keyboard Accelerators: Replaced static shortcut bindings with platform-aware accelerators. Keyboard shortcuts dynamically map to
Cmdon macOS andCtrlon Windows, Linux, and FreeBSD across all menus and dialogs. - Filesystem Normalization: Hardened path resolution routines across all modules using Node.js
path.join(),path.resolve(), and explicitfile://URI encoding to handle Unix forward slashes, Windows drive letters, and spaces in document names without escaping errors. - System Typography Stacks: Implemented platform-adaptive font stacks prioritizing
-apple-systemandBlinkMacSystemFonton macOS,Segoe UIon Windows, andRoboto/Ubuntuon Linux desktops.
2.4 Single-Instance Enforcement & Argument Routing
Log Reference: single_instance_update.txt
- Problem: Opening
.opubfiles from file managers while the application was already running spawned duplicate, competing application processes. - Solution: Configured
"single-instance": trueinpackage.jsonand established annw.App.on('open', ...)receiver inwrapper.html. - Behavior: When a secondary instance is launched, the operating system forwards command-line file arguments directly to the primary running instance, which parses the target file, calls
loadAssociatedFile(), restores from minimized or tray states, and brings the publication window to immediate front focus.
2.5 Multi-Window Lifecycle & Cascading Teardown
Log Reference: multi_window_lifecycle_and_cascade_close_update.txt
- Problem: Secondary windows (such as the Export Queue, Presentation Preview, and Developer HUD) previously remained orphaned on the desktop after the main application exited. Rapid clicks on topbar buttons could also spawn duplicate child windows.
- Cascading Teardown: Introduced
terminateAppCleanly()andcloseAllChildWindows()inwrapper.html. Closing the main window systematically closes all tracked secondary windows before callingnw.App.quit(). - Heartbeat Safety Monitor: Implemented a 350ms heartbeat loop in all child windows (
doc_preview.html,export_queue.html,hud.html,backup_mgr.html,prev_versions.html). If the main process terminates unexpectedly, child windows detect the disconnection and self-terminate instantly. - Mutex Guards: Added asynchronous opening mutexes to prevent duplicate window spawns during rapid button clicks.
2.6 MyDockFinder Menubar Integration & Application Identity
Log Reference: mydockfinder_native_menubar_and_window_identity_update.txt
- macOS-Style Global Menus: Built seamless integration with MyDockFinder (
Dock_64.exe) on Windows without introducing unwanted floating menubars or caption buttons inside the frameless window. - Native Hook DLL: Developed
op_menu_hook.dll(a pure 64-bit PE DLL) installed viaSetWindowsHookEx(WH_GETMESSAGE). The hook interceptsWM_COMMANDandWM_MENUCOMMANDmessages from the external dock, routing command IDs through a hidden receiver window intowrapper.html. - Process Identity: Fixed window naming and process identifiers. Configured explicit application titles in
package.jsonand compiledOpenPublisher.exe, ensuring the application registers correctly in the Windows Task Manager, audio mixer, and dock launchers.
2.7 Linux Emoji Font Integration & Asset Restore
Log Reference: linux_emoji_font_and_firstrun_asset_restore.txt
- Problem: On Linux distributions without pre-installed system color emoji packages, emoji characters in document text and interface dialogs rendered as empty rectangular tofu boxes (
U+FFFD). - Solution: Bundled Google's
NotoColorEmoji.ttf(Noto COLRv1, 4.8 MB) in thefonts/directory. - Scoped Font-Face: Declared
@font-facerules with strictunicode-rangedefinitions covering all standard emoji blocks (symbols, emoticons, dingbats). The font activates exclusively for emoji codepoints, leaving standard Inter and Segoe UI text typography completely unaffected. - Asset Directory Restoration: Fully restored all missing
firstrun_assets/slide images and theme previews for Linux deployment packages.
2.8 Workspace Directory Cleanup & Architecture Organization
Log Reference: directory_cleanup_patch_update.txt
- Subwindow Consolidation: Relocated 7 companion subwindows from the root directory into a dedicated
windows/directory (hud.html,ipc_sniffer.html,quick_actions.html,doc_preview.html,export_queue.html,backup_mgr.html,prev_versions.html). - Modular Assets: Created organized asset subfolders under
assets/: assets/icons/: Application, document, tray, and taskbar icons.assets/ui/: High-resolution crash recovery and dialog artwork.assets/branding/: Multi-resolution logos and vector emblems.assets/media/: Boot videos and companion graphics.- Sanitization: Purged over 440 MB of obsolete scratch scripts, mockups, redundant dictionary binaries, and stale test documents.
2.9 Multi-Resolution Windows Icon Generation
Log Reference: multi_resolution_ico_generation_update.txt
- Multi-Frame Windows ICOs: Generated comprehensive Windows
.icomaster icon packages embedding 10 discrete resolution frames: 16x16, 20x20, 24x24, 32x32, 40x40, 48x48, 64x64, 96x96, 128x128, and 256x256 (with PNG compression for 256x256 frames). - Aspect-Safe Resampling: High-fidelity Lanczos filtering preserves pixel-perfect sharpness across 100%, 125%, 150%, and 200% High-DPI Windows display scaling.
2.10 Universal Linux Flatpak Package & Immutable OS Support
Log Reference: linux_flatpak_distribution.txt
- Universal Linux Packaging: Introduced an official
.flatpakpackage bundle for Linux distributions, offering a universal, sandboxed installation model alongside traditional package options. - The Problem with Traditional Packages (
.deb/.rpm) on Modern Linux: - Many modern Linux distributions (such as immutable or atomic desktop OSes including Fedora Silverblue, Fedora Kinoite, SteamOS on the Steam Deck, openSUSE MicroOS / Aeon, Vanilla OS, Endless OS, and ChromeOS Linux containers) employ read-only root filesystems (
/usr,/bin). On these operating systems, conventional package installations using.deb(viaapt/dpkg) or.rpm(viadnf/rpm) are strictly locked, unavailable, or strongly discouraged because layering root packages breaks the integrity and update model of the underlying OS. - On distributions without native
.debor.rpmpackage managers (such as Arch Linux, Void Linux, Solus, or Alpine), users are traditionally forced to use complex repackaging tools (alien) or resort to standalone AppImages. - While AppImages provide portable execution without root installation, they have notable shortcomings: they do not integrate automatically into desktop application menus, lack native system MIME-type associations for
.opubdocuments, and require manual file management or third-party integration daemons. - Key Flatpak Advantages & Architectural Benefits:
- First-Class Support for Immutable & Atomic Operating Systems: Installs and updates entirely within user space (
flatpak install --user) or rootless system stores without modifying or layering onto the read-only host OS filesystem. Users on SteamOS (Steam Deck), Fedora Silverblue, and ChromeOS can install OpenPublisher with zero friction. - Eliminates Dependency Mismatches: Bundles all required Chromium runtime binaries, graphics drivers, and system dependencies within standardized Freedesktop SDK runtimes, preventing missing shared library errors (
glibc,libstdc++, GTK) across diverse Linux environments. - Sandboxed Desktop Security: Leverages Bubblewrap (
bwrap) containment to isolate application processes while seamlessly integrating with desktop services via XDG Desktop Portals (xdg-desktop-portal) for native host file dialogues, printing spoolers, and clipboard synchronization. - Automatic Desktop & MIME Integration: Automatically creates desktop launcher icons, system application menu entries, and associates
.opubpublication files with OpenPublisher upon installation. - Seamless Updates & Disk Deduplication: Updates effortlessly through graphic software centers (GNOME Software, KDE Discover) or simple CLI commands (
flatpak update), utilizing OSTree deduplication to minimize disk footprint.
3. Data Integrity, Saving, Backups & Recovery Systems
3.1 Non-Blocking Saves & Asynchronous IPC Data Stream
Log Reference: async_ipc_update.txt
- Problem: Previous releases utilized synchronous dialog methods (
window.prompt) to serialize document payloads across the webview boundary, causing noticeable UI stutter and frame freezes when saving large publications. - Implementation: Completely re-engineered the wrapper IPC bridge using asynchronous console data streams via the
consolemessageevent listener. - Impact: Document payloads stream seamlessly in the background via serialized
OP_IPC:streams. The canvas interface remains 100% interactive and responsive throughout saves, and standard browser prompt/alert dialogs are decoupled from the save pipeline.
3.2 4-Step Atomic Save Pipeline
Log Reference: atomic_save_feature.txt
- Problem: Sudden OS crashes, power loss, or disk-full errors during direct file writes could truncate or corrupt
.opubpublication files. - 4-Step Architecture:
- Temporary Write: Serialized document data writes to an isolated temporary file (
[filename].opub.tmp). The original document remains untouched. - Byte-Length Verification: The filesystem verifies that the temporary file was written completely and is not zero-byte before proceeding.
- Backup Rotation: The existing file is safely rotated into the backup directory as a known-good recovery point (
[filename].opub.bak). - Atomic Rename: The temporary file is renamed to the target filename via an uninterruptible OS-level atomic operation (
fs.renameSync). - Error Handling: If any verification step fails, the temporary file is unlinked, an alert is surfaced, and the original document is preserved intact.
3.3 Dedicated Backup Directory Migration
Log Reference: backup_directory_relocation_update.txt
- Relocation: Migrated
.bakrotation files from user project folders into a centralized system backup directory (AppData\Local\OpenPublisher\User Data\Default\Backupson Windows, with fallback to%TEMP%\OpenPublisher-Backups). - Clutter Elimination: Working directories remain completely clean of secondary backup files.
- Automated Cleanup: Saving a document automatically detects and purges any legacy
.bakfiles remaining in the local project directory. - Direct Explorer Access: Added direct access buttons in the Developer HUD and titlebar to open the system backup folder in Windows File Explorer.
3.4 Interactive Backup Manager & System Tray Integration
Log Reference: backup_manager_feature_update.txt
- Draggable Modal Interface: Added
#custom-backup-mgr-overlay, a modern glassmorphic window featuring real-time search filtering, chronological sorting, refresh controls, and direct folder buttons. - Metadata Inspection: Backups list publication titles, raw file names, last modified timestamps, byte sizes, and parsed page counts.
- Decoupled Recovery: Opening a backup decodes the document with the signature pour animation, tags it as a
(Backup), and unbinds the active file path (setting it tonull). Pressing Save triggers "Save As", preventing users from accidentally overwriting historical archives. - Multi-Entry Points: Accessible via the titlebar clock button, the system tray context menu, and the Developer HUD Quick Actions palette.
3.5 Built-In Previous Versions & 15-Minute Background Snapshot Engine
Log Reference: previous_versions_feature_update.txt
- Dedicated Snapshot Engine: Implemented an automated background snapshot system (styled after Windows Shadow Copies) that operates independently of the manual Backup Manager.
- 15-Minute Periodic Cadence: Every 15 minutes, if an open publication has unsaved changes, the background engine silently records a timestamped snapshot without interrupting typing or dragging.
- Pre-Save Snapshots: When the user performs a manual save, the pre-save state is preserved as a snapshot before the write executes.
- Retention & Quota Management: Enforces a strict 50-snapshot FIFO retention limit per document and provides manual purging controls.
- Restore & Inspect Modal: Accessible via the titlebar Previous Versions button. Displays snapshot date/time, document name, page count, and relative age ("5 mins ago", "Yesterday"). Offers two recovery modes:
- Restore: Overwrites the active canvas with the selected snapshot after confirmation.
- Open as Copy: Loads the snapshot into a fresh, untitled publication.
3.6 External File Modification Watcher
Log Reference: external_file_watcher_update.txt
- Filesystem Observation: Leveraged Node.js
fs.watchto actively monitoractiveFilePathon disk. - Collision Protection (
isAppSavinglock): Implemented an internal lock that suppresses filesystem alerts during the app's own atomic saves. - Debounced Change Detection: Modifying the open file via external programs, network drives, or cloud sync triggers a debounced (500ms) confirmation modal: "This file was modified externally. Reload it?"
- Seamless Document Refresh: Accepting the prompt automatically reloads the document into the canvas with full animation and status bar feedback.
3.7 Chromium Idle Background Auto-Save Engine
Log Reference: chrome_idle_autosave_update.txt
- System Inactivity Monitoring: Integrated Chromium's
chrome.idleAPI configured with a 10-minute (600-second) inactivity threshold. - Background Auto-Save: When the system transitions to 'idle' or 'locked', the wrapper automatically verifies if the publication has an active file path. If saved modifications exist, it quietly saves the document in the background with taskbar progress and without interrupting user flow.
3.8 Non-Stacking In-App Idle Save Notice
Log Reference: idle_save_modal_update.txt
- Non-Stacking In-App Modal: For brand new, unnamed documents (
activeFilePath === null), the app suppresses programmatically triggering native file dialogs while the user is away. Instead, a single, non-stacking in-app modal (#custom-idle-save-modal) appears: "You have been away for 10 minutes. Would you like to save now, or ignore?" - Metadata Synchronization: Saving from the modal immediately applies the chosen file basename to the document title input, the titlebar, and document metadata.

3.9 Save Notifications & Visual Feedback
Log Reference: save_notification_update.txt
- Native OS Desktop Notifications: Integrated
chrome.notifications.create(with HTML5 notification fallbacks) to display native OS banner notifications when document saves complete. - Action Center Support: Bypasses Windows Action Center restrictions by routing through the Chromium notifications subsystem with the bundled
openoublisherv5st-icon.png.
3.10 Power Management & Keep-Awake Engine
Log Reference: power_management_keep_awake_update.txt
- Sleep & Screen-Saver Suppression: Integrated Chromium's
chrome.powerAPI into the save and export lifecycles. - Display Lock During Heavy Jobs: Automatically executes
chrome.power.requestKeepAwake('display')during PDF exports, multi-page printing, and atomic disk writes, preventing operating system sleep or monitor timeouts. The keep-awake lock is released immediately once jobs finish.
3.11 Renderer Crash Recovery & Auto-Restart
Log Reference: renderer_crash_update.txt
- Crash Detection: Actively monitors webview
crashed,plugin-crashed, andkilledlifecycle events. - Automatic Restart: When a catastrophic crash occurs, OpenPublisher catches the failure, uses
child_process.spawnto launch an independent replacement process with the--recoveredflag, preserves the active file path, and cleanly terminates the defunct parent. - Interactive Recovery Dialog: On relaunch, the user is greeted by an interactive recovery dialog offering to restore the previous canvas session or start fresh.
3.12 Automated Desktop Diagnostic Crash Logging
Log Reference: crash_log_generation_update.txt
- Diagnostic Desktop Crash Logs: Automatically generates
OpenPublisher-Crash-Log.txtdirectly on the user's Desktop upon renderer failure, compiling: - Exact Webview RAM, FPS, and DOM node counts captured prior to failure.
- Process uptime, RSS, and V8 heap limits.
- Operating system architecture, total/free RAM, and CPU specifications.
- Core dependency versions (NW.js, Chromium, Node.js).
3.13 Safe Mode Startup Flag & Cache Reset Subsystem
Log Reference: safe_mode_flag_update.txt
- CLI Flags: Added native support for
--safe-modeand--resetstartup flags. - Cache Purging: Launching with
--safe-modeclears the internal Chromium cache vianw.App.clearCache(), purges ephemeral local storage, and resets corrupted window layout bounds.
3.14 Safe Mode Reboot Action & Titlebar Status Badge
Log Reference: reboot_safe_mode_update.txt
- Safe Mode Visual Badge: Injects a prominent red
[SAFE MODE]badge into the titlebar controls when active. Clicking the badge opens a dialog explaining the diagnostic state and provides a one-click "Reboot Normally" action. - Developer HUD Trigger: Added a "Reboot Safe Mode" action in the Developer HUD Quick Actions palette using detached process spawning.
4. Canvas, Typography & Editing Subsystems
4.1 Unified Client-Side Clipboard Hijack & Priority Synchronization
Log References: canvas_element_copy_paste_update.txt, clipboard_hijack_sync_update.txt
- Architectural Overhaul: Resolved critical clipboard synchronization edge cases across internal canvas elements and external desktop application payloads across all supported operating systems (Windows, macOS, Linux, and FreeBSD).
- Core Problems Resolved:
- Double-Pasting Bug: Copying an element within OpenPublisher followed by copying external text or an image from another application previously caused both the original OpenPublisher element and the new external payload to be pasted simultaneously onto the canvas.
- Ribbon Paste Lock: The physical Ribbon "Paste" button previously locked onto in-memory web application buffers, completely ignoring updated content copied to the operating system clipboard from external apps.
- Internal Element Copy Failure in Sandboxed Webviews: In sandboxed webviews,
navigator.clipboard.writeTextfailed to populate the OS system clipboard with the internal marker token ('openpublisher_internal_multi'), leaving canvas elements (shapes, cliparts, text boxes) unpastable. - Text Box Token Leakage: Pasting while editing inside a text box or table cell previously allowed the internal token string (
'openpublisher_internal_multi') to leak as typed text into the active field instead of correctly handling canvas elements or images. - Bidirectional Client Clipboard Synchronization (
OP_ELEMENT_COPIED): - Hooked
window.copyElandwindow.cutElacross all channels: Ribbon buttons, keyboard shortcuts (Ctrl+C/Ctrl+X/Cmdequivalents), context menus, and application menubars. - Whenever an internal canvas element is copied or cut, an
OP_ELEMENT_COPIEDIPC message is dispatched directly to the host wrapper process. - The wrapper instantly clears stale external images via
nw.Clipboard.get().clear()and sets the authoritative internal marker:nw.Clipboard.get().set('openpublisher_internal_multi', 'text'). This guarantees 100% reliable detection of internal canvas copies across the operating system. - Priority-Ordered Client Paste Dispatcher (
handleClientPaste): - Implemented an intelligent priority hierarchy when pasting onto the publication canvas:
- Internal Element Token: If
textData === 'openpublisher_internal_multi', it invokeswindow.pasteEl(inPlace)with standard cascading placement (+20px offset or 0px for "Paste in Place"). - External Image (PNG / JPEG): Clears stale internal element buffers and inserts the external graphic directly onto the canvas via
window.insertSmartImage(). - External Text: Clears internal buffers and dispatches a clean text paste.
- Internal Element Token: If
- Strict Text Box & Input Protection:
- When the cursor is positioned inside an active text box or table cell (
isTextEditing):- Image on OS Clipboard: Automatically directs the image onto the canvas outside the text box, protecting the text field from raw token leakage or corrupted inline image tags.
- Internal Element Token: Clones and places the canvas element cleanly on the canvas while strictly blocking token insertion into the text box.
- External Text: Inserts clean text directly at the active cursor position, preserving typography and layout flow.
- DOM Capture-Phase Guard: Added a top-level listener on document
'paste'to intercept and block'openpublisher_internal_multi'from ever being inserted into any text element. - Automated Verification: Validated via automated Playwright and script evaluation test suites verifying zero JavaScript syntax or parse errors in
wrapper.html, proper registration ofhandleClientPasteon the window scope, and verifiedOP_ELEMENT_COPIEDandOP_PERFORM_CLIENT_PASTEIPC handlers.
4.2 Physical Ribbon Bar Copy, Cut & Paste Event Parity
Log References: clean_clipboard_update.txt, ribbon_button_parity_update.txt
- Root Cause Analysis:
- Event Cancellation Conflict: Previous wrapper interceptor logic listened across
['mousedown', 'mouseup', 'click']. CallingpreventDefault()andstopPropagation()duringmousedownprevented Chromium from generating or dispatching the subsequentclickevent, muting the physical Ribbon Paste button. - Missing Copy/Cut Button Coverage: The interceptor previously only targeted Paste. Clicking the physical Copy or Cut buttons on the Ribbon executed default
copyEl()without notifying the wrapper viaOP_ELEMENT_COPIED, leaving the host OS clipboard desynchronized. - Unified Capture-Phase Click Interceptor:
- Configured
document.addEventListener('click', handler, true)to intercept physical Ribbon toolbar and Context Menu button clicks during the capture phase, ahead of inlineonclickhandlers. - Preserves
mousedownandmouseupnaturally, ensuring clicks are cleanly generated and focus is correctly preserved. - 100% Behavioral Parity with Keyboard Shortcuts (
Ctrl+C,Ctrl+X,Ctrl+V): - Ribbon Copy (mirrors
Ctrl+C/Cmd+C):- If editing text with an active selection: copies formatted text via
document.execCommand('copy'). - If canvas elements are selected: invokes
window.copyEl(), ensuresstate.copiedElandstate.copiedElementsare populated, and dispatchesOP_ELEMENT_COPIEDto the NW.js host wrapper.
- If editing text with an active selection: copies formatted text via
- Ribbon Cut (mirrors
Ctrl+X/Cmd+X):- If editing text with an active selection: cuts text via
document.execCommand('cut'). - If canvas elements are selected: invokes
window.cutEl(), updates canvas state, and dispatchesOP_ELEMENT_COPIED.
- If editing text with an active selection: cuts text via
- Ribbon Paste (mirrors
Ctrl+V/Cmd+V):- If editing text: sends
OP_GET_CLEAN_CLIPBOARDto invoke nativewebview.paste(), cleanly inserting clipboard text without browser security prompts. - If working on the canvas: sends
OP_PERFORM_CLIENT_PASTEto executehandleClientPaste(inPlace), triggering the priority dispatcher.
- If editing text: sends
4.3 Intelligent Paste Image Separation
Log Reference: paste_image_separation_update.txt
- Problem: Pasting rich content copied from web browsers often embedded
<img>tags directly inside canvas text boxes as un-editable inline HTML elements. - Solution: Implemented a capture-phase HTML parser that inspects clipboard
text/htmlpayloads usingDOMParser. - Automatic Separation:
- Any
<img>tags are extracted from the HTML payload. - The cleaned text is inserted into the active text box with full typographic styling.
- The extracted image URLs (web URLs, data URIs, or local paths) are downloaded/decoded to temporary storage and dispatched into the publication as distinct, independent, movable canvas graphic objects.
4.4 Automated Clipboard Scrapbook & Ribbon Drawer
Log Reference: clipboard_scrapbook_update.txt
- Background Clipboard Interception: A lightweight background poller queries the OS clipboard every 2 seconds for new PNG and JPEG image data across Windows, macOS, and Linux.
- Persistent Disk Cache: Maintains a FIFO cache of the last 25 copied images in user data storage, persisting across application sessions. Redundant writes are prevented via SHA-256 hash checking.
- Dual Ribbon Integration: Injected dedicated "Scrapbook" buttons into both
Home -> ClipboardandInsert -> Illustrationswith live badge counters showing stored item counts. - Acrylic Glass Floating Drawer: A 310px slide-out drawer featuring dark mode styling, image thumbnails, capture timestamps, resolutions, and single-click or drag-and-drop canvas insertion.
- Natural Sizing & Canvas Nudge: Images insert at their authentic pixel dimensions (scaled down proportionally only if exceeding document margins). If the document canvas is close to the right edge when the drawer opens, the canvas smoothly auto-nudges left into view and restores its position when closed.
- Sidebar Exclusivity: Opening the Scrapbook automatically closes other inspector sidebars (Format Picture, WordArt, Table Layout) to maintain a clean workspace.
4.5 Drag-and-Drop Image Asset Import
Log Reference: import_asset_drag_drop_update.txt
- Overlay Suppression: Dragging image files (PNG, JPG, SVG, WebP, GIF, AVIF, TIFF, BMP) into the window automatically suppresses the full-screen "Drop to open publication" overlay, keeping the canvas visible.
- Direct Canvas Import: Intercepts dropped image files and dispatches
OP_IMPORT_ASSETdirectly to the webapp, importing files instantly as canvas objects at the drop coordinates.
4.6 Tactile Image Drop Shockwave, Sparkle & Badge
Log Reference: image_drop_animation_update.txt
- Visual Impact Animation: Dropping image assets onto the canvas triggers a high-contrast teal shockwave ripple (
rgba(20, 111, 110, 0.85)), a 360-degree radial sparkle burst, and a spring-animated glassmorphic pill badge displaying the asset filename and image icon. - Coordinate Tracking: Bidirectional cursor tracking ensures the visual burst centers exactly where the mouse button was released, followed by a status bar toast confirmation.
4.7 HTML5 Frosted Glass File Drag-and-Drop Overlay
Log Reference: drag_and_drop_overlay_update.txt
- Publication Drop Overlay: Dragging
.opubor.jsonpublication documents over the window triggers#drag-drop-overlay, a full-window frosted glass veil featuring backdrop blur (blur(8px)), a pulsing document icon, and a "Drop to open publication" label. - Drag Counter Guard: Implemented drag event counter balancing to prevent overlay flickering when the cursor hovers across child UI elements.
4.8 Document Content Pour Animation & Zero-Flicker Fix
Log Reference: publication_pour_animation_update.txt
- Liquid Pour Animation: Opening or dropping a publication triggers an organic vertical cascade: elements smoothly pour down into place with staggered delays and a sweeping teal wave sheen.
- Zero-Flicker (FOUC) Elimination: Resolved the initial Flash of Unstyled Content. The loader synchronously clamps incoming elements into a transparent, pre-lifted state (
.paper-pouring,opacity: 0,translateY(-22px)) before the browser renders the first paint frame, eliminating flash-and-reload glitches.
4.9 Full Canvas Pasteboard & Shift + Scroll Horizontal Navigation
Log Reference: shift_scroll_horizontal_update.txt
- Problem: At 60% default zoom on widescreen monitors, the canvas page fit entirely within the viewport, causing the browser to lock horizontal scrolling (
maxScrollLeft = 0). Users could not pan the page across the pasteboard. - Solution: Expanded the canvas pasteboard margins. Holding
Shiftwhile using the mouse scroll wheel now smoothly scrolls the canvas horizontally across all zoom levels (60% to 500%), enabling fluid navigation across large multi-page spreads.
4.10 Native Spellcheck & Bundled Hunspell Dictionaries
Log Reference: spellcheck_support_update.txt
- Engine Activation: Enabled Chromium native spellchecking via
--enable-spell-checkingand--enable-features=WinUseBrowserSpellChecker. - Bundled Offline Dictionaries: Bundled and auto-provisioned offline Hunspell
.bdicdictionaries (en-USanden-GB) directly in the application directory and user profile, resolving NW.js dictionary download limitations. - DOM Enforcer: Injected a persistent DOM observer that guarantees all existing and newly created text boxes, shapes, table cells, and contenteditable elements have
spellcheck="true"enabled with native red squiggly underlines under misspelled words.
4.11 Windows System Fonts & Google Fonts Integration
Log Reference: system_fonts_integration_update.txt
- Windows Registry Font Discovery: Implemented
detectWindowsSystemFonts()in Node.js, scanningHKLMandHKCUregistry tables to catalog all installed TrueType and OpenType fonts on the host computer. - Unified Font Dropdown: Merged local system fonts and Google Web Fonts into a single alphabetically sorted list with distinctive theme-colored icons:
- Google "G" logo for web fonts.
- Desktop monitor icon for installed local Windows fonts.
- Normalization: Strips font weight and style suffixes (
Bold,Italic,Condensed) to cleanly expose base font family names (e.g., Calibri, Cambria, Bahnschrift, Century Gothic).
4.12 Safari-Style Subpixel Font Rendering
Log Reference: subpixel_rendering_update.txt
- Subpixel Anti-Aliasing: Injected
-webkit-font-smoothing: subpixel-antialiased !importantandtext-rendering: optimizeLegibility !importantacross the webview workspace, mimicking Safari's crisp font rendering. - Vector Precision: Enforced
shape-rendering: geometricPrecision !importantto ensure SVG vectors and line borders calculate precise sub-pixel geometry rather than blurry fast-paths.
4.13 Restored Smooth Image Interpolation
Log Reference: image_interpolation_fix.txt
- Interpolation Restoration: Removed overly aggressive
crisp-edgesflags that previously caused downscaled icons and clipart in ribbon controls to appear jagged and pixelated. Restored Chromium default bilinear/bicubic interpolation, ensuring smooth image scaling while keeping text rendering sharp.
4.14 Dashboard Default Page State Guard
Log Reference: fix_dashboard_initialization_bug.txt
- Problem: Dismissing the template dashboard without selecting a template previously caused the default blank document (A4) to render with missing or corrupted page elements.
- Solution: Added
_isDashboardOpen()checks that bypass premature DOM state serialization while the dashboard overlay is active, preserving default page baselines until the user enters the workspace.
5. Window Management, Shell Integration & Navigation
5.1 Window State, Geometry & Multi-Monitor Persistence
Log Reference: window_state_persistence_update.txt
- Bounds Capture: Encapsulated window coordinate and dimension tracking (
x,y,width,height) with automatic detection of maximized states. - Unmaximized Restoration: When the window is closed while maximized, the system records the pre-maximized dimensions to ensure restoring the window later returns it to the user's custom layout.
- Multi-Monitor Disconnection Guard: Verifies stored coordinates against active desktop screen boundaries on startup. If stored coordinates point to a disconnected external monitor, the window automatically recenters on the primary display.
5.2 Window Shadows, Rounded Corners & Omnidirectional Resizing
Log Reference: shadow_and_corners_update.txt
- DWM Compositing: Activated Windows DWM alpha-channel compositing via
"transparent": trueinpackage.json. - Soft Ambient Shadows: Configured
#app-containerwith 12px rounded corners, a soft ambient drop shadow (0 4px 20px rgba(0,0,0,0.5)), and 40px outer shadow margins. - Omnidirectional Resizing: Engineered 8 perimeter and corner resize handles with smooth dragging logic, enforcing strict minimum window dimensions (800x600).
5.3 Dynamic Titlebar Dirty State Asterisk (*) Indicator
Log Reference: dirty_state_titlebar_update.txt
- Real-Time Dirty Polling: Injected a lightweight comparator that continuously checks the document state against
_lastSavedData. - Non-Destructive Titlebar Marker: When unsaved edits exist, an isolated
#doc-dirty-indicatorspan displays a subtle asterisk(*)adjacent to the document title. The indicator is decoupled from the filename text box, ensuring renaming remains completely unaffected. Saving or exporting immediately clears the indicator.
5.4 Smart Exit Modal with Dirty State Checking
Log Reference: smart_exit_modal_update.txt
- Intelligent Exit Interception: Window close buttons query the webview dirty state before prompting.
- Clean Document Instant Exit: If no unsaved modifications exist since the last save, the application exits immediately without displaying unnecessary confirmation prompts.
- Unsaved Changes Prompt: If unsaved edits exist, the exit modal appears with three distinct actions: "Save", "Don't Save" (discards and quits), and "Cancel".
5.5 Exit Modal Visual Modernization
Log Reference: exit_modal_visual_redesign.txt
- Desktop Standard Styling: Redesigned the "Unsaved Changes" exit warning dialog to match native Windows and macOS aesthetics.
- Proportions: Sized to a compact 380px width with 6px corner radiuses, left-aligned typography, pill-shaped action buttons, and a shaded footer area (#f8f9fa).
5.6 Window Controls Contrast & Auto-Healing Color Fix
Log Reference: window_controls_contrast_and_color_fix_update.txt
- Problem: Window control buttons (theme switcher, minimize, maximize, close) previously defaulted to dark gray against dark or vibrant titlebars, reducing visibility.
- Contrast Auto-Healing: Implemented dynamic luminance evaluation. Window controls automatically compute titlebar background contrast and enforce crisp white (
#ffffff) rendering with glowing hover feedback across all 105 interface themes.
5.7 Topbar Client Controls & Solid Icon Integration
Log Reference: topbar_client_buttons_integration_update.txt
- Integrated Client Tools: Positioned the Export Queue, Presentation Preview, and Previous Versions buttons directly within the primary titlebar adjacent to Recent Files.
- Unboxed Button Styling: Restyled titlebar controls with borderless, translucent glass aesthetics matching the webapp icon language.
- Font Awesome 6 Solid Glyphs: Upgraded titlebar iconography to official FA6 Solid vector glyphs with sub-pixel vertical alignment and responsive auto-hiding on narrow screens.
5.8 Titlebar Recent Documents Dropdown & Native Load Sync
Log Reference: recent_files_feature.txt
- Recent Files Dropdown: Added a compact titlebar dropdown with clock icon and chevron, displaying the last 10 opened publications with document icons, bold filenames, and paths.
- Omni-Channel Recording: Files are recorded when opened via file associations, the in-app file picker, Save As, or when re-opened from the list itself.
- Native Load Synchronization: Opening documents from the dropdown delegates to
handlePublisherFileLoad, perfectly restoring page orientations, custom margins, ruler origins, spread layouts, and AES-GCM password decryption. - Glowing Load Progress: Opening large documents illuminates the bottom status bar with a soft green progress glow and status message ("Loading Document...").
5.9 Titlebar "Show in File Explorer" Action
Log Reference: open_folder_feature_update.txt
- Native Explorer Launch: Added a dedicated folder icon button (
#open-folder-btn) in the titlebar controls. - Item Highlighting: Clicking the button executes
nw.Shell.showItemInFolder(activeFilePath), launching Windows File Explorer and highlighting the open file. Dynamically dims when working in unsaved documents.
5.10 Always-on-Top Window Pinning
Log Reference: pin_window_feature.txt
- Native Pushpin Control: Added a vector pushpin icon in the titlebar controls that toggles the window's float state (
win.setAlwaysOnTop(true/false)). - Engaged State Feedback: When pinned, the button rotates -45 degrees, illuminates in vibrant green (
#4ade80), and displays an inset dark glass badge with hover tooltips. - Responsive Collapsing: Automatically hides on narrow window widths (<980px) to prevent overlapping the document title bar.
5.11 Native Fullscreen Toggle (F11)
Log Reference: f11_fullscreen_update.txt
- F11 Keyboard Interception: Attached global F11 keydown interceptors in both the wrapper shell and inside the webview editor, preventing focus loss from disabling fullscreen toggles.
- Dynamic Layout Adaptation: In fullscreen mode, outer shadow margins and rounded corners are removed, allowing the canvas to utilize 100% of the display while titlebar controls remain layered and accessible.
5.12 Global OS Keyboard Shortcut Restoration
Log Reference: global_shortcut_update.txt
- Universal Hotkey Registration: Registered
Ctrl+Shift+OandCtrl+Shift+P(orCmd+Shift+O/Pon macOS) at the operating system level usingnw.Shortcut. - Instant Foreground Summon: Hitting the hotkey un-minimizes, restores, and focuses OpenPublisher from anywhere in the OS, even if buried beneath other full-screen applications.
- Leak Prevention: Unregisters all global hotkeys cleanly during window close to prevent zombie shortcuts.
5.13 System Tray Integration & Professional Jump List
Log Reference: system_tray_update.txt
- System Tray Icon: Configured
nw.Traywithopenoublisherv5st-icon.png. Left-clicking restores and focuses the window. - Dynamic Jump List: Right-clicking displays a structured menu featuring:
- Dynamic "Hide to Tray" / "Show OpenPublisher" toggles.
- "New Publication", "Open File", and "Recent Files" submenus.
- Direct access to the Backup Manager, Previous Versions, and Developer HUD.
- "Exit OpenPublisher" with clean cascading teardown.
5.14 "Close to System Tray" Preference
Log Reference: close_to_tray_update.txt
- User Preference Toggle: Added a "Close to System Tray" switch in the Developer HUD Preferences section, persisting across sessions in
localStorage. - Close Button Interception: When enabled, clicking the window close button (
X) minimizes the application to the system tray rather than quitting, keeping the app instantly accessible.
5.15 Prevent Accidental Wrapper Selection & Dragging
Log Reference: disable_wrapper_selection_update.txt
- Desktop Shell Feel: Injected universal
user-select: noneand-webkit-user-drag: noneCSS rules across all wrapper chrome elements (Recent Documents list, titlebar buttons, headers, modal overlays). - Protected Canvas Editing: Completely eliminates blue highlight selection boxes and ghost dragging outside the webview while preserving 100% text selection and editing on the canvas.
5.16 Native Taskbar Indeterminate Progress Animation
Log Reference: taskbar_progress_update.txt
- Taskbar Progress API: Utilized
win.setProgressBar(2)to trigger native indeterminate (marquee) progress animations on the OS taskbar during background saves and file writes. - Clean Resolution: Calls
win.setProgressBar(-1)immediately upon write completion, reverting the taskbar icon to normal.
5.17 Taskbar Attention Flashing
Log Reference: taskbar_attention_flash_update.txt
- Completion Notification: Hooked
OP_EXPORT_COMPLETEand atomic save completion blocks to executewin.requestAttention(true). - Taskbar Flashing: Causes the OpenPublisher taskbar icon to flash and glow on Windows, alerting users that their export or save has completed in the background. Automatically stops flashing as soon as the window regains focus.
6. Export, Presentation & Multi-Page Output
6.1 Standalone Export & Print Queue Monitor & Multi-Page Print
Log Reference: export_print_queue_monitor_update.txt
- Tearaway Queue Window (
export_queue.html): A dedicated 720x520 frameless translucent window for tracking background PDF, PNG, and print export operations. - Multi-Page Vector Serialization: Fixed the multi-page print pipeline by routing jobs through the native page serializer, completely bypassing single-page canvas rasterizers and ensuring high-resolution vector print spooling.
- Progress Tracking: Real-time progress bars, percentage indicators, job histories, and "Open in Folder" actions.
6.2 Standalone Document Presentation Preview
Log Reference: document_presentation_preview_update.txt
- Presentation Window (
doc_preview.html): An independent, distraction-free window that mirrors the active OpenPublisher canvas in real time. - High-Fidelity Scaling: Perfect for secondary monitors or projectors, offering live slide navigation and fullscreen presentation modes.
6.3 Scoped Teal-on-Dark Custom Scrollbars
Log Reference: custom_teal_dark_scrollbars_update.txt
- Scoped Scrollbar Aesthetics: Replaced default OS scrollbars in
export_queue.htmlanddoc_preview.htmlwith a custom teal-green on dark slate scrollbar theme (#14b8a6thumbs with soft hover states). Strictly scoped to auxiliary windows to protect main canvas scrollbars.
6.4 OS Process Priority Elevation During Exports
Log Reference: export_priority_elevation_update.txt
- Kernel Priority Management: Utilizes the Node.js
osmodule inside export IPC handlers. - Priority Elevation: Intercepts
OP_EXPORT_STARTto elevate process priority toPRIORITY_ABOVE_NORMAL, granting rendering threads maximum CPU scheduling for faster exports. Automatically reverts toPRIORITY_NORMALonOP_EXPORT_COMPLETE.
6.5 Native Dock and Taskbar Export Progress Bars
Log Reference: export_progress_native_bar.txt
- Real-Time Numeric Progress: Intercepts
OP_EXPORT_PROGRESSand feeds normalized floating-point percentages (0.0 to 1.0) intowin.setProgressBar(progress). - OS Feedback: Renders smooth, real-time progress bars directly on the Windows Taskbar and macOS Dock icons throughout heavy PDF and image rendering passes.
7. Visual Identity, Themes & Onboarding
7.1 Interactive Glassmorphic First Run Wizard
Log Reference: first_run_wizard_update.txt
- 8-Step Onboarding Tour: A high-contrast glassmorphic tour welcoming new users, highlighting the Ribbon, WordArt, clipart gallery, templates, themes, and the
.opubformat. - Design Details: Deep slate/teal frosted glass (
rgba(8, 28, 32, 0.9)), 36px backdrop blur, specular bevel highlights, and an interactive 8-step pill progress stepper. - Interactive Theme Switcher (Slide 6): Users can preview themes directly inside the wizard, switching between Auto-Cycle GIF, Dark Mode (6 genuine variants), and Light Themes with dynamic frame lighting.
- Confetti Celebration: Concluding the tour with "Get Started" launches a 1.2-second particle confetti burst with physics simulation.
- CLI Flags: Supports
--firstrun,--wizard, and--reset-firstrunstartup flags for testing and re-onboarding.
7.2 Unified Flow UI Splash Screen & Boot Progress Synchronization
Log Reference: unified_splash_screen_update.txt
- Dual Splash Elimination: Completely eliminated the legacy secondary web splash screen.
- Flow UI Redesign: Features a faceted geometric vector backdrop, diagonal glass shards, ambient highlight lines, a halftone dot matrix grid, and a radiant mint-to-cyan progress bar.
- Boot Sync: Accurately mirrors real-time subsystem initialization logs without duplicate entries or backwards progress jumps.
7.3 Adaptive Startup Screen Modernization
Log Reference: startup_screen_v5_modernization_update.txt
- Dual-Theme Startup Engine: The startup screen automatically switches between signature elevated teal for light themes and a pro dark studio slate theme when dark mode is enabled.
- Official V5 Assets: Replaced legacy V4 printer icons with official V5 SVG vector branding.
7.4 Dynamic OS Edition Detection & Splash Iconography
Log Reference: dynamic_os_edition_update.txt
- Platform Detection: Detects
process.platformdynamically (win32,darwin,linux,freebsd). - Dynamic Branding: Updates splash footer branding synchronously ("OpenPublisher V5 Windows Edition", "Mac Edition", "Linux Edition", "FreeBSD Edition").
- Platform Icon Array: Illuminates the detected OS icon (including the FreeBSD daemon logo) in glowing teal while dimming alternative platform emblems.
7.5 Dynamic Theme Synchronization & Cross-Session Persistence
Log Reference: dynamic_theme_sync_update.txt
- Persistent Webview Partition: Switched to
<webview partition="persist:trusted">, ensuring user preferences survive application exit. - Zero-Flicker Startup Restoration: An early synchronous
<head>script loadsop_saved_themefromlocalStorageand applies--bg-colorand--accent-colorbefore DOM render, completely eliminating startup teal color flashing.
7.6 Client Modal & HUD UI Overhaul
Log Reference: hud_ui_update.txt
- Design Unification: Redesigned all wrapper modals (Exit modal, Confirm Reload, HUD) to match native InApp dialog design language: 46px header profiles, 12px border radiuses, 22px SVG cross icons, and signature
#d35450hover states.
8. Developer Mode, Diagnostics & Easter Eggs
8.1 Developer Mode Subsystem & UI Live Reload
Log Reference: developer_mode_update.txt
- Universal Hotkey (
Ctrl+Shift+D/Cmd+Shift+D): Toggles the floating Developer HUD from any application context with debounced safety cooldowns. - Live UI File Watcher: Uses Node.js
fs.watchto monitor project CSS and interface files, automatically triggering smooth UI reloads when edits are detected while ignoring document saves.
8.2 Standalone Tearaway Pop-Out Developer HUD
Log Reference: dev_hud_tearaway_popout_update.txt
- Tearaway Pop-Out Window (
hud.html): Clicking "Pop Out" opens the Developer HUD in an independent, frameless desktop window that can be dragged across multiple monitors. - Hardware Dragging: Supports zero-latency OS window dragging via
-webkit-app-region: dragwith JavaScript fallback positioning. Clicking "Dock" returns the HUD into the main window.
8.3 Real-Time Bidirectional IPC Traffic Sniffer
Log Reference: dev_hud_ipc_traffic_sniffer_update.txt
- Bidirectional Monitoring: Intercepts outbound (
webview.executeScript) and inbound (consolemessage) IPC traffic in real time. - Compact Badges: Streams events into the HUD terminal and DevTools console with uniform 14px pill badges (
[IN]teal,[OUT]sky blue,[SYSTEM]yellow). - Preference Persistence: Configured via a "Log IPC Traffic" toggle in HUD Preferences, saved to
localStorage.
8.4 Memory Footprint Bar Chart & Live Rate Monitor
Log Reference: dev_hud_memory_chart_update.txt
- Dynamic Min-Max Auto-Zoom: Auto-scales memory snapshot bar heights between active 20-sample minimums and maximums, making small allocations (200 KB) and garbage collection visible as distinct waves.
- Live Rate Readout: Displays real-time allocation rates per second (+KB/s [UP], -KB/s [DOWN] (GC), or 0 KB/s (Steady)) with min-max megabyte spans.
- Flicker Fix: Composited with
transform: translateZ(0)andcontain: paintto eliminate dirty-rect rasterization artifacts.
8.5 Developer HUD "Open AppData" Quick Action
Log Reference: open_appdata_button_update.txt
- One-Click Explorer Action: Added an "Open AppData" button to HUD Quick Actions that executes
nw.Shell.showItemInFolder(nw.App.dataPath), opening File Explorer directly to Chromium local storage and cache directories.
8.6 Microsoft Agent (Clippy) Assistant Integration
Log Reference: clippy_remote_assistant_update.txt
- Zero Local Bundling (Remote MKLab Architecture): Absolutely zero proprietary Microsoft Agent assets, models, or sounds are bundled locally or hosted on openpublisher.app. When summoned from
File -> Help, assets are fetched directly at runtime from the MKLab community project. - Ribbon Button: Positioned in
File -> Helpwith theme-colored vector styling and a connecting pulse indicator. Includes offline watchdog modals if remote servers are unreachable. - 41-Animation Event Matrix: Fully wired into user actions:
- Save, Writing, Print, SendMail, GetWizardy, Thinking, Congratulate, CheckingSomething, EmptyTrash, Searching, Alert, and Screen Knocking after inactivity.
- Directional gaze tracking follows mouse cursor movements across the canvas.
- 101-Tip Knowledge Library: Delivers productivity tips across 8 context domains (clipart, shapes, text, tables, guides, export, proofing, canvas tools). Clippy detects active tools to deliver relevant advice.
- Controls & Filters:
- Speech balloons feature [Yes]/[No], [Next Tip], and 20-second countdown timer bars with hover pause protection.
- Double Size (2x) and Regular Size modes with zero drag offset.
- CRT Blender Filter with phosphor bloom and unsharp masking for retro authentic visuals.
Thank you for trying OpenPublisher V5.1.0!