Skip to content
github-actions[bot] edited this page Nov 15, 2026 · 6 revisions

Welcome to Shajara (شجرة الأنبياء) · Interactive Prophets Family Tree Wiki

Welcome to the official documentation for Shajara (@Bosaj/prophets-family-tree), an open-source, interactive genealogical, geographic, and natural history visualization of the 25 Prophets named in the Holy Qur'an, their sacred lineages, migrations, and cosmic environments.

Live Deployment (GitHub Pages): https://bosaj.github.io/prophets-family-tree/
Mirror (Vercel): https://shajara-prophets.vercel.app
Current version: v2.10.2 · Releases · Changelog


🌟 Key Features

  1. Complete Quranic Lineage & Kinship (/tree):

    • 25 Prophets named in the Qur'an from Adam (peace be upon him) to Muhammad ﷺ.
    • Extended family graph: Spouses (Ummahat al-Mu'minin, Sarah, Hajar, Safura, Hawwa), children (Qabil, Habil, Shith, Sam, Ham, Yafith, Yam, Ismail, Ishaq, Yaqub, Yusuf, Binyamin, Fatimah, etc.), siblings, and ancestors.
    • Interactive family filters allowing viewers to isolate Prophets, reveal Spouses, display all Children, or explore the entire extended family network.
    • Interactive Relational Legend & Highlighting: Bidirectional highlighting between canvas edges and the interactive legend (parent, descendant, marriage, sibling, cousin, guardian).
  2. Pre-Adamic Realm & Iblis:

    • Autonomous floating celestial realm positioned above Adam documenting earlier earthly creations (Jinn, Iblis / Satan, Hinn, Binn, Nasnas) cited in classical Islamic scholarship (Ibn Kathir, Al-Hasan al-Basri) and the Qur'an (18:50, 38:76, 2:34).
    • Strictly decoupled from Adam's lineage, reflecting orthodox Islamic theology that Adam was created directly from clay without ancestors.
  3. Topography Map & Prophetic Routes (/map):

    • Interactive 3D Leaflet historical topography maps tracing migration routes, sanctuaries, and waypoints across the Hijaz, Levant, Egypt, and Mesopotamia with elevation layers.
  4. Prophetic Nature, Flora & Fauna (/nature):

    • Showcase of 29 animals, plants, and foods cited in the Qur'an and Sunnah (hoopoe, whale, camel, bee, ant, olive, fig, date palm, pomegranate, black seed, talbinah, etc.) with detailed nutritional/healing benefits, zoological classifications, and scriptural occurrences.
    • Celestial Sun, Moon, Dunes & Cloud Theater: Real-time dynamic solar altitude calculations, astronomical moon tracking with craters, drifting atmospheric clouds, and wind-carved desert dunes.
  5. Dual Synchronized Timeline (/timeline):

    • Hijri (BH / AH): Calculated prophetic chronology anchored in classical Islamic historiography.
    • Historical (BCE / CE): Historians' comparative chronological estimates.
    • Qur'anic Anchors: Strict scriptural anchor verses (e.g., 7:69, 7:74, 40:34, 2:246, 5:46, 33:40) that fix sequence and contemporaries.
  6. Authenticity & Source-Level Integrity:

    • Strict 4-tier evidentiary classification:
      • 🟢 Qur'an: Explicit scriptural text with live Uthmani script loading from the Al Quran Cloud API and Mishary Alafasy audio recitation.
      • 🔵 Hadith: Verified authentic narrations linked to Sunnah.com.
      • 🟡 Tradition (Sira / Qisas): Classical scholarly historiography (Ibn Kathir, Al-Tabari).
      • 🟣 Disputed / Historians: Comparative chronology and external estimates clearly noted.
    • Zero human depictions of any prophet: Respecting Islamic theology, representations strictly use celestial geometry, calligraphy, and atmospheric landscape scenes.
  7. Sahaba, Khulafa' & living lineages (/sahaba): succession tree and timeline from the Prophet ﷺ and Ahl al-Bayt through the Rightly Guided Caliphs and the historic caliphates to today's Sharifi dynasties, plus biographies of the hadith masters.

  8. The Qur'an, the Sunnah and modern science (/science): verses and hadith placed next to peer-reviewed research, each paper with a checked DOI. Presented as interpretation, not proof.

  9. Stature, stories, scriptures and sources (/stature, /stories, /scriptures, /sources): heights the texts give (illustrative ones marked and drawn as pillars), the stories of the Qur'an and the righteous, the revealed books, and every reference with the photo credits.

  10. Worship and the calendar (/salat, /times, /duas, /hijri, /islam, /hour):

  • The prayer: what it is, its conditions, the ablution, how to pray step by step with posture figures, the rak‘ahs of the five prayers, the Sunnah prayers and the remembrance after it. Maliki notes where the schools differ.
  • Prayer times for your place (Morocco follows the Ministry of Habous method), the parts of the day with their guidance, and the Prophet’s supplications in full.
  • The Hijri calendar: today’s date by country (Morocco from the Ministry’s announcements, Saudi Arabia by Umm al-Qura, Turkey by Diyanet), the twelve months, the two Eids, al-Kahf 300/309, and fasting reminders with a calendar file (alarm the evening before).
  • What is Islam? and the beginning and the end (creation, the signs of the Hour with a checklist, the end).
  • Every Arabic hadith is copied from its source and checked in CI (150 texts). See Worship pages.
  1. Four languages, offline, always up to date:
  • Arabic, English, French and Spanish across the interface and the data (2,165 long Spanish texts load only for Spanish readers).
  • Works offline after the first visit; a new version replaces the old one by itself. See Languages, offline and updates.

📚 Documentation Navigation


🛡️ Governance & Principles

  • Deterministic Verification: Every Qur'an and Hadith reference, typed verse and research DOI is checked in CI (scripts/verify-sources.mjs, scripts/audit-content.mjs).
  • Semantic Versioning: fixes are PATCH, new pages or datasets MINOR, breaking changes MAJOR; tags, milestones and releases share the vX.Y.Z name.
  • Scholarship First: Content changes must cite authoritative sources. No unverified folkloric claims are merged into canonical profiles.
  • Open Collaboration: Maintained with excellence by Oussama EL HADJI (@Bosaj).

Clone this wiki locally