How Qisas Works

When you're going through something — grief, anxiety, doubt, gratitude, confusion — the Quran and the Prophet's life ﷺ contain stories that speak directly to your situation. Qisas connects your feelings to those stories.

1. You share what you're going through — in your own words. No filters, no categories to pick from.
2. Qisas understands your emotion — matching your words to themes like patience (sabr), trust (tawakkul), justice (adl), and more.
3. A Quran verse speaks to you — found through semantic search from the Quran Foundation API, with Arabic text and English translation.
4. A seerah story connects — from the Prophet's life ﷺ, showing how he and his companions faced similar struggles.

Qisas is built on three sources:

• The Quran — via the Quran Foundation API with 126+ translations
• Hadith collections — 857 authenticated references from Sahih Bukhari and Sahih Muslim
• Seerah events — 46 curated events from the Prophet's life, covering the Meccan period, Hijrah, Madinah, and the Farewell era

Qisas is not a fatwa engine, a replacement for scholars, or an Islamic Google. It's a reflective tool — a bridge between your feelings and the wisdom that already exists in the Quran and Sunnah. For serious religious questions, always consult a qualified scholar.

• Next.js + Tailwind CSS
• Supabase (PostgreSQL)
• Quran Foundation API
• Sahih Bukhari & Muslim (hadith-json dataset)