🌙 Noor Connect - Your Ultimate Islamic Companion

Noor Connect is a truly comprehensive, beautiful, and strict privacy-focused Islamic application designed to help you stay connected with your faith. Built to modern mobile standards using web technologies (React + Vite + Capacitor), it stands as a premium, tracker-free digital companion for spiritual growth.

---

🎯 Our Mission & Origin Story

Noor Connect was born from a simple frustration: there was no single Islamic app that offered comprehensive features without compromising user privacy.

The mainstream Islamic app market is dominated by apps that:

• 📊 Sell your location data to third parties (documented cases with major apps)
• 📱 Track your prayer habits for advertising profiles
• 🔍 Monitor your Quran reading for analytics
• 💰 Monetize your spiritual data without consent

Noor Connect was built differently — by a Muslim who needed a complete Islamic toolkit but refused to trade privacy for convenience. Every feature exists because the developer personally needed it, and every architectural decision prioritizes your sovereignty over your spiritual data.

🏆 Partnership: No Copyright Nasheed

We're proud to announce our partnership with No Copyright Nasheed — the leading platform for copyright-free Islamic nasheeds.

• ✅ Official License Grant: Free perpetual license to integrate 400+ premium nasheeds
• ✅ Official Feature: Noor Connect is now featured on the No Copyright Nasheed website as a trusted partner
• 🎵 Released in v2.2: 400+ curated nasheeds with a highly optimized audio player.

This partnership ensures every nasheed is legally licensed, high-quality, and supports the creators — aligning perfectly with our Islamic ethics.

---

🆕 What's New in v2.2.1

📱 Android Widgets — Stability, Deep-Links & Accent Colors

• Widgets No Longer Break on Android 8–11: Removed RemoteViews reflection calls to View.setRotation (unsupported before Android 12) that made every Next Prayer / Quran Progress widget update fail with "Problem loading widget" on API ≤ 30. Rings now render via drawable levels on all supported versions.
• Widget Taps Fixed: Next Prayer tap (and its empty-state CTA) no longer lands on the 404 page (/prayers → dashboard redirect); Quran Progress tap opens the Quran progress page (/quran/reading redirect).
• In-App Tasbeeh Syncs to the Widget: Fixed an event-name mismatch (noorconnect:tasbeeh-changed was never dispatched; the real event is tasbeeh-updated) — tasbeeh counted in-app now updates the home-screen widget instantly instead of only widget-side taps counting.
• Accent Colors Work: The configure screen's accent pick is now applied to widget accent text, and the previously missing Amber / Blue / Purple / Teal / Red palettes were added for light and dark themes.
• No Silent Sync Drops: Prayer data with any missing time is now explicitly rejected with a warning instead of being filtered into a payload that the native validator silently dropped.
• Dead Code Removed: Unused throttle helpers, duplicate step-detection registration, and inert manifest meta-data cleaned out.

📱 Android Widgets — Stability, Deep-Links & Accent Colors

• Widgets No Longer Break on Android 8–11: Removed all RemoteViews reflection calls to View.setRotation from the Next Prayer and Quran Progress widgets. That method only became @RemotableViewMethod-safe in Android 12; on API ≤ 30 every widget update threw an ActionException during rendering and the launcher showed "Problem loading widget". Progress rings now render purely via setImageLevel on the useLevel ring drawable, which works on every supported API level (and the redundant rotation/level double-rendering is gone — the arc starts at 12 o'clock).
• Widget Taps Fixed: Next Prayer tap (and its empty-state CTA) no longer lands on the 404 page (/prayers → dashboard redirect); Quran Progress tap opens the Quran progress page (/quran/reading redirect).
• In-App Tasbeeh Syncs to the Widget: Fixed an event-name mismatch (noorconnect:tasbeeh-changed was never dispatched; the real event is tasbeeh-updated) — tasbeeh counted in-app now updates the home-screen widget instantly instead of only widget-side taps counting.
• Accent Colors Work: The configure screen's accent pick is now applied to widget accent text, and the previously missing Amber / Blue / Purple / Teal / Red palettes were added for light and dark themes.
• No Silent Sync Drops: Prayer data with any missing time is now explicitly rejected with a warning instead of being filtered into a payload that the native validator silently dropped.
• Dead Code Removed: Unused throttle helpers, duplicate step-detection registration, and inert manifest meta-data cleaned out.

📻 Live Streams — Migrated to Official SBA CDN

• Replaced dead m.live.net.sa Wowza streams (404) and CORS-blocked Aloula CDN redirects with official SBA streams via Globecast/Akamai CDN (HTTPS, CORS-enabled globally).
• Unified platform URLs — both native Android and web use the same HTTPS endpoint. No more cleartext HTTP exceptions.
• Added Kwikmotion 1080p as automatic fallback for Makkah.
• Removed m.live.net.sa from Android network security config.

🎵 Quran Audio & Player Enhancements

• Quran Audio Page Redesigned: Complete Spotify-style UI/UX remake — dark hero card, horizontal reciter carousel with circular gold-gradient avatars, surah list with diamond number plates and animated equalizer on the playing row, sticky search bar, and playback via GlobalQuranPlayer mini-player app-wide.
• GlobalQuranPlayer Repeat Loop: Added repeat toggle (loop current surah indefinitely); audio automatically restarts from 0:00 when ended and repeat is enabled.
• GlobalQuranPlayer Progress Bar: Added thin gold progress bar in mini-player showing seek position; expanded player includes seek backward/forward 10s buttons with proper SkipBack/SkipForward icons (was placeholder Repeat icons).
• GlobalRadioPlayer Transparency Fixed: Mini-player background changed from semi-transparent bg-card/95 backdrop-blur-xl to solid bg-card for fully opaque white appearance.
• Download Manager Listing: Added listDownloaded() method to QuranDownloadManager — returns per-reciter offline surah info (count, total size, reciter IDs) for storage stats and "wipe downloads" action.
• Quran Audio Play Badge Interactivity: Circular play icon beside download button now toggles play/pause (was decorative-only).
• Performance Fix: Stabilized getRowProgress callback via useRef to prevent 114 surah row re-renders during active downloads, fixing FPS degradation.

---

🚀 Nasheed Library (v2.2)

🎵 400+ Premium Nasheeds — Legally Licensed & Free

In partnership with No Copyright Nasheed, we're bringing the largest curated nasheed library to any Islamic app:

Feature	Details
Library Size	400+ premium nasheeds (expanding)
Licensing	Official free perpetual license from No Copyright Nasheed
Artists	Curated from top Islamic nasheed artists globally
Categories	Hamd, Naat, Islamic motivation, Ramadan, Eid, kids
Languages	Arabic, English, Urdu, Turkish, Malay, more

📶 Adaptive Streaming for Weak Connections

• Smart Bitrate: Auto-adjusts quality (32kbps → 128kbps) based on connection
• Smart Caching: Preloads next nasheed during playback
• Offline Queue: Download on wifi, listen anywhere
• Data Saver: <5MB/hour on lowest quality
• Background Play: Continues when screen off / app backgrounded

🎛️ Smart Features

• Sleep Timer: Auto-stop after 15/30/60 minutes
• Playback Speed: 0.5x → 2x for learning/memorization
• Lyrics Sync: Time-synced lyrics display (where available)
• Favorites & Playlists: Build personal collections
• Daily Nasheed: Curated daily recommendation
• Background Download: Queue downloads on wifi only

Official Partnership: Noor Connect is now featured on the No Copyright Nasheed website — the first Islamic app to receive this recognition.

---

✨ The Complete Feature Set

📖 Enhanced Quran & Tafsir Explorer

• Complete Holy Quran: Clean, beautifully styled reading interfaces with ** Madani Mushaf WebP images** (604 pages). Advanced caching system prefetches pages for instant display.
• Standard Mushaf Implementation: Industry-standard Madani Mushaf layout with optimized WebP storage for privacy-first offline Quran reading.
• Surah Explorer: Browse all 114 surahs with live search (Arabic, English, translation, number) and Meccan/Medinan filter chips, plus a "Continue Reading" resume card and a rotating Daily Ayah card.
• Advanced Tafsir System: 25+ global Quranic commentary editions instantly accessible via high-speed spaCy API integration, eliminating heavy database overhead, with search, bookmarks, notes, history, font-size controls, and download support.
• Multilingual Support: Read meanings and Tafsir in English, Arabic, Bengali, Urdu, and Russian.
• Recitation Playback: Immersive background audio from multiple reciters with progress tracking. Dedicated audio player with reciter selection (11 expert reciters), all 114 surahs, seekable progress bar, volume control, MP3 download, and auto-advance to the next surah.
• Offline Quran Engine: Optional IndexedDB offline storage for surah data, recitations, and audio segments with a background sync service (1-hour interval, WiFi-only, charging-only, native BackgroundRunner on Android) so the Quran works completely offline.
• Quran Progress & Achievements: Page-based reading progress (X/604), reading streaks with emoji milestones, total ayahs read, and 7 unlockable reading achievements.

🕋 Premium Qibla Compass

• High-Precision Native Sensors: Completely overhauled native compass utilization tapping into device magnetometers for raw, smooth orientation. 60fps hardware-accelerated JS interpolation eliminates sensor jitter and UI lag on legacy Android devices.
• Muslim Pro Grade UI: Exquisite SVG-based compass dial with Kaaba alignment glow effects, jitter-reducing low-pass filters, and haptic feedback upon true Qibla lock.
• Web & Manual Fallback: If sensors fail, the app gracefully falls back to GPS/Web-oriented calculation paths.

📅 Advanced Islamic Calendar & Events

• Complete Hijri Calendar: View Gregorian and Hijri dates side-by-side with global offset adjustments.
• Ramadan Mode: A comprehensive fasting hub featuring Suhoor/Iftar countdowns, daily Taraweeh progress tracking, hydration reminders, and specialized Ramadan Duas.
• Holiday Countdowns: Automated visual countdowns for major Islamic events like Eid al-Fitr, Eid al-Adha, and Laylat al-Qadr.

⏲️ Smart Prayer Times & Adhan Control

• Offline Calculation: Fast, precise, localization-based timings for Hanafi and Shafi'i madhabs generated fully offline.
• Granular Adhan Toggles: Selectively enable or disable Adhan alarms per individual prayer using deep native background alarms—silence Asr without muting Maghrib!
• Custom Adhan Upload: Upload your own MP3 adhan (max 10 MB), preview it, and assign it to any of the 5 prayers — stored on-device in IndexedDB.
• Optimized TTS & Audio: Highly tuned Adhan playback utilizing an advanced audio engine to prevent interruptions or background sleep killing.
• Smart Settings: 12+ prayer calculation methods (MWL, Egyptian, Karachi, Umm al-Qura, Dubai, North America, etc.) with a "recommended for your location" suggester, madhab selector (Shafi/Hanafi), 12/24-hour time format, and Hijri date adjustment (±2 days).

📿 Complete Spiritual Tracking & Menstrual Mode

• Gender-Adaptive Onboarding: Intelligent routing that completely re-adapts internal features based on the user.
• Menstrual Mode: Carefully tracks cycles, automatically silencing obligatory Adhans, halting Salah charts, and adjusting habit trackers during breaks without breaking daily login streaks.
• Qaza & Habits: Keep a long-term offline ledger of your missed prayers (Qaza Tracker), digital Tasbeeh goals, and weekly spiritual habit consistency.
• Digital Tasbeeh: 5 dhikrs with transliteration and translation, milestone goal rollover (33 → 99 → 100), full-screen immersive Zen Mode, lifetime totals, daily session history, and rich haptic feedback patterns on every tap.
• Salah Focus Timer: A dedicated Do-Not-Disturb timer to help you maintain khushu (focus) during prayer.
• Mood-Based Reflections: Enhanced Mood Selector providing tailored Daily Ayahs and Islamic Greetings based on how you feel.

📚 Islamic Life & Education Tools

• Zakat & Fitrana Calculators: Advanced offline calculators to accurately determine your annual Zakat and Ramadan Fitrana obligations. Features gold and silver weight calculators with purity options, real-time exchange rate tracking with fallback for offline use, preferred currency settings, and automatic rate updates when online.
• Hisnul Muslim & Duas: Comprehensive library of 80+ authentic supplications for all occasions with category filters, search, a daily "Dua of the Day", audio playback (Arabic TTS), favorites, sharing, and repetition counters for repeated adhkar.
• Names of Allah (Asma-ul-Husna): Beautifully rendered 99 Names of Allah with meanings, transliteration, search, favorites-only filter, and an elegant detail modal with fluid animations.
• Enhanced Islamic Quiz: Test your knowledge of Deen with interactive, gamified Islamic quizzes. Includes a full XP economy with 15 levels, daily rewards, combo multipliers, mystery boxes (Knowledge Box / Wisdom Chest), a lives system, an in-app store for power-ups, daily challenges, boosters, and reliable cross-platform gamification logic.
• Islamic Remedies (Tibb-e-Nabawi): Mood-based prophetic medicine index (12 moods) with surah/ayah/dua/hadith/dhikr remedies, a daily remedy (+25 XP), gamification with XP levels and 8 achievements, full-screen viewers, and a favorites list for quick reference.
• Eid & Festive Checklist: Special event mode with checklists and celebratory popups to prepare for Eid and other significant Islamic events.
• Prayer Statistics & Analytics: Detailed visual graphs tracking prayer completion, Qaza history, and weekly/monthly performance.
• Spiritual Habit Tracker: Track daily habits (like reading Quran, giving charity) with streak preservation.

📖 History & Literature

• Seerah of the Prophet (ﷺ): Comprehensive biography reader with chapters, categorization (Makkan, Madinan), and reading progress tracking.
• Qisas Al-Anbiya: Detailed stories of the Prophets with progress tracking and categorized reading sessions.
• Ebooks Library: Modern Islamic ebooks reader for deeper theological exploration.

📻 Rich Media & Islamic Library

• Hadith Encyclopedia (52K+): 16 complete collections with Arabic + English, color-coded grade badges (Sahih/Hasan/Da'if), bookmarks, daily hadith, full-text search, and page-by-page navigation. Infinite scroll loads 300 hadith at a time for smooth browsing. Uses gzip-compressed JSON for fast offline loading.
• 24/7 Quran Radio & Streams: Direct live video and audio streams from Makkah and Madinah via official SBA Globecast/Akamai CDN (HTTPS, CORS-enabled globally) with automatic source fallback and friendly error handling.
• Quran Radio Station Catalog: 200+ streaming stations (reciters, translations, tafsir, hadith, surah loops, adhkar, mosque mix, fatwa) with search, 9 category filters, a curated "Featured Reciters" row, pin/unpin favorites, and persistent global playback that continues across screens.
• Radio Statistics & Achievements: Track your listening habits with detailed statistics per station, total listening time, streak tracking, and unlockable achievements for consistent listening.
• Mushaf Image Optimization: Local asset storage with Gradle-based image moving during Android build to eliminate duplication. Uses standard Madani Mushaf (industry standard for Muslim world with 604 pages).
• 🎵 Nasheed Library (v2.2): 400+ legally licensed nasheeds via official No Copyright Nasheed partnership. Adaptive streaming for 2G/weak wifi, offline download, sleep timer, lyrics sync, and curated daily recommendations. Officially featured on No Copyright Nasheed website.

🎵 Dedicated Nasheed Player (v2.2+)

• Official No Copyright Nasheed Partnership: Exclusive integration with 400+ high-quality nasheeds from the renowned No Copyright Nasheed platform — legally licensed and officially featured on their website.
• Adaptive Streaming: Smart bitrate adaptation (64kbps/128kbps/256kbps) for seamless playback on 2G, weak wifi, or limited data — no buffering, ever.
• Offline-First: One-tap download for complete offline listening. Automatic cleanup of old downloads when storage is low.
• Smart Player Features:
  • Sleep timer with fade-out (5/15/30/60 min)
  • Lyrics synchronization (LRC format) with word-by-word highlighting
  • Curated daily recommendations based on time, mood, and history
  • Continuous playback with crossfade between tracks
  • Background playback with notification controls
• Categories: Morning/Evening adhkar, Ramadan, Eid, Kids, Arabic/English/Urdu, Instrumental, Acapella

📱 Android Integration & Security

• Native Android Widgets: Home screen widgets for Next Prayer, Quran Reading Progress, Daily Ayah, Daily Hadith, and a Digital Tasbeeh. Everything auto-syncs with your in-app progress.
• Auto Backup & Restore: Robust always-on backup system that automatically secures your settings, bookmarks, Qaza records, Quran progress, and all Capacitor Preferences (like Nasheed radio stats, theme preferences, and advanced hardware configurations). No toggle — the latest snapshot is saved every 20 minutes and on app close. Declares full Android Auto Backup rules so Google Drive silently syncs your data and it is offered back on re-install.
• Advanced Notification System:
• Heads-Up Adhaan: Deep native integration for high-priority, full-screen intent Adhaan notifications with direct lock-screen controls to "Stop Adhaan" or "Open App".
• Context-Aware Prayer Quotes: Intelligent prayer reminders that attach specific Quranic Ayahs or Ahadith related to the exact prayer time (e.g. Fajr-specific Hadith for Fajr reminders).
• Friday Kahf Reminder: Once-per-day Friday notification with the Verse of the Day (Surah Al-Kahf) and a short reflection.
• Islamic Sleep Reminder: Gentle bedtime notification with rotating Ayatul Kursi, Surahs Al-Ikhlas/Al-Falaq/An-Nas, and sleeping-on-right-side guidance, scheduled relative to Isha prayer.
• Modern Notification History: Beautiful, fully-featured notification history tracking UI with rich visual cards, status badges, timestamp grouping, and categorical filtering.
• Media Session Lock-Screen Controls: Play/pause/stop/previous/next controls on the Android lock screen and notification shade during Quran audio or nasheed playback via Media Session API.
• Privacy-First: No listening analytics, no tracking, all data local. Optional anonymous usage stats (opt-in only).

📱 Native Android Widgets Suite (v2.2 Hardened)

• 5 High-Performance Native Widgets (see above).
• In-App Dashboard Customizer (/dashboard-widgets): toggle, reorder, preview, and pin/unpin 15 widgets across essential/optional/premium categories. Pinned essentials (prayer-times, daily-ayah, daily-hadith) cannot be removed. Layout persists to localStorage and syncs across sessions.
• Architectural Resilience & Performance: (existing content unchanged)
  • Next Prayer Widget (4×2 & 4×1): Real-time countdown timer, progress ring, next prayer badge, and location chip. Uses exact alarms for sub-second prayer transitions.
  • Daily Ayah Widget (4×2): Beautiful typography using Scheherazade New font, RTL support, Surah/Ayah reference chip, and English translation.
  • Daily Hadith Widget (4×2): Complete Hadith snippet with color-coded grade badge (Sahih, Hasan, Da'if), book source chip, narrator attribution, and RTL alignment.
  • Quran Progress Widget (4×2): Circular progress ring, current Surah badge, total completion percentage, streak counter, and Ramadan goal progress indicator.
  • Tasbeeh Counter Widget (2×2): Interactive tap-to-increment counter with zero-latency PendingIntent execution, haptic vibration feedback, target rollover, and instant reset button.
• Architectural Resilience & Performance:
  • Single Source of Truth (WidgetPrefs): Backed by Android SharedPreferences with atomic synchronization to prevent race conditions during rapid taps.
  • WorkManager Refresh Engine (WidgetRefreshWorker): 30-minute periodic update loop with automatic self-stop when no widget instances are on the home screen to conserve battery.
  • Exact Alarm Manager (WidgetAlarmScheduler): Schedules high-precision alarms for prayer times; automatically degrades to 15-minute inexact windows if exact alarm permission is denied on Android API 31+.
  • System Event Survival (WidgetBootReceiver): Automatically restores prayer alarms, enqueues periodic syncs, and refreshes layouts after device reboot (BOOT_COMPLETED, LOCKED_BOOT_COMPLETED), time zone change (TIMEZONE_CHANGED), manual time set (TIME_SET), or language change (LOCALE_CHANGED).
  • Background Motion & Location Sync (WidgetForegroundService): Battery-friendly step detection and location monitoring (10km threshold) to update widgets during travel. Stays alive while any widget type is placed — each widget's removal handler verifies all widget types before stopping the service or cancelling alarms.
  • Capacitor Bridge (WidgetBridge): TypeScript layer with strict runtime validation (validatePrayerPayload, validateQuranProgressPayload), automatic exponential backoff retries, and no-op web fallbacks.
  • Responsive Scaling & Layouts: Configured with standard Android grid dimensions (targetCellWidth="4", targetCellHeight="2"), auto-fitting text views, ellipsize="end", and graceful empty states (layout_empty) to ensure pixel-perfect rendering across all screen densities (from mdpi up to xxxhdpi).

---

🚀 Technical Architecture & Privacy

Noor Connect is built from the ground up for performance and ethical transparency.

• Frontend Core: React 18, TypeScript, Vite, Tailwind CSS, & Framer Motion.
• Enterprise GitHub Upgrades: Version-aware changelog with an in-app "What's New" modal that highlights new features on every update, with per-version change tracking and a green badge indicator for unseen updates.
• F-Droid First (FOSS):
  • Strictly Zero Analytics, Zero Trackers.
  • Pre-configured foss Gradle flavor specifically built to strip play-services for pure open-source distribution.
  • Fastlane F-Droid metadata integration ready.
  • APK Size Optimization: Implemented a comprehensive F-Droid prebuild script (clean-dist-data.js) to strip >300MB of redundant JSON data from bundled assets. Uses local Mushaf WebP storage and CDN fallback to maintain feature completeness while keeping footprint manageable.
• Data Portability: Full App Backup & Restore capabilities directly to internal storage (localStorage + Capacitor Preferences). The latest snapshot is saved automatically every 20 minutes and on app close, with an automatic restore prompt after reinstall. All data stays strictly local.
• Unified Backup Service: A single backup-service.ts consolidates the legacy backup systems — old backups are auto-migrated on first launch. Platform-aware export: Android opens the native share sheet (Capacitor Filesystem + Share), web uses blob download. Every operation returns a typed result with plain-language errors — nothing fails silently.
• Android Auto Backup Rules: backup_rules.xml + data_extraction_rules.xml include WebView storage, Capacitor Preferences and widget prefs (large caches excluded to respect the 25MB cloud limit), so Google's silent cloud backup survives uninstall/reinstall on eligible devices.
• Low-End Device Optimizations (2016+ devices, 30+ FPS target):
  • Adaptive device detection (device-performance.ts) — CPU cores, device memory, connection type, save-data mode
  • Automatic animation reduction (shouldReduceAnimations) respecting prefers-reduced-motion
  • Debounced/throttled event handlers
  • IntersectionObserver lazy loading, critical resource preloading
  • Performance mode presets: low/medium/high based on hardware
  • Singleton FPS monitor: Module-level RAF loop with ref counting — only 1 loop total, auto-stops when no listeners remain
• React Query Tuning: Stale times, cache times, and retry policies adapted for constrained devices

---

🛠️ Getting Started (Local Development)

Prerequisites

• Node.js: v18+
• Android Studio / Gradle: Required to build native Capacitor packages

Clone & Run

git clone https://github.com/darkmaster0345/Noor-connect.git
cd Noor-connect
npm install

# Run the local frontend Vite instance
npm run dev

Build & Export Android / F-Droid

For a standard Android APK targeting Google APIs:

npm run build
npx cap sync android
npx cap open android

For F-Droid (Strict FOSS, No Proprietary Blobs): As per the .fdroid.yml config, run Gradle with the foss directive:

./gradlew assembleRelease -Pfoss=true

---

📄 License & Open-Source

This project is licensed under the GNU General Public License v3.0.

"Indeed, in the remembrance of Allah do hearts find rest." (Ar-Ra'd 13:28)

📱 Screenshots

Home Dashboard	Services	Qibla Compass
Live Streams	Quran Radio	Islamic Quiz
Islamic Remedies	Hadith Encyclopedia	Settings

Note: Screenshots showcase Noor's comprehensive Islamic companion features, including advanced Quran reading, native widgets, gamified learning, and privacy-first interface design.