Changelog

All notable changes to FlexGrid will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Reconstructed on 2026-04-23 from git history (55 commits, no tags). Confirm accuracy before treating as authoritative.

[Unreleased]

Added

• UX overhaul: brand unification (flexGrid prefix), enum-based sheet management, paywall comparison table, persona-based menus, user data export/import (2026-04-23)
• Polish audit: confirmations on destructive actions, accessibility improvements, drag support, error clarity, macOS nativeness (2026-04-20)
• Post-polish audit: contextual error states, markdown onboarding, dynamic versioning (2026-04-20)

Fixed

• Semantic colors, onboarding copy, showcase variant stability, clearAll reliability (2026-04-15)

Pre-release Development History

Grid-First Startup & Showcase Reliability (2026-04-15)

• App always starts in Grid mode — showcase only on explicit user click
• Fixed showcase exit (Grid button, Exit Showcase) so it sticks
• Fixed pool exhaustion silently hijacking user’s chosen layout
• Per-cell AR matching (ContentStream.buildBatch calls pickForSlot)
• Instant playback — removed isScanning gate
• Smart Media Filter: content-aware segmented picker
• Vision Tags and OCR search moved to menus
• Large folder warning raised to 10,000 files

Smart Layout Presets & Showcase Overhaul (2026-04-15)

• Three content-aware layout buttons (A/B/C): Portrait Gallery, Landscape Theater, Uniform Stack
• Showcase mode rewritten with slot-based role assignment
• 4-tier AR classification (portrait/near-portrait/square/landscape)
• Aspect Match system (Preferred/Strict, per-cell or grid-wide)
• Pool exhaustion handling with user-selectable modes

ContentStream & Masonry Expansion (2026-04-11)

• ContentStream batch navigation
• Expanded masonry templates
• Hardened cell/fullscreen reliability

Vision Expansion & Interactive Cells (2026-04-10)

• 6 new Vision classifiers: Feature Print, Lens Smudge, Horizon Tilt, Brightness, Monochrome, Letterbox
• Composite/collage detection via shared pixel buffer
• MetadataCache format version 6
• Analysis Progress Pill, Active Filter Pill
• Lava Lamp mode, Smart Captions, Siri & Shortcuts (9 intents)
• File Relinker, About View
• Subject Zoom expanded to 6 modes
• Beta HQ panel for testers

v1 Focus Shift (2026-04-11)

• Disabled: Masonry, SmartFlex, Canvas, SmartGrid, Lava Lamp, Mood Board Export, Mood Matching
• All Pro features marked experimental
• Control bar reorganized into Grid/Cells groups

Shuffle & Performance Hardening (2026-04-09)

• Fixed shuffle beachball on large datasets
• Scan progress quips and shuffle-ahead buffer
• Feedback view, velour animator
• O(1) LRU caches, eliminated redundant filesystem stats

Pick Tray & Fullscreen Enhancements (2026-04-08)

• Pick Tray (Plus): P key flagging, picks drawer, grid filter
• Fullscreen: configurable dim/blur, background pause, session-persistent volume
• Simultaneous audio option
• Consolidated cell overlay toolbar
• Eliminated all UI freezes
• Fixed grid drag-reorder

Documentation & Code Audit (2026-04-08)

• Free tier confirmed at 9 tiles (code aligned to docs)
• Deployment target lowered from macOS 26.0 to 15.0
• Fixed 3 force-unwrap crash risks, BeatDetector data race
• Fixed NotificationCenter observer leaks
• SmartShuffle initial computation moved off MainActor

Major Feature Additions (2026-04-07)

• Click behavior customization, SmartShuffle naming, window padding
• Canvas mode, SmartFlex grid, scheduling, Vision analysis
• Persistent metadata cache with batch operations
• Fixed 25+ bugs including delayed playback, KVO race conditions, cell swap starvation
• Fixed blank cells after looping, beachball on initial load
• Fixed Swift 6 concurrency warnings, priority inversion hang

Large Updates (2026-04-04 – 2026-04-05)

• Major feature additions and updates

Performance & Stability (2026-02-28 – 2026-03-28)

• Optimization passes and bug fixes

Initial Development (2025-09-18 – 2025-09-25)

• Initial commit and early feature development
• Added Pro features
• Core grid, playback, and shuffle functionality

Migrated Sources

• Git log (55 commits, 2025-09-18 to 2026-04-23)
• _archive/HELP_AND_PROMOTIONAL_MATERIALS.md §6 Change Log of Product Truth