Changelog

Added

• 📄 Added .xls support in document analysis and extraction flows
• 📬 Added automated Telegram metrics digests for release monitoring

Improved

• ⚡ Improved failed-processing retry flow and error visibility
• 📊 Improved metrics digest calculations and reporting consistency

Fixed

• 🛡️ Hardened Paddle webhook signature validation and retry handling
• 🩹 Reduced noisy monitoring/Sentry events in backend processing

Added

• 📊 Added TelemetryDeck funnel tracking for first rename flow
• 🌍 Added country to new install Telegram notifications

Improved

• ⚡ Kept AI Rename prompt visible until valid files are actually added
• 🔔 Added explicit consent and unsupported-file feedback in AI Rename
• 🧭 Added deferred dropped-file recovery through onboarding and consent setup

Fixed

• 🐛 Fixed duplicate new install notifications from concurrent status checks
• 🩹 Reduced duplicate status refreshes during app launch
• 🔧 Captured processing failures in Sentry for analysis and rename flows

Added

• 🎉 Added AI-powered document renaming for supported files
• 📄 Added native PDF text extraction with visual fallback
• 🗂️ Expanded Zush from image rename to file rename

Improved

• ⚡ Improved supported file handling across batch rename, monitor, and hotkey flows
• 🖼️ Restored PDF previews in the batch rename list
• ✏️ Updated app copy and onboarding text for file-based workflows

Fixed

• 🐛 Fixed legacy .doc and .ppt fallback analysis
• 🐛 Fixed document placeholders and thumbnail handling in batch rename
• 🔧 Updated CI to match the local Xcode 26.3 toolchain

Fixed

• 🐛 Fix batch hangs and use PDF thumbnails
• 🐛 Stabilize app store IAP verification and clean legacy purchase objects
• 🐛 Retry analyze provider timeouts
• 🐛 Harden file hashing and analyze timeouts
• 🐛 Refine welcome copy
• 🐛 Restore data consent view wiring
• 🐛 Replace any types, extract subscription status helper
• 🐛 Keychain access refactoring

Added

• 🎉 Implemented custom AI prompts for image analysis
• 🔑 Implemented comprehensive data consent management
• 📦 Integrated StoreKit for promoted purchases in App Store version

Improved

• ⚡ Enhanced AI prompt customization and error handling
• ⚡ Enhanced data consent handling in welcome flow
• ⚡ Improved StoreKit product loading with retry logic
• ⚡ Improved SVG rendering for AI analysis and recognition

Fixed

• 🐛 Restored AI prompt base for image analysis
• 🐛 Fixed custom output language not being applied correctly with custom AI prompts
• 🐛 Prevented onboarding window from freezing
• 🐛 Stabilized App Store IAP verification and cleaned up legacy objects
• 🐛 Show data agreement only for App Store builds
• 🔧 Adopted Liquid Glass toolbar on macOS 26

Added

• 🎉 Added appearance preference settings with UI integration

Improved

• ⚡ Refactored LicenseService for better tier management

Fixed

• 🐛 Fixed settings window title visibility issue
• 🔧 Refactored SettingsTabView layout for better organization

Added

• 🎉 Introduced activity and processing tabs with UI enhancements
• 🖼️ Added brand color support and updated UI components
• 🔑 Added license upgrade option to settings
• 🔔 Updated app menu to reflect onboarding status

Improved

• ⚡ Enhanced onboarding flow and window management
• ⚡ Improved UsageScale layout in settings
• 🔄 Updated drop area behavior in BatchRenameSection

Added

• 🎉 Enhanced debug and settings management features added
• 🔑 App Store version now sandboxed with updated entitlements

Improved

• ⚡ Updated hotkey instructions for App Store version
• ⚡ Improved license and store kit services

Fixed

• 🐛 Fixed project file references for Zush.storekit

Added

• 🎉 Unlocked all PRO features for FREE account (except BYOK)
• 🎉 Enhanced onboarding experience and debug features
• 🖼️ Added unit tests for AI analysis and bookmark persistence
• 🔑 Added debug section in preferences

Improved

• ⚡ Improved settings management in AppDelegate and SettingsViewModel

Fixed

• 🐛 Adjusted Finder layout script for DMG creation

Added

• 🖼️ Added tests for Zush functionality

Improved

• ⚡ Improved image analysis order in AI Service
• ✏️ Updated documentation with new features and architecture details

Added

• 🎉 Implemented lifetime credit model for Zush
• 🔑 API keys are now securely stored in Keychain
• 🖼️ Added Help menu link to zushapp.com
• 📦 Track app version in devices table

Improved

• ⚡ Enhanced AIService with better error handling and BYOK support
• ⚡ Streamlined API key clearing in BYOK section
• ⚡ Optimized device activation and rate limiting logic

Fixed

• 🐛 Redirect PRO users to BYOK tab when limit is reached
• 🐛 Fixed BYOK banner visibility based on active setting
• 🐛 Hardened edge functions with encryption and rate limiting

Added

• 🎉 Implemented BYOK (Bring Your Own Key) for unlimited processing
• 🔑 Added support for OpenAI and Claude in BYOK
• 💎 Added Zush PRO one-time purchase option
• 🚀 Added force update options to release script

Improved

• ⚡ Enhanced DeviceService for better device ID management
• ⚡ Improved BYOK functionality and UI
• ⚡ Updated UI for simplified pricing model

Fixed

• 🐛 Fixed checkout URL and simplified LicenseService logic
• 🐛 Fixed AI provider defaults for processed files
• 🐛 Hid 'Get More Credits' for PRO users

Added

• 📂 Added directory access for hotkey file processing in sandboxed environments
• 🔑 Implemented directory access for batch renaming in sandboxed environments

Improved

• ⚡ Improved asynchronous initialization and device ID retrieval

Added

• 🚀 Distribute Zush on the Mac App Store
• 🔑 Verify App Store subscriptions with Supabase function
• 📦 Upload dSYMs to Sentry during release for better crash reporting

Improved

• ⚡ Improved folder validation by moving it to a background thread

Fixed

• 🎨 Updated app icon assets for better consistency

Added

• 📂 Enhanced file monitoring and processing indicators

Improved

• ⚡ Improved folder monitoring and file processing
• 🎨 Updated color scheme in HotkeyRecorder and SuggestedShortcuts views
• 🔄 Streamlined activity display and undo functionality

Fixed

• 🐛 Adjusted window height in build-dmg script for better layout

Added

• 🎉 Added quick rename shortcut for Finder files
• 🖼️ Added monitor options section with file prefix filter
• 🔑 Added symlink for Supabase Postgres best practices

Improved

• ⚡ Improved layout and text in Hotkey settings
• 🚀 Enhanced Finder file selection with timeout handling
• 📈 Optimized Supabase database performance and RLS policies
• 💚 Updated App logo

Fixed

• 🐛 Prevented potential out-of-bounds access in HotkeyService
• 🎨 Updated design credit color in AboutTab view

Added

• 🚀 Added Sentry crash reporting and error analytics
• 🔑 Added missing database indexes for query optimization

Improved

• ⚡ Improved ViewModel guidelines with data persistence and accessibility

Fixed

• 🐛 Addressed code review issues with constants and error handling

Added

• 🖼️ Implemented onboarding permissions view for new users
• 🔑 Allow subscription downgrades for existing users

Improved

• ⚡ Updated upgrade modal UI with plan comparison layout
• 🔔 Enhanced notification handling throughout the app
• 📈 Updated credit display and license status on activation

Fixed

• 🐛 Reordered menu items and removed unnecessary key equivalents

Added

• 🎉 Credit-based pricing model for flexible usage
• 🔑 Support for original name token in file renaming
• 🖼️ Date format support for file renaming

Improved

• ⚡ Enhanced license upgrade flow with URL parameters
• ✏️ Clarified ProModal feature description for localization
• 📈 Improved email validation in customer portal

Added

• 🎉 Implemented monthly Pro Upgrade flow for users
• 🖼️ Added color scheme support and enhanced progress view styling

Improved

• ⚡ Enhanced SettingsViewModel with monitoring paths

Fixed

• 🐛 Updated ProModal description for accurate language support count

Added

• 🎉 Implemented batch renaming functionality for improved file management
• 🔔 Added success notification for batch renaming operations
• 📂 Implemented folder monitoring during onboarding
• ✨ Introduced confetti animation for visual feedback
• 🔊 Added batch rename completion notification sound

Improved

• ⚡ Enhanced URL handling and ProModal display logic
• ⚡ Improved settings modal behavior with ProModal integration
• ⚡ Enhanced onboarding process with notifications

Fixed

• 🐛 Fixed display issues in ActivationSuccessModal

Added

• 🎉 Implemented limit exceeded alert with dynamic messaging
• 🖼️ Added onChange handlers to save naming pattern settings

Improved

• ⚡ Optimized WindowManager settings window handling
• ⚡ Improved memory management for SwiftUI views

Added

• 🖼️ Added support for RAW image formats
• 💬 Added Canny feedback link in About Tab and update tab's design

Improved

• ⚡ Improved batch image analysis with individual processing
• ⚡ Enhanced batch analysis with timestamps and progress tracking
• ⚡ Improved AI service error handling with localized descriptions

Fixed

• 🐛 Fixed deployment on build failure in release script

Added

• 🎉 Implemented batch file processing limits with alerts

Improved

• ⚡ Optimized image loading and thumbnail generation for better quality
• 🎨 Updated rename text field with hover and focus styling
• ✏️ Updated Spotlight feature descriptions to use 'metadata'

Added

• 🎉 Implemented folder monitoring with a new Monitor tab
• 🚀 Added Groq provider support for AI image analysis
• ✨ Introduced image thumbnail previews in file lists
• 🔔 Added dock icon visibility preference in settings
• 🖼️ Added output language setting for AI-generated file names
• 📂 Added drag & drop and custom scheme URL support for files

Improved

• ⚡ Enhanced batch renaming with analysis and progress tracking
• ⚡ Added pause functionality and status bar icon handling
• 🎨 Improved UI components for language selection and Pro features

Added

• 🎉 Added Groq provider support for enhanced AI processing
• 🖼️ Added image thumbnail previews in file list items
• 🔑 Added dock icon visibility preference with settings management
• 📂 Added folders monitoring toggle in settings
• 🌐 Added offline mode handling with network status monitoring

Improved

• ⚡ Improved file handling with drag & drop and custom scheme URLs

Added

• 🎉 Added SVG, PDF, and TIF file format support
• 🚀 Implemented activity tab with undo functionality
• 📦 Added chunked processing for batch rename
• 🖼️ Added analyzing text to batch rename items

Improved

• ⚡ Refactored about tab and updated naming pattern variables
• ⚡ Refined activity and batch rename UI
• ⚡ Simplified menu bar usage view with tier name and counter
• ⚡ Show settings window on launch and dock click
• ⚡ Unified file list items with shared FileListItemView component

Fixed

• 🐛 Added white background for SVG and PDF rendering to JPEG
• 🐛 Prevented file re-processing after undo
• 🐛 Fixed open panel permissions on welcome screen

Added

• 🖼️ Show floating settings window after onboarding
• 🔔 Added notification, URL handling, window management services
• 📂 Added naming pattern and smart metadata sections to processing queue
• ✨ Added email validation and refined success message UI

Improved

• ⚡ Improved pro modal limit message and menu bar upgrade visibility

Added

• 🎉 Implemented free tier folder watch limits and pro status UI
• 🖼️ Added advanced filename pattern options with live preview

Improved

• ⚡ Reorganized settings tabs for better user experience
• 🛠️ Improved filename sanitization for better file handling

Added

• 🎉 We now ship Zush as a .dmg file instead of a .zip for easier installation.
• 🖼️ Zush now sends lower quality images for AI analysis to improve performance.
• 🔑 Pro features, the general tab, and the onboarding views now have a new primary button style.
• 🔔 You'll now receive update notifications and dock badge updates thanks to the new update management system.

Improved

• ⚡ Refined onboarding view layout and styling, including path shortening.

Added

• 🎉 Welcome onboarding screen for first-time users
• 📂 Folder selection during onboarding
• 📍 Menu bar location hint for new users
• 🔔 Notification when monitoring starts
• ✏️ Change watched folder button in settings

Fixed

• 🐛 Screenshot detection for macOS temp files

Added

• 🔄 Batch image analysis with processing queue
• 🖼️ Image compression service

Improved

• 📊 Display AI usage count in General tab
• 🎨 Pro features view layout optimization
• 🔖 Exclude color names from AI tags
• 📁 Auto-detect macOS screenshot folder

Added

• ✨ Added automatic update checking via Sparkle
• 🔄 Check for Updates option in Settings and Menu Bar
• ⚙️ Automatic updates toggle

Initial Release

• 🚀 First public release of Zush
• 🤖 AI-powered image organization with automatic tagging
• 📁 Smart folder monitoring for new images
• 🏷️ Automatic Finder tags based on AI analysis
• 📝 Custom naming patterns for organized files
• 🎨 Beautiful native macOS interface