Skip to content

Implement Quran Explorer - Educational tool showcasing QUL's rich Quranic resources#372

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/fix-251
Draft

Implement Quran Explorer - Educational tool showcasing QUL's rich Quranic resources#372
Copilot wants to merge 3 commits intomainfrom
copilot/fix-251

Conversation

Copy link
Contributor

Copilot AI commented Aug 20, 2025

This PR implements a comprehensive Quran Explorer - an educational tool that showcases the rich set of Quranic resources available in the Quranic Universal Library (QUL). The explorer serves to educate the community about the depth of data available and inspire developers, educators, and researchers to build new applications using QUL.

🎯 Overview

The Quran Explorer provides three main interactive views:

📖 Surah View

  • Complete chapter information with Arabic and English names
  • Revelation details (period, place, order) and major themes
  • Comprehensive statistics (verse count, word count, pages, rukus)
  • Chapter information and descriptions
  • Navigation between surahs

📝 Ayah View

  • Arabic text in multiple scripts (Uthmani, QPC Hafs, IndoPak)
  • Available translations in various languages
  • Tafsir (commentary) explanations
  • Audio recitations with playback controls
  • Interactive word-by-word analysis
  • Grammar and morphology details

🔤 Word View

  • Individual word analysis with detailed morphological data
  • Root, stem, and lemma information
  • Word-by-word translations in multiple languages
  • Grammatical concepts and classifications
  • Related words sharing the same root
  • Multiple Arabic script formats

🛠 Technical Implementation

New Components:

  • QuranExplorerController with robust error handling and data loading
  • RESTful routes: /explorer, /explorer/surah/:id, /explorer/surah/:id/ayah/:id, /explorer/surah/:id/ayah/:id/word/:position
  • Responsive views using Tailwind CSS consistent with existing codebase
  • Navigation integration in main header and mobile menu

Data Integration:

  • Leverages existing models: Chapter, Verse, Word, Translation, Tafsir, AudioFile, ChapterInfo
  • Includes morphological data via Morphology::Word and grammar concepts
  • Audio integration with recitation details and playback support

🎨 User Experience

  • Clean, modern interface with proper Arabic text rendering (RTL support)
  • Breadcrumb navigation for seamless exploration between levels
  • Responsive design optimized for both mobile and desktop
  • Interactive elements with hover states and smooth transitions
  • Comprehensive error handling for missing data

📷 Screenshots

The implementation includes:

  • Main explorer landing page with feature overview and surah grid
  • Detailed surah view with statistics and verse listings
  • Comprehensive ayah analysis with multiple data sources
  • In-depth word analysis with morphological breakdown

This tool successfully demonstrates the depth and breadth of Quranic data available in QUL, fulfilling the goal of educating the community about these valuable resources while providing a foundation for future educational applications.

Fixes #251.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

@zeet-co
Copy link

zeet-co bot commented Aug 20, 2025

We're building your pull request over on Zeet.
Click me for more info about your build and deployment.
Once built, this branch can be tested at: https://quranic-universal-library-my2s-co-25a356.tarteel-v3.tarteel.io before merging 😉

Co-authored-by: naveed-ahmad <701567+naveed-ahmad@users.noreply.github.com>
…rovements

Co-authored-by: naveed-ahmad <701567+naveed-ahmad@users.noreply.github.com>
Copilot AI changed the title [WIP] Quran explorer Implement Quran Explorer - Educational tool showcasing QUL's rich Quranic resources Aug 20, 2025
Copilot AI requested a review from naveed-ahmad August 20, 2025 13:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Quran explorer

2 participants