# Basira — Interactive Qur'an Structural Visualization

> Basira is a free, open-source web application for studying the Qur'an with real-time Tajweed highlighting, word-by-word audio tracking, structural coherence maps, and multi-language translations.

## Overview

Basira provides an immersive, dark-mode reading experience for the Qur'an. It is designed for both casual readers and serious students of Qur'anic sciences. The app integrates classical Islamic scholarship — particularly ʿIlm al-Munāsabāt (the science of structural coherence) — with modern interactive visualizations.

## Key Features

- **Real-time Tajweed**: Arabic text is color-coded with full Tajweed rules (Ghunnah, Ikhfā, Idghām, Iqlāb, Qalqalah, Madd) rendered at native resolution.
- **Word-by-word Audio Tracking**: Audio recitation is synchronized with visual word highlighting at 60fps using requestAnimationFrame for ultra-smooth tracking.
- **Z-Axis Structural GPS**: Interactive macro/meso/micro structural maps of Surah Al-Baqarah based on classical scholarship from Imam al-Biqāʿī, Fakhr al-Dīn al-Rāzī, al-Suyūṭī, Ibn Ashur, Ibn Kathir, and al-Qurṭubī.
- **23+ Language Translations**: Includes English (Sahih International, Abdul Haleem, Yusuf Ali), Dari/Farsi, Pashto, Urdu, Hindi, Turkish, French, German, Spanish, Indonesian, Bangla, Russian, Chinese, and more.
- **Hadith Integration**: Verse-specific Hadith reminders from Sahih al-Bukhari, Sahih Muslim, and Jami' at-Tirmidhi with full scholarly context.
- **Multiple Reciters**: 10 Qur'an reciters with adjustable playback speed (0.5x to 2x).
- **Bookmarking**: Save verses with personal notes for study sessions.
- **Mobile-first Design**: Responsive layout with drawer navigation and bottom sheets for mobile.
- **PWA Support**: Installable as a native app.

## Supported Surahs

1. **Surah Al-Baqarah (2)** — Full structural analysis with Z-Axis visualization, Hadith integration, and Tajweed.
2. **Surah Āl ʿImrān (3)** — Reading mode with Tajweed, translations, and Hadith. Structural analysis coming soon.

## Structural Analysis Methodology

Basira's structural visualizations are grounded in ʿIlm al-Munāsabāt — the classical Islamic science of studying the coherence and interconnection between Qur'anic verses and surahs. Key scholars referenced:

- **Imam Burhān al-Dīn al-Biqāʿī** (d. 885 AH): Author of "Naẓm al-Durar" — the most comprehensive work on Qur'anic structural coherence.
- **Fakhr al-Dīn al-Rāzī** (d. 606 AH): His tafsir "Mafātīḥ al-Ghayb" extensively analyzes verse interconnections.
- **Jalāl al-Dīn al-Suyūṭī** (d. 911 AH): Systematized munāsabāt as a Qur'anic science in "al-Itqān."
- **Ibn ʿĀshūr** (d. 1393 AH): His "al-Taḥrīr wa al-Tanwīr" combines classical and modern structural insights.
- **Ibn Kathīr** (d. 774 AH): Hadith-based tafsir providing verse-level context.
- **al-Qurṭubī** (d. 671 AH): Legal and structural analysis in "al-Jāmiʿ li-Aḥkām al-Qur'ān."

## Notable Verse Hadith

- **Āyat al-Kursī (2:255)**: "Whoever recites Āyat al-Kursī after every obligatory prayer, nothing will prevent him from entering Paradise except death." (Sunan an-Nasa'i 9928)
- **Last Two Verses (2:285-286)**: "Whoever recites the last two verses of Surah Al-Baqarah at night, they will suffice him." (Sahih al-Bukhari 5009). These verses were revealed during the Mi'rāj from beneath the Throne of Allah (Sahih Muslim 806).
- **The Qiblah Change (2:142-144)**: Marks the structural hinge of Surah Al-Baqarah.
- **Āyat ad-Dayn (2:282)**: The longest verse in the Qur'an establishing Islamic contract law.

## Technical Stack

- Next.js 16 (App Router, TypeScript)
- Tailwind CSS (dark mode)
- Framer Motion (animations)
- Recharts (data visualization)
- Quran.com API v4 (verses, translations, Tajweed)
- EveryAyah API (audio recitation)

## Contact

Website: https://basira.institute