Hosted API access is disabled on `al-quran-database.vercel.app` for now. Use the repository locally or self-host this project to run the API endpoints documented here.

Project Roadmap

Tracking the evolution of the Quran Developer Platform. From core data engineering to AI-driven semantic exploration.

Phase 1: Intelligence & Search

Completed

Ranked Search via FlexSearch
Arabic Text Normalization
Advanced Filtering System

Phase 2: Developer Ecosystem

Completed

JS/TS Developer SDK
PostgreSQL & SQLite Exports
Sharded Data Pipeline

Phase 3: Production Readiness

Completed

GraphQL API Layer
Multi-Level Caching (Redis)
Knowledge Base Integration
Centralized Logging & Proxy

Phase 4: Advanced Scaling

In Progress

Semantic Search (Vector Embeddings)
Interactive API Playground
npm registry publishing for @faha1999/al-quran-database
Audio Recitation Streaming API

Future Horizon

Beyond Phase 4, we are exploring **Knowledge Graphs** for visual thematic mapping, **Dockerized self-hosting** templates, and **PWA capabilities** for offline-first documentation and API mock servers. Current workspace package already exists under `packages/sdk`; public registry publishing is still pending.