Changelog

Added

Changed

• →Instant prayer times on launch - returning users no longer see loading spinner, app computes from last saved location then fetches fresh position in background
• →No more spinner flashes when changing calculation method, madhab, or time adjustments
• →Midnight rollover handled - prayer times, countdown, and scheduled adhan update automatically if app stays open across midnight
• →Faster cold start - Quran library and notification-channel initialization now run concurrently
• →Seamless splash hand-off - native splash removed on Dart splash's first frame, eliminating white flash
• →Splash screen redesigned - shorter (~1.4s) and readiness-gated, advances when intro animation finishes with refreshed brand-blue gradient

Fixed

• ✓Android build break on AGP 9 - pinned home_widget to 0.9.1 to resolve Kotlin compilation issue
• ✓View Calendar button now has proper contrast and readability in dark mode

Added

• +Daily Quran Reading Plan (Wird) with customizable goals (pages, rubʿ, ḥizb, or juzʾ), progress tracking, and khatma completion date
• +40 Hadith of Imam an-Nawawi collection with Arabic text and English translation, copy/share as branded card
• +After-Prayer Adhkar (Tasbahat) with per-dhikr counters, overall progress indicator, and session persistence
• +Home-screen daily-progress strip showing Wird and After-Prayer Adhkar at a glance
• +Religious-occasions strip displaying upcoming notable Islamic days
• +Two new glassmorphism prayer widgets: Prayer Detail (English) and Prayer Next (Arabic) with Aref Ruqaa calligraphy
• +Live Prayer Clock widget with self-ticking TextClock and live Chronometer countdown to next prayer
• +Live clock added to compact prayer-times widget header
• +Battery-optimization exemption request and boot receiver for background reliability
• +Aref Ruqaa and Almarai fonts for consistent typography across native widgets

Changed

• →Settings redesigned with sections opening as standalone pages with branded header
• →Share-as-image now single-language with new passage layout for long content
• →forui theming derives colors from Material ColorScheme for visual sync
• →Native widgets restyled with frosted glass background and unified blue accent palette
• →Hijri calendar month scrolling now instant via native Kotlin computation
• →Widget default sizes tuned for optimal usability and visual consistency
• →Prayer-times list widget now highlights next upcoming prayer instead of past prayer
• →Compact prayer widget opens app on first tap (previously required double tap)
• →Quran daily-wird settings use polished stepper input instead of text fields

Fixed

• ✓Fixed fasting advance reminders bugs and reworked advance-reminder settings dialog
• ✓Fixed Prayer Clock widget failing to load with RemoteViews View divider replacement
• ✓Compact prayer widget no longer clips content at constrained heights
• ✓Android 15/16 edge-to-edge compliance addressed with proper system UI handling
• ✓Bottom-sheet insets now pad content by navigation-bar inset preventing hidden items

Added

Changed

• →Updated privacy link in app about section for better accessibility

Fixed

• ✓Fixed privacy link navigation in app about section

Added

• +5-page onboarding flow with PageView swipe and parallax background
• +Floating dhikr overlay pill-bar with customizable interval and position
• +Moon phases calendar with animated hero and tappable monthly grid
• +Islamic context section with Quranic verses (Yunus 10:5, Al-Qamar 54:1, Al-Baqarah 2:189)
• +Crescent sighting card for new-moon and waxing-crescent days
• +Branded share-as-image flow with 4:5 brand card and ScheherazadeNew typography
• +Core design tokens module (lib/core/design/) with spacing, radii, motion, glass
• +Per-screen brand palette with consistent #20497D primary color family

Changed

• →Default prayer calculation method changed to Egyptian (الهيئة المصرية)
• →Floating dhikr settings redesigned with minimalist UI and grouped surface
• →Moon UI polish with brand-derived #0F1A2A night-sky surface
• →Settings ListTile framework warnings fixed with diagnostic hook

Fixed

• ✓Fasting reminders channel registration now idempotent, no longer wipes prayer channels
• ✓Fasting notification cancellation uses single-hop instead of 1002-iteration loop
• ✓Weekly fasting schedule now passes explicit timezone (avoids OEM NPE)
• ✓Fasting info share broken String cast fixed via new share screen

Added

• +App Lock (prayer-aware) with AppLockMonitorService
• +Secure overlay during prayer windows with Hadith payloads
• +App Lock settings UI with locked app selection and emergency bypass
• +Quran reader auto-scrolling with configurable speed control
• +MIT LICENSE file for open-source distribution
• +CONTRIBUTING.md and PR template for community collaboration

Changed

• →Removed RenderEffect blur from overlay card for readability
• →Removed Flutter BackdropFilter blur from bottom navigation
• →Switched to solid, accessible surface style for navigation
• →Updated README.md and documentation for open-source workflows
• →Test/developer overlay APIs removed from production

Fixed

• ✓Fixed unreadable overlay issue caused by blur on child views
• ✓Ensured overlay only activates during configured prayer windows
• ✓Fixed overlay persistence until user confirmation or next prayer

Added

• +New card in Islamic Snippets section on home screen
• +Quick access to interactive fasting calendar dialog
• +Updated Quran verses and translations
• +Improved Quran library search functionality

Changed

• →App version bumped from 2.4.0+13 to 2.4.1+14
• →MSIX version bumped from 2.4.0.0 to 2.4.1.0
• →Updated app version text in Arabic and English settings
• →Explicitly enabled default horizontal PageView reading mode

Fixed

• ✓Fixed tafsir content disappearing issue
• ✓Fixed version display in settings for both locales
• ✓Improved Quran search performance and accuracy
• ✓Fixed MSIX package version alignment

Added

• +Interactive Hijri calendar showing all Islamic fasting days
• +Complete fasting reminder system with notification integration
• +Dual date display (Gregorian + Hijri) throughout calendar
• +Coverage: Ayyam al-Bid, 9th-10th, Monday/Thursday, special days
• +Real-time countdown with 1-second precision updates
• +Improved persistent notification UI with hours:minutes:seconds
• +Settings UI redesign into compact side-by-side layout
• +FastingRemindersCubit for state management
• +HijriDateCalculatorService and FastingNotificationService
• +30+ new translation keys for fasting features

Changed

• →Fasting settings moved to dedicated section under Settings
• →Unified all fasting-related colors to theme.colorScheme.primary
• →Adhan sounds reorganized for Fajr and other prayers
• →Modern compact UI design following Material Design 3

Fixed

• ✓Fixed render overflow issues with proper Expanded wrappers
• ✓Removed old fasting_notification_settings_widget.dart
• ✓Fixed Quran screen tab translations
• ✓Enhanced notification panel integration

Added

• +Organized all 174 radio stations into 12 thematic categories
• +Full bilingual support for category names (Arabic and English)
• +Interactive category filter chips with icons
• +Added category field (Arabic name) to RadioStationModel
• +Added category_en field (English name) to RadioStationModel
• +Added getLocalizedCategory() method for language-aware display
• +Category-specific icons for better visual recognition

Changed

• →Migrated from hardcoded category logic to JSON-based categorization
• →Redesigned category selection with horizontal scrollable chips
• →Improved category chip styling with selected state visualization
• →Simplified filtering algorithm using category field lookups

Fixed

• ✓Properly categorized all Ten Readings stations
• ✓Fixed station name matching with leading/trailing spaces
• ✓Ensured accurate categorization for all 174 stations
• ✓Validated category distribution totals

Added

Changed

• →Updated app version to 2.3.4+11 for new Shorebird release
• →Updated all localization files (ar.json, en.json)
• →Updated settings screen version display
• →Updated MSIX version to 2.3.4.0

Fixed

• ✓Created new release to enable Shorebird code push
• ✓Enabled future over-the-air patches for bug fixes

Added

• +Electronic Tasbih with 33 beads circular visualization
• +Animated beads with progress tracking and haptic feedback
• +Target selection presets (33, 99, 100, 1000, custom)
• +Completion dialog with celebration animation
• +Statistics card with Total Counter, Target, Progress Percentage
• +Islamic History screen refactored with BLoC pattern
• +Pagination system for Islamic History (20 events per page)
• +Search debouncing (500ms) for improved UX
• +Comprehensive Google Play crash fix guide
• +Microsoft Store submission guide and MSIX package guide

Changed

• →Implemented Clean Architecture for Islamic History feature
• →Added proper data, domain, and presentation layers
• →Created repository pattern for data access
• →Implemented BLoC pattern for state management
• →Added comprehensive proguard rules for release builds
• →Added intent queries for Android 11+ compatibility
• →Configured MSIX settings for Windows Store deployment
• →Updated msix package to 3.16.12

Fixed

• ✓Fixed proguard configuration to prevent release build crashes
• ✓Protected Flutter framework and plugin classes from obfuscation
• ✓Fixed code shrinking issues in Google Play testing
• ✓Added proper Gson serialization rules
• ✓Fixed Android Manifest for URL launching and sharing
• ✓Fixed display name for Microsoft Store Partner Center

Added

• +Full support for latest Flutter stable version
• +Hijri Calendar Widget with interactive month navigation
• +Redesigned Prayer Times List Widget
• +Better widget data persistence and updates

Changed

• →Updated minimum SDK to 3.10.0 and Flutter to 3.24.0+
• →Applied comprehensive code formatting across entire codebase
• →Updated all packages for Flutter 3.38.6 compatibility
• →Updated Gradle and build configurations

Fixed

• ✓Resolved Flutter version conflicts
• ✓Fixed RemoteViews compatibility issues
• ✓Resolved dependencies conflicts and build warnings

Added

• +Hijri Calendar Widget with interactive navigation
• +Prayer Times List Widget with date displays
• +Background drawables with rounded corners
• +Enhanced Hijri date calculation using Syncfusion

Improved

• ⚡Widget architecture for RemoteViews compatibility
• ⚡Data flow with automatic date field updates
• ⚡GitHub Actions CI/CD pipeline

Fixed

• ✓Widget loading errors
• ✓Timezone package dependency resolution
• ✓RemoteViews compatibility issues

Added

• +Monday and Thursday Fasting Reminders
• +Configurable notification time (default: 21:00)
• +FastingNotificationSettingsWidget
• +Extended NotificationSettingsModel with 4 required fields

Improved

• ⚡Settings UI with consistent design system
• ⚡Removed 50+ animation instances for better performance
• ⚡Simplified widget trees (30-50% code reduction)
• ⚡Dialog standardization with scale + fade transitions

Fixed

• ✓Kotlin compilation cache issues
• ✓Incremental build problems
• ✓Android build system stability

Added

• +17 major hadith collections with multilingual support
• +Bookmark system for favorite hadiths
• +Nearest Mosque Finder with masjidnear.me integration
• +Animated Islamic splash screen
• +Shorebird Code Push integration for OTA updates

Improved

• ⚡Prayer Times System with adhan_dart library
• ⚡Azkar screens with modern minimalist UI
• ⚡Settings screen reorganization
• ⚡Notification system with custom adhan sounds

Fixed

• ✓Notification sound repetition issue
• ✓Android 15 compatibility
• ✓Edge-to-edge display issues
• ✓Deprecated code warnings