Releases: ibtesaamaslam/ISLAM
v1.0.0 ISLAM
🌙 Reclaim Your Heart — Official Release Document
Version: 1.0.0 Release Date: April 2025
© 2025 Ibtesaam Aslam — All Rights Reserved
Version: 1.0.0
Release Date: April 2025
Codename: Ramazan Gift
Author: Ibtesaam Aslam
Live URL: reclaimyourheart.vercel.app
Repository: github.com/ibtesaamaslam/ISLAM
"My Lord, increase me in knowledge." — Surah Ta-Ha, 20:114
Table of Contents
- [Executive Summary]
- [Release Background & Spiritual Intent]
- [Target Audience & Use Cases]
- [What's Included in v1.0.0]
- 4.1 [Smart Quran Reader]
- 4.2 [AI-Powered Tafseer Engine]
- 4.3 [Audio Recitation System]
- 4.4 [AI Companion Chat]
- 4.5 [Hasanat Gamification System]
- 4.6 [Discover Islam Module]
- 4.7 [Offline Mode & Caching]
- [Technical Stack & Architecture Decisions]
- 5.1 [Why React 19 + Vite]
- 5.2 [Why TypeScript]
- 5.3 [Why Google Gemini]
- 5.4 [Why Vercel Serverless]
- 5.5 [Why Tailwind CSS + Framer Motion]
- [Serverless API — Detailed Breakdown]
- [Project File Structure — Annotated]
- [Data Sources & External Integrations]
- [State Management & Data Persistence]
- [Installation Prerequisites & Environment Setup]
- [Local Development — Step-by-Step]
- [Production Deployment on Vercel]
- [Environment Variable Reference]
- [Known Limitations in v1.0.0]
- [Versioned Roadmap — v1.1 through v3.0]
- [Security & Privacy Posture]
- [Performance & Accessibility]
- [Contribution Policy]
- [Code of Conduct — Islamic Adab]
- [Intellectual Property & License]
- [Author Profile]
- [Acknowledgments & Third-Party Credits]
- [Closing — The Niyyah Behind This Project]
1. Executive Summary
Reclaim Your Heart is a full-stack, AI-powered web application that serves as a digital spiritual companion for Muslims and non-Muslims seeking to engage with the Holy Quran and the teachings of Islam. It is the first and only application of its kind to combine:
- A beautifully rendered, multi-language Quran reader with authentic Arabic typography
- Per-Ayah AI-generated Tafseer (explanation), Asbab al-Nuzul (context), and dynamic quizzes — powered by Google Gemini
- Voice recitation by world-class Qaris, with verse-by-verse synchronization
- A Hasanat-based gamification system to cultivate daily Quranic engagement
- A dedicated Islamic education module for children, reverts, and non-Muslims
- Full offline support for downloaded Surahs
Version 1.0.0 represents the first stable, publicly deployed release of the platform. It is live at [reclaimyourheart.vercel.app] and does not require account registration to use.
The application is built entirely in TypeScript (99.9%) on a React 19 + Vite frontend and a Node.js + Express serverless backend, deployed to Vercel's edge network for global availability.
2. Release Background & Spiritual Intent
This project was conceived, designed, and built during the Holy Month of Ramazan — the month in which the Quran was first revealed, and the most spiritually charged period in the Islamic calendar.
The founding philosophy was not merely technical. Every architectural decision, every design choice, and every line of code was written with a specific niyyah (نية — intention): to earn Sadaqah Jariyah (صدقة جارية), a form of continuous charity in Islam — good deeds whose rewards extend beyond one's lifetime as long as others benefit from the work.
The core creative mandate was deliberately simple and bold:
"Build an interface that feels crafted, not just coded."
This principle meant rejecting template-driven design, cookie-cutter UI libraries, and generic AI aesthetics in favour of something deeply intentional — a platform that honours the reverence due to the Word of Allah (ﷻ) through thoughtful technology.
The project is not positioned as a utility. It is positioned as a sanctuary — a quiet, distraction-free digital space where the seeker can engage with the Quran at whatever level they are on their journey.
3. Target Audience & Use Cases
This release is designed to serve a wide and diverse global audience united by a single need: meaningful access to Islamic knowledge.
| Audience Segment | Primary Use Case |
|---|---|
| Practising Muslims | Daily Quran reading with depth through AI Tafseer and audio recitation |
| Muslim Children | Age-appropriate, gamified Islamic education with visual rewards |
| New Reverts | Guided entry into foundational Islamic concepts through Discover Islam |
| Non-Muslim Curious Users | Exploring Islamic teachings, science in the Quran, and answers to questions |
| Students of Islamic Knowledge | Using the Tafseer engine and AI Chat for study and research support |
| Parents & Teachers | A safe, curated, controlled environment to teach children about Islam |
| Memorisation (Hifz) Students | Verse-by-verse audio playback for Tajweed training |
| Researchers & Developers | Reviewing the technical architecture of a faith-tech full-stack application |
4. What's Included in v1.0.0
4.1 Smart Quran Reader
The Quran reader is the primary interface of the application and represents the...