v4.1.0

4.1.0 (v4.1.0) — 2026-09-02

Browse Collections & Discovery UI/UX Overhaul

• Horizontal Mouse Wheel & Drag Scrolling: Enabled smooth horizontal scrolling on #categoriesGrid with mouse wheel controls, mouse drag-to-scroll, and left/right navigation arrows (#categoriesPrevBtn, #categoriesNextBtn).
• 3D Card Aesthetics: Upgraded collection cards with 3D hover elevation (translateY(-6px) scale(1.03)), smooth cover image zoom (1.1x), glowing glassmorphic count badges (⚡ 8), and active selection highlight rings (.active-selected).
• "View All Collections" Frosted Blur Explorer Modal: Added a section header flex bar with a total collection count badge (#collectionsCountBadge) and a "View All Collections →" action button opening a full-screen frosted glass backdrop blur modal (#allCollectionsModal). Includes live search (#modalCollectionSearch) across all collections with thumbnail cover art and wallpaper counts.

Search Auto-Complete & Weighted Ranking Engine

• YouTube-Style Auto-Complete Suggestions: Added a real-time auto-complete dropdown (#searchSuggestionsDropdown) below #globalSearchInput showing matching Collections, Tags, and Wallpaper Titles with query term highlighting (.suggestion-highlight) and full keyboard navigation (Up/Down arrows + Enter).
• Weighted Search Relevance Engine: Implemented relevance scoring for search terms (+100 tag match, +90 collection match, +80 title match, +15 description match), dynamically sorting gallery results by relevance score descending.
• Top Searches & Randomizer: Relocated popular search tags to a "🔥 Top Searches" header bar equipped with a 🎲 Shuffle button to randomize tag suggestions dynamically.

4-Table Database Architecture Migration & Optimization

• Database Simplification: Migrated database down to 4 core tables (wallpapers, collections, tags, wallpaper_collections, wallpaper_tags), eliminating legacy ai_jobs, collection_keywords, categories, and obsolete columns (status, confidence, indexed_at, characters, franchises, styles, moods, other_attributes, ai_confidence, nsfw).
• Prisma ORM Integration: Added web/prisma/schema.prisma mapping the 4 core models with @prisma/client.
• Image & Data Safety Guarantee: 100% of wallpaper records, metadata, titles, descriptions, collection assignments, tags, and images in the Supabase storage bucket (wallpapers/) were safely preserved.
• Resilient Image Downloader: Wrapped image downloads in defensive try/catch checks to handle missing CDN files (404) gracefully without interrupting wallpaper downloads or crashing the desktop sync process.

v4.0.0

4.0.0 (v4.0.0) — 2026-08-02

Pre-configured Default Fallback Sync Token

• Authentication Fix for New Systems: Set sync_secret_token_123 as the default fallback token in config.js to ensure fresh, packaged client installations authenticate with the Vercel API seamlessly. Prevents the app from throwing a 401 Unauthorized block on other users' PCs now that the settings forms are removed from the client UI.

Restore Panels & Drag-and-Drop

• Settings Visibility: Restored the #maintenanceSection and #dragHintSection visibility for production/packaged environments (which was temporarily disabled in 3.7.0).
• Drag-and-Drop Local Upload: Restored drag-and-drop listeners to handle files dropped onto the Electron window, copying them to the local workspace image folders via IPC and reloading the gallery grid.

Removed Server Settings Form

• HTML & JS Clean Up: Extracted the "Server Settings" input fields and "Save Settings" button from the collapsible sidebar panel to keep the interface focused. Settings variables and backend sync connection read configurations still run in the background.

Resolved Collection Creation API Bug (Admin Web Server)

• Database Insertion Fix: Modified the Next.js POST API handler in collections route.ts to extract category_id from the payload and insert it into Supabase, avoiding orphaned collections that failed to appear under their categories.

v3.9.0

3.9.0 (v3.9.0) — 2026-08-02

Restore Panels & Drag-and-Drop

• Settings Visibility: Restored the #maintenanceSection and #dragHintSection visibility for production/packaged environments (which was temporarily disabled in 3.7.0).
• Drag-and-Drop Local Upload: Restored drag-and-drop listeners to handle files dropped onto the Electron window, copying them to the local workspace image folders via IPC and reloading the gallery grid.

Removed Server Settings Form

• HTML & JS Clean Up: Extracted the "Server Settings" input fields and "Save Settings" button from the collapsible sidebar panel to keep the interface focused. Settings variables and backend sync connection read configurations still run in the background.

Resolved Collection Creation API Bug (Admin Web Server)

• Database Insertion Fix: Modified the Next.js POST API handler in collections route.ts to extract category_id from the payload and insert it into Supabase, avoiding orphaned collections that failed to appear under their categories.

v3.8.0

3.8.0 (v3.8.0) — 2026-08-02

Restore Panels & Drag-and-Drop

• Settings Visibility: Restored the #maintenanceSection and #dragHintSection visibility for production/packaged environments (which was temporarily disabled in 3.7.0).
• Drag-and-Drop Local Upload: Restored drag-and-drop listeners to handle files dropped onto the Electron window, copying them to the local workspace image folders via IPC and reloading the gallery grid.

Removed Server Settings Form

• HTML & JS Clean Up: Extracted the "Server Settings" input fields and "Save Settings" button from the collapsible sidebar panel to keep the interface focused. Settings variables and backend sync connection read configurations still run in the background.

Resolved Collection Creation API Bug (Admin Web Server)

• Database Insertion Fix: Modified the Next.js POST API handler in collections route.ts to extract category_id from the payload and insert it into Supabase, avoiding orphaned collections that failed to appear under their categories.

v3.7.0

3.7.0 (v3.7.0) — 2026-08-02

Release Verification & Build Testing

• Minor Version Bump: Incremented application version to 3.7.0 for release pipeline and installation package validation testing.

v3.6.0

3.6.0 (v3.6.0) — 2026-08-01

Network Egress & ETag Caching

• Resilient ETag Validation Caching: Implemented conditional HTTP cache validation utilizing dynamic ETags built from database counts, latest creation times, and row metadata fingerprint hashes (representing ids, titles, collections, and tags). Bypasses 100% of body download payloads on both the web client and the desktop Electron client by returning 304 Not Modified when database contents are unchanged, saving database CPU and outbound network bandwidth budget.
• Client Cache Synchronization: Updated the desktop synchronization service (metadataCache.js) to persist ETags locally and attach them to sync check cycles, eliminating redundant offline calculations and disk writes.

Resiliency & Schema Fallbacks

• Database Schema Resiliency: Added dynamic fallback query retry blocks in backend API routes. If the database schema is missing updated columns (like primary_color) or tables (like reviews), the endpoints gracefully warning-log and retry/fallback to return successfully rather than failing with 500 Internal Server Error, ensuring the site operates seamlessly before/during migrations.
• Next.js Image Layout Stability: Decoupled container layout styles from raw image attributes inside the React OptimizedImage component, resolving runtime clashing errors with Next.js's absolute fill property.

CDN & Performance Upgrades

• ImageKit Private S3 Path Resolution: Enabled path-style URL formatting for ImageKit external storage origins, allowing it to correctly read private files in the root of the Supabase S3 S3-Compatible bucket.
• LCP Loading Optimizations: Eagerly loaded above-the-fold wallpaper grid items using Next.js image priority flags, eliminating Largest Contentful Paint browser alerts.

Desktop Client Refactoring

• Category-to-Collection UI Migration: Restructured the horizontal explorer grid inside the Electron client app to browse "Collections" rather than "Categories". Displays computed wallpaper counts per collection and assigns the first item's thumbnail as the card's visual background cover.

v3.5.0

3.5.0 (v3.5.0) — 2026-07-17

Desktop Client Enhancements

• UI Modularization (ES Modules): Cleaned up and restructured the ui directory, refactoring the 1700+ line app.js file into independent modules (utils.js, slider.js, gallery.js, drawer.js, player.js, modal.js) coordinated by a centralized state store (store.js).
• Smart App Control & Antivirus Bypass: Enabled ASAR packaging and configured electron-builder to sign builds using cscLink and cscKeyPassword. Created a local PowerShell signing utility (scripts/create-self-signed-cert.ps1) to sign builds and bypass Windows Smart App Control (SAC) and Defender blocks on development/test environments.

v3.4.0

3.4.0 (v3.4.0) — 2026-07-15

Architectural Simplification

• Converted metadata synchronization into a clean, one-directional client pull from the server (Server -> Client).
• Removed the local offline queueing and database write/upload features from the desktop client to make metadata management strictly server-centric.

Desktop Client UI & Experience

• Replaced select dropdowns and checklist checkboxes in the details drawer with premium, read-only labels and static tag badges.
• Removed '#' prefix formatting from tags across all filters and badges (displaying tag names like "nature" directly).
• Removed the inline creator modal and creator buttons from the client.

Bug Fixes

• Fixed a search filtering bug by adding file_name to the local cache and modifying fuzzy search matching to check original human-readable file names (meta.file_name) rather than only hashed local filenames.

v3.3.0

3.3.0 (v3.3.0) — 2026-07-14

Desktop Client UI & Experience revamps

• Repositioned search results directly underneath the search bar by hiding home dashboard rows dynamically during active searches.
• Embedded corner quality badges (4K, HD) and visual style tags directly overlaying gallery cards.
• Clamped tags list in horizontal cards to a maximum of 3 chips plus an elegant +x overflow badge.
• Added desktop-level notification/toasts for manual and background library synchronizations, rotation events, and connection alerts.
• Integrated content-visibility: auto to optimize scrolling performance and minimize browser layout repaint memory costs.

Official Landing Page & Technical Docs

• Redesigned the landing page to feature a unified, simplified release container instead of separating stable and beta.
• Featured the new Gemini 2.5 Flash indexing engine capabilities directly in the hero layout.
• Added comprehensive technical documentation covering base64 indexing architectures, db constraints, tray sync parameters, and offline fuzzy search logic.

v3.2.3

3.2.3 (v3.2.3) — 2026-07-14

Robustness & Download Optimizations

• Implemented atomic downloads using temporary files (.tmp) to prevent corrupted/partial wallpaper files.
• Added automatic detection and deletion of 0-byte or corrupted local files.

Metadata Sync Progression & Fullscreen Support

• Added a detailed metadata sync progress modal in the UI with status descriptions and progress bar.
• Connected IPC events to update status spinner, success checkmark, or error indicators dynamically.
• Implemented automatic metadata sync triggers when the desktop client goes into full screen.

Client UI Enhancements

• Redesigned the details drawer actions (Apply, Favorites, Delete) with premium SVG icons, animations, and hover micro-interactions.
• Fixed a bug where categories, collections, and tags were not dynamically refreshed upon sync completion.