Release Notes - v1.5.0

[Christian Jay]

WealthSnap v1.5.0 - Release Notes

Release Date: January 25, 2026

Build: Version 1.5.0 (Major Architecture Update)

[!CAUTION] ⚠️ CRITICAL: BREAKING CHANGES

This update includes a major refactor of the internal storage system ("Centralized KEYS"). Please BACKUP your data before updating.

Known Impacts:

1. Security PIN Reset: Your saved PIN code will be reset. You will need to re-enable security and set a new PIN.
2. Encrypted Data Reset: The internal encryption key alias has changed. Any sensitive data encrypted with the old key may become unreadable.
3. AI Configuration: Your Gemini API Key will be reset. Please re-enter it in Settings.

We apologize for the inconvenience. This change ensures a much more stable and maintainable system for the future.

---

✨ What's New⚡ Interactive Notifications (Background Mode)

We've supercharged our reminder notifications to handle actions seamlessly, even when the app is closed.

📱 True Background Actions

• Complete Instantly: Tapping "Complete" on a notification now marks the reminder as done and schedules the next occurrence without opening the app.
• Smart Snooze: Tapping "Snooze" dismisses the notification immediately. The reminder stays pending and will appear in the "Catch-up" list differently when you next open the app.
• Zero Interruption: No more jarring app launches just to check off a habit. Stay focused on what you're doing.

🏠 Enhanced Home Screen Experience

We've supercharged the Home Screen with more control and flexibility over how you view your finances.

⚙️ Display Settings

• New Settings Toggle: Added a gear icon to the header that opens a dedicated settings menu.
• Customizable Views: You can now choose between "Overall" (Lifetime) and "This Month" views for your Income and Expenses.
• Persistence: Your preference is saved effectively immediately—set it once and it stays that way.

💳 Swipeable Balance Cards

• Interactive UI: The main Balance Card is now swipeable!
• Dual Perspectives:
  • Swipe Left/Right to instantly switch between your Total Balance and Monthly Balance.
  • Visual Indicators: Pagination dots help you keep track of which view is active.
• Sync: Swiping the card automatically updates your Income/Expense display preference below it.

🔒 Privacy UI Refinement

• Global Control: The Privacy "Eye" icon has been moved to the top header alongside the Settings gear.
• Why: This reflects that privacy mode is a global setting affecting the entire app, not just the balance card.

---

🛠️ Technical Changes

• Headless JS Support: Implemented a robust background task manager that handles notification actions serialized as both objects and strings (Android specific fix).
• Global Task Registration: Refactored background service initialization to ensure tasks are registered immediately upon bundle load.
• Reliable Dismissal: Added explicit notification dismissal logic for background actions.
• Centralized Storage Keys: Refactored the storage architecture to use a unified KEYS configuration object, improving code maintainability.
• Optimized Persistence: Implemented dedicated storage services for home screen preferences.
• Safe Area Handling: Enhanced modal and header layouts to better respect device safe areas.
• Crash Safety: Implemented a Global Error Boundary to prevent full app crashes.
  • Graceful Failure: Instead of closing, the app now shows a "Something went wrong" screen with a reload button.
  • Crash Telemetry: Crash logs are securely saved locally on your device for debugging.
  • Developer Options: Added a new section in Profile (toggleable via config) to simulate crashes and export crash logs.

---

🐛 Bug Fixes

• Notification Crash: Fixed a crash where background tasks would fail to parse notification data on certain Android devices.
• Stuck Notifications: Resolved an issue where "Complete" or "Snooze" actions wouldn't clear the notification from the status bar.

---

📝 For Testers

Please test the following:

1. Swipe Interaction:

   • Swipe the Balance Card horizontally.
   • Verify that the values change between "Total Balance" and "Monthly Balance".
   • Check that the pagination dots verify the page change.

2. Persistence:

   • Change your view to "This Month".
   • Restart the app.
   • Verify that the app remembers your choice and starts in "This Month" mode.

3. Privacy Toggle:

   • Click the Eye icon in the top right.
   • Verify that all sensitive numbers are hidden/shown across the entire screen.

🧾 Receipt Scanning & AI Refinements

We've improved the AI-powered receipt scanner to give you more control and smarter results.

• Main Category Selection: Saving a receipt as a single transaction? You can now explicitly select the Main Category directly from the review screen. The AI pre-selects the category with the highest spending for you.
• Smart Consolidation: When using "Save as Items", the app now automatically groups items of the same category into a single transaction per category. No more cluttered history!
• Better Category Editing: Tap the new Folder Icon next to any item to quickly reassign its category.
• Discount Handling: The AI now detects global discounts (like Senior/PWD) and adds them as a separate line item.
• Safe Area Logic: Fixed layout issues where the header was hidden under the status bar on some devices.
• AI Accuracy: Optimized the AI prompt and set specific temperature controls (Temp 0) to ensure maximum data extraction accuracy.

---

Previous Version: 1.4.0

Package: com.christian.soyosa.WealthSnap