v2.14.1

SubDebt Manager 2.14.1

Overview

Version 2.14.1 resolves network communication configuration on Android to ensure reliable currency conversion rate retrieval and stabilizes background service queues.

Detail	Value
Version	2.14.1
Version Code	38
Target Platform	Android
Package Identifier	com.subdebt.app

Key Updates

1. Network Connectivity Configuration

Android application permissions have been updated to restore standard internet access for external service pings and currency exchange rates.

1. System Permission: Added explicit network state and internet declarations to the application configuration.
2. Background Dispatch: Optimized queue dispatch intervals to prevent delayed data synchronization.

2. General Stability Fixes

1. Navigation Stability: Resolved minor edge cases in feature discovery coach mark positioning across different device aspect ratios.
2. Maintenance Patches: Verified local storage consistency for transaction receipts.

v2.14.0

SubDebt Manager 2.14.0

Overview

Version 2.14.0 introduces an interactive feature discovery coach mark for navigation guidance and refines user interface iconography.

Detail	Value
Version	2.14.0
Version Code	37
Target Platform	Android
Package Identifier	com.subdebt.app

Key Updates

1. Navigation Feature Discovery

A guided tooltip helps users discover the top navigation settings and vault configurations.

1. Curved Direction Arrow: An animated vector arrow points directly from the discovery card to the top bar settings trigger.
2. Smart Occurrence: The indicator uses a twenty four hour cooldown interval and random trigger logic to prevent repetitive display.
3. Automatic Dismissal: Tapping the settings trigger or discovery card opens the settings screen and saves completion status.

2. Interface Iconography Refinements

Visual symbols across the dashboard and modal tools have been aligned with financial clarity standards.

1. Financial Snapshot Button: Updated with a clean document card symbol in the cashflow overview header.
2. Utilities Hub: Aligned tool grid symbols for statements and receipt scanning with standard device actions.

v2.13.0

SubDebt Manager 2.13.0

Overview

Version 2.13.0 introduces an ergonomic radial satellite action menu, historical monthly financial statements with selectable card themes, subscription cancellation guidance, Google Play Store storage compliance, and dual package releases.

Detail	Value
Version	2.13.0
Version Code	36
Target Platform	Android
Package Identifier	com.subdebt.app

Key Updates

1. Radial Satellite Action Menu

The bottom center action button opens a radial menu designed for natural single hand thumb reach.

1. Radial Motion: Four action buttons expand upward in an arc with tactile vibration.
2. Quick Navigation: Direct buttons for logging transactions, subscriptions, debts, and credits.
3. Fluid Physics: Interactive spring transitions with back press dismissal.

2. Financial Snapshot Historical Selector and Themes

The Financial Snapshot card generates statements for previous calendar months stored in the local database.

1. Historical Selector: Select any stored month to review historical revenue, expenses, and savings rates.
2. Six Visual Themes: Choose between Emerald Luxe, Obsidian Neon, Royal Amethyst, Sunset Crimson, Sapphire Azure, and Titanium Frost.
3. Privacy Mode: Hide financial numbers with a single tap before sharing.
4. Image Export: Generates high resolution statement images through the standard system share menu.

3. Subscription Cancellation Assistant

An integrated helper guides users through ending recurring paid subscriptions.

1. Official Cancellation Links: Direct links to official cancellation pages for services like Google Play, Apple, Netflix, Spotify, Amazon Prime, YouTube, Disney+, ChatGPT, GitHub, and Adobe.
2. Prefilled Notice Generator: Creates standard cancellation letters with account information ready to copy and send to support teams.
3. Status Tracking: Mark subscriptions as inactive to silence renewal reminders and update monthly expense totals.

4. Google Play Store Compliance

The application storage architecture follows current Google Play privacy requirements.

1. Scoped Storage: The app no longer requests READ_EXTERNAL_STORAGE or WRITE_EXTERNAL_STORAGE. All imports and exports use isolated application cache and the system document picker.
2. Android Photo Picker: Receipts are selected through the native Android system photo picker without broad file access.
3. Streamlined Permissions: Only the camera permission remains to allow users to take receipt photos.
4. Direct Store Links: The update verification system directs users to the Google Play Store entry.

5. Fast Launch Canvas

The startup sequence opens cleanly with no visual delay.

1. Unified Canvas: The startup background matches the dark theme canvas color to eliminate white screen flashes.
2. Quick Start: The app loads local databases and enters the dashboard immediately.

6. Dual Release Packaging

The automated build pipeline produces both package formats on release.

1. Android App Bundle: AAB package formatted for Google Play Store upload.
2. Release APK: Standalone package formatted for direct installation on Android devices.

v2.12.0

Release Notes — v2.12.0

TL;DR

SubDebt v2.12.0 is a milestone visual and utility update introducing our new brand identity & Play Store full-bleed icon, the 1-Tap Unsubscribe Assistant for terminating recurring charges across major services, the Aesthetic Financial Snapshot Card for sharing privacy-masked debt & subscription milestones, and the v2.12 Celebratory Brand Reveal Modal.

---

What's New in v2.12.0

1. Brand Refresh & Google Play Store Icon Standards

• Full-Bleed 512×512 Icon: Redesigned master app icon featuring Deep Racing Pine Teal with porcelain leather folio, vibrant amber subscription card, and mathematically balanced geometric currency emblem ($).
• Play Store Squircle Invariant: 100% full-bleed square canvas (0 border-radius on outer canvas), preventing the awkward "dot in a squircle" double-padding bug on Google Play listings.
• Android Status Bar Silhouette: Created a pure monochrome #FFFFFF alpha punch-through icon (notification-icon.png), ensuring crystal-clear status-bar rendering on modern Android devices without solid white box artifacts.

2. 1-Tap "Cancel Subscription" Direct Assistant

• Direct Portal Links: Instant one-tap navigation to official subscription management pages for Google Play, Apple App Store, Netflix, Spotify, Amazon Prime, YouTube, Disney+, ChatGPT, GitHub, and Adobe.
• Formal Cancellation Letter Generator: Automatically drafts a polite, legally sound cancellation request with subscription cost, dates, and account placeholders. Includes 1-tap "Share / Copy" and "Email Support" (mailto:).
• 1-Tap Inactive State: Instantly marks subscriptions inactive in SubDebt to pause renewal alerts and exclude them from monthly cashflow burn projections.

3. Aesthetic Financial Snapshot Card ("Share My Stats")

• Shareable Visual Card: High-resolution branded card featuring the new SubDebt logo, active subscriptions outlay, debt payoff progress %, and net savings rate.
• Built-in Privacy Masking: Toggle eye button to mask sensitive financial amounts ($••••••) while keeping progress percentages and service counts visible for safe social sharing.
• Multi-Theme Engine: Switch between Emerald Luxe, Obsidian Dark, and Sapphire Blue card themes with 1-tap native image sharing (expo-sharing + react-native-view-shot).

4. Interactive "What's New in v2.12" Brand Reveal

• First-Launch Celebration: Beautiful modal unveiling the new brand look upon updating to v2.12.
• Settings Access: Accessible anytime via Settings > About > "What's New in v2.12".

---

Release Notes — v2.11.1

TL;DR

SubDebt v2.11.1 is an essential polish and bugfix update resolving Home dashboard card spacing, edge margins, scroll bounds, and Android navigation bar button clipping in custom categories. It also eliminates false-positive subscription price-hike alerts and consolidates the cashflow insights into an executive view.

---

What's New in v2.11.1

1. Home Dashboard Card Layout & Proper Spacing

• Restored Gaps & Side Margins: Re-introduced contentContainerStyle with 20px horizontal padding and 16px vertical card spacing to eliminate edge-to-edge crowding.
• Scroll Clearance Fix: Increased bottom padding to 140px so the entire dashboard (including the Financial Utilities Hub) scrolls cleanly above the floating bottom tab bar.
• Unified Cashflow & Runway Card: Combined the separate Monthly Cashflow and 30-Day Runway into a single cohesive executive card showing Inflows, Outflows, Net Savings, daily burn rate, and 30-day projection.

2. Custom Category Save Button Clearance

• System Navigation Inset Defense: Added useSafeAreaInsets and edges={['top', 'bottom']} in Manage Categories so the "Save Custom Category" button and full form never get cut off under the Android 3-button or gesture navigation bar.
• Comfortable Touch Target: Elevated Save button height to 52px with proper vertical margins.

3. Price-Hike False-Positive Elimination

• Strict Matching Rules: Prevented micro-recharges or unrelated small purchases from falsely triggering 600%+ price-hike alerts on active subscriptions.
• Dismissible Alert: Added one-tap dismiss button to the price-hike card.

---

Release Summary

Module	Change Summary	Impact
Home Dashboard	20px edge margins, 16px card gap, 140px bottom scroll clearance.	Perfect alignment & full scrollability
Category Manager	Dynamic safe-area padding for Save button in Custom Categories.	No overlap under Android navigation bar
Price Hike Engine	Strict category and magnitude matching with dismiss button.	Zero false alarms
Icon & Color Library	120+ searchable categorized vector icons and 24 curated palette swatches.	Rich visual cues for any lifestyle spending
Smart Auto-Categorizer	Keyword & merchant dictionary with self-learning prediction on expense entry.	Instant zero-effort categorization while typing
Category Budget Alerts	Automated push notification triggers at 80% and 100% of per-category monthly limits.	Prevents accidental overspending in specific silos
Receipt Scanner & Gallery	Pattern-based receipt data extraction and full-screen visual grid gallery modal.	Digitize receipts and browse past purchase proofs
Split Bills with Friends	Equal and custom split calculator with instant 1-tap Credit entry creation.	Eliminates manual double-entry when paying for groups
Income Tracking & Cashflow	Income ledger (salary, freelance, investments) with Monthly Net Cashflow and Savings Rate %.	Complete view of net monthly liquidity & wealth generation
30-Day Cashflow Runway	Average daily burn rate, projected fixed outflows, and subscription price-hike detection.	Proactive financial forecasting and runaway inflation defense

---

Key Features & Superpowers

1. Full Category Customization & 120+ Icon Library

• Order & Hierarchy Control: Reorder categories up and down to match your spending frequency.
• Default Category Removal & Restoration: Hide or remove default categories you don't need, with a 1-tap "Restore Removed Defaults" safeguard.
• 120+ Searchable Icons: Broad coverage across Food, Transit, Housing, Shopping, Tech, Wellness, Entertainment, Office, Pets, and Travel.
• Zero-Latency Performance: Backed by a synchronous in-memory category cache to eliminate rendering delay or badge flickers.

2. Smart Auto-Categorization & Category Budget Warnings

• Merchant Matcher: Typing "Uber", "Starbucks", "Netflix", or "Pharmacy" instantly switches to the appropriate category.
• Per-Category Threshold Alerts: When reaching 80% or 100% of a specific category's allocated budget, high-priority alerts notify you proactively.

3. Split Bills with Friends

• Integrated in Add Expense: Toggle "Split this expense with friends?" during spending logging.
• Flexible Splitting: Split equally across $N$ people or assign precise custom amounts.
• Automated Ledger Generation: Your share is added to Daily Spending, and individual Credit items ("Owed to You") are automatically generated for each friend with counterparty names and notes.

4. Smart Receipt Scanner & Visual Photo Gallery

• Pattern-Based Extractor: Analyzes receipt text patterns to automatically fill merchant name, total price, and transaction date.
• Visual Receipt Gallery: A dedicated high-performance image grid allowing you to browse all captured receipts with full-screen zoom and metadata inspect.

5. Income Tracking & Real Net Cashflow Dashboard

• Comprehensive Income Logging: Track Salary, Freelance, Dividends, Reimbursements, and Gifts with recurring toggles.
• Net Cashflow Hero Card: Real-time calculation of Monthly Net Cashflow (Income - Spending - Subscriptions).
• Savings Rate %: Live percentage of income saved each month with dynamic color grading.

6. 30-Day Cashflow Runway & Subscription Price-Hike Detection

• Cash Runway Forecast: Computes your daily burn rate over the trailing 30 days and projects fixed recurring outflows (debts + subscriptions).
• Price-Hike Detection Engine: Flags subscriptions whose renewal price exceeds previous charges, guarding against silent fee increases.

---

Build & Validation

• App Version: 2.11.0
• Android Version Code: 33
• iOS Build Number: 2.11.0
• TypeScript Verification: 0 errors (tsc --noEmit exit code 0).
• Target Platforms: Android (APK / AAB) and iOS.
• Schema & Persistence: Fully backwards-compatible with automatic migration for customized categories.

v2.11.1

Release Notes — v2.11.1

TL;DR

SubDebt v2.11.1 is an essential polish and bugfix update resolving Home dashboard card spacing, edge margins, scroll bounds, and Android navigation bar button clipping in custom categories. It also eliminates false-positive subscription price-hike alerts and consolidates the cashflow insights into an executive view.

---

What's New in v2.11.1

1. Home Dashboard Card Layout & Proper Spacing

• Restored Gaps & Side Margins: Re-introduced contentContainerStyle with 20px horizontal padding and 16px vertical card spacing to eliminate edge-to-edge crowding.
• Scroll Clearance Fix: Increased bottom padding to 140px so the entire dashboard (including the Financial Utilities Hub) scrolls cleanly above the floating bottom tab bar.
• Unified Cashflow & Runway Card: Combined the separate Monthly Cashflow and 30-Day Runway into a single cohesive executive card showing Inflows, Outflows, Net Savings, daily burn rate, and 30-day projection.

2. Custom Category Save Button Clearance

• System Navigation Inset Defense: Added useSafeAreaInsets and edges={['top', 'bottom']} in Manage Categories so the "Save Custom Category" button and full form never get cut off under the Android 3-button or gesture navigation bar.
• Comfortable Touch Target: Elevated Save button height to 52px with proper vertical margins.

3. Price-Hike False-Positive Elimination

• Strict Matching Rules: Prevented micro-recharges or unrelated small purchases from falsely triggering 600%+ price-hike alerts on active subscriptions.
• Dismissible Alert: Added one-tap dismiss button to the price-hike card.

---

Release Summary

Module	Change Summary	Impact
Home Dashboard	20px edge margins, 16px card gap, 140px bottom scroll clearance.	Perfect alignment & full scrollability
Category Manager	Dynamic safe-area padding for Save button in Custom Categories.	No overlap under Android navigation bar
Price Hike Engine	Strict category and magnitude matching with dismiss button.	Zero false alarms
Icon & Color Library	120+ searchable categorized vector icons and 24 curated palette swatches.	Rich visual cues for any lifestyle spending
Smart Auto-Categorizer	Keyword & merchant dictionary with self-learning prediction on expense entry.	Instant zero-effort categorization while typing
Category Budget Alerts	Automated push notification triggers at 80% and 100% of per-category monthly limits.	Prevents accidental overspending in specific silos
Receipt Scanner & Gallery	Pattern-based receipt data extraction and full-screen visual grid gallery modal.	Digitize receipts and browse past purchase proofs
Split Bills with Friends	Equal and custom split calculator with instant 1-tap Credit entry creation.	Eliminates manual double-entry when paying for groups
Income Tracking & Cashflow	Income ledger (salary, freelance, investments) with Monthly Net Cashflow and Savings Rate %.	Complete view of net monthly liquidity & wealth generation
30-Day Cashflow Runway	Average daily burn rate, projected fixed outflows, and subscription price-hike detection.	Proactive financial forecasting and runaway inflation defense

---

Key Features & Superpowers

1. Full Category Customization & 120+ Icon Library

• Order & Hierarchy Control: Reorder categories up and down to match your spending frequency.
• Default Category Removal & Restoration: Hide or remove default categories you don't need, with a 1-tap "Restore Removed Defaults" safeguard.
• 120+ Searchable Icons: Broad coverage across Food, Transit, Housing, Shopping, Tech, Wellness, Entertainment, Office, Pets, and Travel.
• Zero-Latency Performance: Backed by a synchronous in-memory category cache to eliminate rendering delay or badge flickers.

2. Smart Auto-Categorization & Category Budget Warnings

• Merchant Matcher: Typing "Uber", "Starbucks", "Netflix", or "Pharmacy" instantly switches to the appropriate category.
• Per-Category Threshold Alerts: When reaching 80% or 100% of a specific category's allocated budget, high-priority alerts notify you proactively.

3. Split Bills with Friends

• Integrated in Add Expense: Toggle "Split this expense with friends?" during spending logging.
• Flexible Splitting: Split equally across $N$ people or assign precise custom amounts.
• Automated Ledger Generation: Your share is added to Daily Spending, and individual Credit items ("Owed to You") are automatically generated for each friend with counterparty names and notes.

4. Smart Receipt Scanner & Visual Photo Gallery

• Pattern-Based Extractor: Analyzes receipt text patterns to automatically fill merchant name, total price, and transaction date.
• Visual Receipt Gallery: A dedicated high-performance image grid allowing you to browse all captured receipts with full-screen zoom and metadata inspect.

5. Income Tracking & Real Net Cashflow Dashboard

• Comprehensive Income Logging: Track Salary, Freelance, Dividends, Reimbursements, and Gifts with recurring toggles.
• Net Cashflow Hero Card: Real-time calculation of Monthly Net Cashflow (Income - Spending - Subscriptions).
• Savings Rate %: Live percentage of income saved each month with dynamic color grading.

6. 30-Day Cashflow Runway & Subscription Price-Hike Detection

• Cash Runway Forecast: Computes your daily burn rate over the trailing 30 days and projects fixed recurring outflows (debts + subscriptions).
• Price-Hike Detection Engine: Flags subscriptions whose renewal price exceeds previous charges, guarding against silent fee increases.

---

Build & Validation

• App Version: 2.11.0
• Android Version Code: 33
• iOS Build Number: 2.11.0
• TypeScript Verification: 0 errors (tsc --noEmit exit code 0).
• Target Platforms: Android (APK / AAB) and iOS.
• Schema & Persistence: Fully backwards-compatible with automatic migration for customized categories.

v2.11.0

Release Notes — v2.11.0

TL;DR

SubDebt v2.11.0 is a milestone release introducing 5 Major Financial Superpowers: Split Bills with Friends (with automated debt/credit logging), Income Tracking & Real Net Cashflow Analytics (with Savings Rate %), 30-Day Cashflow Runway Forecast & Subscription Price-Hike Detection, Pattern-Based Smart Receipt Scanner & Full Visual Gallery, and Complete Category Customization with reordering, default category deletion/restoration, and a library of 120+ categorized icons.

---

Release Summary

Module	Change Summary	Impact
Category Customization	Reordering (up/down), remove/hide defaults, edit colors & names, restore defaults.	Complete personalization over spending taxonomy
Icon & Color Library	120+ searchable categorized vector icons and 24 curated palette swatches.	Rich visual cues for any lifestyle spending
Smart Auto-Categorizer	Keyword & merchant dictionary with self-learning prediction on expense entry.	Instant zero-effort categorization while typing
Category Budget Alerts	Automated push notification triggers at 80% and 100% of per-category monthly limits.	Prevents accidental overspending in specific silos
Receipt Scanner & Gallery	Pattern-based receipt data extraction and full-screen visual grid gallery modal.	Digitize receipts and browse past purchase proofs
Split Bills with Friends	Equal and custom split calculator with instant 1-tap Credit entry creation.	Eliminates manual double-entry when paying for groups
Income Tracking & Cashflow	Income ledger (salary, freelance, investments) with Monthly Net Cashflow and Savings Rate %.	Complete view of net monthly liquidity & wealth generation
30-Day Cashflow Runway	Average daily burn rate, projected fixed outflows, and subscription price-hike detection.	Proactive financial forecasting and runaway inflation defense

---

Key Features & Superpowers

1. Full Category Customization & 120+ Icon Library

• Order & Hierarchy Control: Reorder categories up and down to match your spending frequency.
• Default Category Removal & Restoration: Hide or remove default categories you don't need, with a 1-tap "Restore Removed Defaults" safeguard.
• 120+ Searchable Icons: Broad coverage across Food, Transit, Housing, Shopping, Tech, Wellness, Entertainment, Office, Pets, and Travel.
• Zero-Latency Performance: Backed by a synchronous in-memory category cache to eliminate rendering delay or badge flickers.

2. Smart Auto-Categorization & Category Budget Warnings

• Merchant Matcher: Typing "Uber", "Starbucks", "Netflix", or "Pharmacy" instantly switches to the appropriate category.
• Per-Category Threshold Alerts: When reaching 80% or 100% of a specific category's allocated budget, high-priority alerts notify you proactively.

3. Split Bills with Friends

• Integrated in Add Expense: Toggle "Split this expense with friends?" during spending logging.
• Flexible Splitting: Split equally across $N$ people or assign precise custom amounts.
• Automated Ledger Generation: Your share is added to Daily Spending, and individual Credit items ("Owed to You") are automatically generated for each friend with counterparty names and notes.

4. Smart Receipt Scanner & Visual Photo Gallery

• Pattern-Based Extractor: Analyzes receipt text patterns to automatically fill merchant name, total price, and transaction date.
• Visual Receipt Gallery: A dedicated high-performance image grid allowing you to browse all captured receipts with full-screen zoom and metadata inspect.

5. Income Tracking & Real Net Cashflow Dashboard

• Comprehensive Income Logging: Track Salary, Freelance, Dividends, Reimbursements, and Gifts with recurring toggles.
• Net Cashflow Hero Card: Real-time calculation of Monthly Net Cashflow (Income - Spending - Subscriptions).
• Savings Rate %: Live percentage of income saved each month with dynamic color grading.

6. 30-Day Cashflow Runway & Subscription Price-Hike Detection

• Cash Runway Forecast: Computes your daily burn rate over the trailing 30 days and projects fixed recurring outflows (debts + subscriptions).
• Price-Hike Detection Engine: Flags subscriptions whose renewal price exceeds previous charges, guarding against silent fee increases.

---

Build & Validation

• App Version: 2.11.0
• Android Version Code: 33
• iOS Build Number: 2.11.0
• TypeScript Verification: 0 errors (tsc --noEmit exit code 0).
• Target Platforms: Android (APK / AAB) and iOS.
• Schema & Persistence: Fully backwards-compatible with automatic migration for customized categories.

v2.10.0

Release Notes — v2.10.0

TL;DR

SubDebt v2.10.0 delivers Dynamic Smart Notification Schedules with Granular Channel Controls, Data Vault Android Storage Access Framework (SAF) Public Folder Sync, Embedded Receipt Photo Integration in Digital Receipts, and an Executive Multi-Section PDF Financial Statement Generator with official vector branding and dynamic page counters.

---

Release Summary

Module	Change Summary	Impact
Notifications	Dynamic debt, subscription, and spending alerts with individual channel toggles.	Real-time context-aware daily reminders
Data Vault	Android SAF folder selection and automatic missed-backup catch-up.	Backups directly visible in File Manager
PDF Statements	Multi-section statement (Spending, Subscriptions, Debts) with vector logo & page numbers.	Professional exportable financial records
Digital Receipts	Embedded attached receipt photos directly inside digital receipt cards.	Complete shareable receipt slips
Heatmap UI	Eliminated hardware layer elevation artifact on calendar cells.	High-contrast visual clarity across themes

---

Key Features & Improvements

1. Dynamic Smart Notification Schedule & Granular Controls

• Individual Channel Switches: Added granular toggles in Settings for Pending Debts, Subscription Renewals, Daily Spending & Budget Allowance, and Credit Returns.
• Dynamic Debt Reminders: Generates contextual debt reminders with counterparty name and exact remaining balance (e.g., "You have to pay [Name] [Amount]").
• Subscription Expiry Countdown: Automated detection for subscriptions renewing today, tomorrow, or ending trial periods.
• Auto-Sync Across Ledger Actions: Modifying debts, subscriptions, or spending logs immediately reschedules pending notifications.

2. Data Vault Android File Manager Integration & Catch-Up

• Storage Access Framework (SAF): Users can link a public device folder (such as Documents or Downloads) so backups are directly visible and accessible in Android File Manager apps.
• Missed Snapshot Catch-Up: If the device was powered off or the app was closed at 10:00 PM, the scheduler automatically runs the missed snapshot upon opening the app.
• One-Tap Export: Added individual snapshot "Save to Phone" and "Export All to Storage" buttons.

3. Executive Multi-Section PDF Financial Statement

• Dynamic Page Numbering: Resolved duplicate page numbering issues using standard CSS paged media rules (@page counters).
• Official Vector Branding: Embedded high-resolution SubDebt Manager vector logo, report ID, generation timestamp, and offline verification badges.
• Multi-Section Ledger: Captures Spending Category Share Bars, Active Subscriptions Schedule, and Open Debts & Liabilities matrix.
• Theme Palette Calibration: Available in Classic Light, Deep Slate Dark, and Luxury Emerald themes.

4. Digital Receipts & Visual Fixes

• Embedded Receipt Photos: Attached receipts now render directly inside the shareable DigitalReceiptModal.
• Heatmap Cell Glitch Resolved: Removed hardware elevation artifacts on Android calendar cells for seamless selected-day styling.

---

Build & Validation

• App Version: 2.10.0
• Android Version Code: 32
• TypeScript Validation: 0 errors (tsc --noEmit exit code 0).
• Target Platforms: Android (APK / AAB) and iOS.
• Schema Version: 2.

v2.9.0

Release Notes — v2.9.0

TL;DR

SubDebt v2.9.0 introduces Automated 10:00 PM Daily Vault Snapshots, full Unified Themed Dialog System (AppPopup) replacing legacy native OS alerts, Debt-to-Daily Spending Auto-Settlement Logging, and Dual-Theme High-Contrast Heatmap & Explorer Calibration.

---

Release Summary

Module	Change Summary	Impact
Data Vault	Automated nightly snapshots at 10:00 PM IST with full local retention (30 backups).	Automated data security & one-tap restore
Design System	Complete migration from native Alert.alert to themed glass AppPopup.	100% visual and interactive consistency
Debt & Settle	Auto-prompt to record settled debt payments directly into Daily Spending.	Zero manual duplicate entry
Spending Heatmap	High-contrast present-day cell rendering and blue focal status indicators.	Legibility in light & dark modes
Spending Explorer	Solid category filter badges with 24px right scroll clearance.	Clean horizontal navigation
Security & Privacy	Security PIN & App Lock tagged with Beta indicator and safety guards.	Transparent feature readiness

---

Key Features & Improvements

1. Automated Vault Snapshots & Scheduled Backups

• Nightly Automated Execution: Automated background trigger creates daily offline backups at 10:00 PM IST (22:00).
• Standardized File Structure: Timestamped schema files named SubDebt_Snapshot_YYYY-MM-DD_HHmmss.json.
• Full-State Preservation: Captures Subscriptions, Debts, Credits, Daily Spending entries, Custom Categories, Monthly Budgets, Category Limits, and all user settings.
• Snapshot Management Console: Dedicated management view in Data Vault with one-tap Restore (Merge / Replace), Share, Delete, and manual "Snapshot Now" actions.
• Retention Control: Automatically manages the latest 30 snapshots in local sandbox storage (SubDebt_Vault_Backups/).

2. Full Themed Glass Popups Migration

• Replaced all legacy OS native dialogs across modals (settings.tsx, edit-debt.tsx, edit-credit.tsx, manage-categories.tsx, spending-explorer.tsx, import-csv.tsx, tool-reminder-generator.tsx, tool-data-vault.tsx).
• Standardized on glassmorphic AppPopup component with custom icons, haptics, and destructive action protections.

3. Debt Settlement to Daily Spending Pipeline

• Marking any debt as paid now prompts to automatically log the transaction into Daily Spending under category Debt & EMI.
• Sequential modal flow ensures receipt sharing card (SettlementCardModal) captures clean images without overlay interference.

4. Heatmap & Category Filter Visual Calibration

• Calendar Heatmap: Fixed light mode text contrast on current day (19th) zero-spend cells and status indicators.
• Category Filter Chips: Standardized active badges to solid backgrounds with white typography and generous 24px right padding to prevent clipping.

---

Build & Validation

• TypeScript Validation: 0 errors (tsc --noEmit exit code 0).
• Target Platforms: Android (APK / AAB) and iOS.
• Schema Version: 2.

v2.8.0

v2.8.0 — Spending Explorer, Receipt Photo Vault, Dual-Theme Calibration & Full-Ledger Backup Architecture

SubDebt v2.8.0 delivers an extensive capability upgrade featuring a dedicated Spending Explorer and Analytics console, native camera and gallery receipt photo attachments with an interactive full-screen Photo Vault, full dual-theme visual calibration, and a re-engineered backup engine that captures the complete state of the offline ledger and user preferences.

---

Key Highlights & New Capabilities

1. Dedicated Spending Explorer & Advanced Analytics

• Multi-Criteria Filtering Engine: Filter expense records across preset date intervals (Today, Yesterday, This Week, This Month, Last Month, 90 Days, This Year) or custom date windows with intuitive date pickers.
• Concurrent Category & Keyword Filtering: Filter simultaneously across custom categories, merchants, descriptions, and notes.
• Live Metric Aggregation: Instant metric computation providing total filtered volume, average cost per transaction, and top spending category.
• Interactive Distribution Visualizer: Dynamic progress indicators demonstrating category-wise allocation and percentage shares.
• Configurable Sorting Matrix: Reorder transactions by newest, oldest, highest amount, lowest amount, or alphabetical title.
• One-Tap Spreadsheet Export: Export filtered transaction views directly to formatted CSV files with native sharing integration.

2. Receipt Attachment System & Interactive Photo Vault

• Permanent Local Storage Pipeline: Attach photos taken directly with the camera or selected from the device photo library. Receipt images are copied to persistent application storage to ensure longevity across system cache clear operations.
• Full-Screen Photo Vault Inspector: Dedicated high-resolution image viewer with backdrop blur, native share triggers, and transaction metadata overlays.
• Expense Card Integration: Transaction items with attached receipts automatically display interactive photo badges for rapid visual inspection.
• Streamlined Modal Workflows: Add and edit spending interfaces now feature dedicated receipt management cards supporting live previews, replacement, and removal.

3. Calendar Heatmap & Localization Calibration

• Present-Day High-Visibility Indicator: Today's calendar cell features a high-contrast accent ring border, glowing focal indicator, and distinct background highlight for immediate identification.
• Dynamic Localization in Legend: Legend values now dynamically reflect the user's active currency configuration (including Indian Rupees INR) rather than static fallback symbols.

4. Theme-Adaptive Launch & Visual Hierarchy

• White Background Native Launch Calibration: Updated native adaptive icon and splash configurations to pure white, eliminating dark border boxes during initial application boot.
• Theme-Reactive Splash Experience: Custom splash sequence automatically harmonizes with the user's active theme palette and accent selections, utilizing glassmorphic surfaces and hardware-accelerated transitions.
• Dual-Theme Contrast Calibration: Elevated cards, filter pills, search fields, and modal bottom sheets have been calibrated for crisp visibility and contrast in both Light and Dark themes.

5. Comprehensive Full-Ledger Backup & Restore Architecture

• Complete State Export: Backup JSON files now serialize all operational datasets, including Subscriptions, Debts, Credits, Daily Spending entries (with receipt associations), Monthly Budgets, Category Limits, and Custom Categories.
• Preference & Setting Persistence: Backups capture application settings including currency, number formatting (Indian vs Western), date formatting, week start day, card density mode, default payment methods, theme preferences, accent color selections, and reminder schedules.
• Dual-Mode Restoration: Full support for both non-destructive Smart Merge and Complete Vault Replacement modes with automatic notification rescheduling.

---

Technical Specifications & Verification

• TypeScript Type Safety: 100% type coverage verified with strict zero-error compiler validation.
• Storage Layer: Asynchronous persistent storage integration with integrity guarantees across schema version 2.
• Media Pipelines: Native permissions and asset resolution handled via dedicated image picking and file sharing integrations.

v2.7.0

v2.7.0 — Floating Top Header, Light Theme Contrast Overhaul, Multi-Line Notes Display & UI Modernization

Release Date: August 16, 2026

---

Highlights

This release introduces a responsive Floating Top Capsule Header across all application screens, delivers a comprehensive light theme visual contrast overhaul, sets the default app theme for new installs to light mode, resolves note field multi-line truncation across all transaction cards, improves the multi-line input interaction model, refines the subscription tab architecture, and modernizes the borrowed liability color identity to a premium Rose Crimson palette.

---

Key Improvements and Fixes

1. Responsive Floating Capsule Header

• Implemented a unified, floating glass capsule header (FloatingTopHeader.tsx) across Home, Spending, Subscriptions, Debts, Credits, and Owed screens.
• Utilizes dynamic window dimension scaling for consistent padding, margins, and pill height across compact and extra-large displays.
• Integrated dual-theme translucent glass styling with subtle borders and high-contrast action buttons.

2. Light Theme Contrast & Default App Theme

• Set default theme initialization for fresh installs to Light mode in useTheme.tsx while preserving local user preference persistence.
• Overhauled card containers, chips, switches, date pickers, and badges in SubscriptionCard, DebtCard, CreditCard, add-subscription, and edit-subscription for crisp readability on white backgrounds.
• Replaced low-contrast glass overlays in light mode with solid #FFFFFF cards, refined borders (#E2E8F0 / rgba(0, 0, 0, 0.08)), and high-contrast typography (#0F172A / #334155 / #475569).

3. Multi-Line Notes & Purpose Display

• Resolved truncation issues in SubscriptionCard, DebtCard, and CreditCard.
• Replaced single-line and two-line clamped containers with dedicated, unconstrained multi-line info cards displaying full user notes and transaction purposes.
• Fixed a conditional rendering bug in DebtCard where notes were suppressed whenever a purpose was present.

4. Multiline Input Container Expansion

• Upgraded GlassInput.tsx to automatically calculate flexible vertical container sizing when multiline={true} is specified.
• Added explicit textAlignVertical: 'top' and top-padding compensation for Android and iOS text inputs, preventing earlier lines from scrolling out of view.

5. Edit Modal Loading State Optimization

• Integrated an isLoaded hydration guard in edit-subscription.tsx.
• Displays a clean skeleton placeholder during asynchronous storage reads, eliminating the momentary "Subscription not found" screen flash on modal launch.

6. Subscriptions Architecture Simplification

• Removed the heavy 12-month outflow projection SVG chart from subscriptions.tsx to streamline the user interface and decrease render overhead.
• Retained the Monthly Bill Calendar and Burn Rate Summary cards with enhanced light/dark theme contrast.

7. Modernized Borrowed Section Accent Color

• Updated the default accent color for borrowed debts in owed.tsx, debts.tsx, and DebtCard.tsx from yellow/amber to a modern Rose Crimson palette (#FB7185 in Dark Mode, #E11D48 in Light Mode).
• Synchronized segmented tab controls, summary card borders, pending count badges, and hero gradients.

8. Spending 30-Day Heatmap Refinements

• Optimized the daily spending calendar grid in spending.tsx to reflect accurate month-based day distributions with refined cell sizing and spacing.

---

File Changes Summary

Module	Files Modified / Added
Navigation & Headers	components/FloatingTopHeader.tsx, app/(tabs)/home.tsx, app/(tabs)/spending.tsx, app/(tabs)/subscriptions.tsx, app/(tabs)/debts.tsx, app/(tabs)/credits.tsx, app/(tabs)/owed.tsx
Cards & Display	components/SubscriptionCard.tsx, components/DebtCard.tsx, components/CreditCard.tsx
Form Controls	components/GlassInput.tsx
Modals	app/modals/add-subscription.tsx, app/modals/edit-subscription.tsx
Theme & Storage	hooks/useTheme.tsx
Configuration & Web	package.json, app.json, index.html, RELEASE_NOTES.md

---

Verification & Build Integrity

• Fully verified with TypeScript compiler (npx tsc --noEmit): 0 errors.
• 100% offline data safety preserved with zero schema breaking changes.