Skip to content

darkmaster0345/Noor-connect

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

232 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Untitled design

πŸŒ™ Noor Connect - Your Ultimate Islamic Companion

License: MIT Status F-Droid Compatible

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.

✨ The Complete Feature Set

πŸ“– Enhanced Quran & Tafsir Explorer

  • Complete Holy Quran: Clean, beautifully styled Uthmani and Indo-Pak reading interfaces.
  • Advanced Tafsir System: 25+ global Quranic commentary editions instantly accessible via high-speed spaCy API integration, eliminating heavy database overhead.
  • Multilingual Support: Read meanings and Tafsir in English, Arabic, Bengali, Urdu, and Russian.
  • Recitation Playback: Immersive background audio from multiple reciters with progress tracking.

πŸ•‹ Premium Qibla Compass

  • High-Precision Native Sensors: Completely overhauled native compass utilization tapping into device magnetometers for raw, smooth orientation.
  • 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.

⏲️ 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!
  • Optimized TTS & Audio: Highly tuned Adhan playback utilizing an advanced audio engine to prevent interruptions or background sleep killing.

πŸ“Ώ 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.
  • 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.
  • Hisnul Muslim & Duas: Comprehensive library of authentic supplications for all occasions.
  • Names of Allah (Asma-ul-Husna): Beautifully rendered 99 Names of Allah with meanings and fluid animations.
  • Enhanced Islamic Quiz: Test your knowledge of Deen with interactive, gamified Islamic quizzes. Includes daily rewards, combo multipliers, mystery boxes, and reliable cross-platform gamification logic.
  • Islamic Remedies (Tibb-e-Nabawi): Prophetic medicine index with 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.

πŸ“» Rich Media & Islamic Library

  • Optimized E-books & Hadith: Effortlessly read through massive PDF libraries and Hadith encyclopedias using an optimized, lag-free UI design.
  • 24/7 Quran Radio & Streams: Direct live video and audio streams right from Makkah, Madinah, and specialized global recitation networks.
  • Weather & Custom Widgets: Customizable dashboard layers including localized weather, Islamic dates, and quick-action shortcuts.

πŸ“± Enhanced Widget System & Dashboard

  • Native Android Widgets Suite: Beautiful, lightning-fast native Kotlin widgets including Next Adhan, Daily Ayah, and Daily Schedule arrays.
  • Live Background Radio Widget: Experience 24/7 Quran Radio streams with direct play/pause/skip controls right from your home screen notification center.
  • Live Interactive Previews: Complete visual grid customizer in the web dashboard allows you to instantly preview the color schemes and layouts of widgets before enabling them.
  • Robust Platform Abstraction: All Android native widget background updates are wrapped with robust Capacitor checks (capacitor-utils.ts) to completely eliminate cross-platform console errors when running in the browser.
  • Dual Update Modes: Support for both basic (next-prayer only) and full (prayer schedule, Quran data, Hijri date) widget updates straight to the Android home-screen.
  • Automatic Background Sync: Configurable auto-update timer (every 30 minutes) perfectly syncs the app to your home screen using native Android widgets and services.

πŸš€ 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: Built-in auto-updater component that checks the GitHub repository directly. You can update your APK entirely detached from major app stores.
  • 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.
  • Data Portability: Full App Backup & Restore capabilities directly to internal storage. All data stays strictly local.

πŸ› οΈ 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 generously licensed under the MIT License.

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

ao2r6ooztsbzqzs0gyot kz29bm528tqdlrkdllka p2nplsqzwlfgltgpwcyv