Public API

Nastaleeq Quran API

A free, public REST API that serves high-quality images of all 604 pages of the Holy Quran in the Nastaleeq script, optimized for mobile and web Quran applications.

Type

Open Source

Project Overview

"Empowering developers to build beautiful Quran apps."

The Nastaleeq Quran API is designed to provide high-quality, hosted images of the 15-line Hifz Quran style (Nastaleeq script). It is widely used in India, Pakistan, and neighboring regions. Hosted on Cloudinary and deployed serverlessly on Vercel, it ensures fast CDN delivery and reliable endpoints.

604 Quran Pages

Complete 15-line/Hifz Quran style pages in Nastaleeq script.

CDN Delivery

Images are hosted on Cloudinary for fast, reliable delivery.

REST Endpoints

Endpoints for metadata, precise image redirects, and health checks.

302 Redirects

Optimized for mobile apps with optional query parameters for cropping.

System Architecture

Built as a lightweight Express server deployed serverlessly for maximum uptime and minimal latency.

API Layer

Express.js • Node.js 22.x

RESTful endpoints handling requests, metadata generation, and 302 image redirects.

Storage Layer

Cloudinary • JSON

High-performance CDN hosting for optimized JPEG images.

Deployment

Vercel Serverless

Serverless execution ensuring automatic scaling and high availability.

Core Functionalities

Page Metadata

Fetch robust metadata for each of the 604 pages, including thumbnails.

Dynamic Cropping

Optional query parameters tailored to remove borders instantly.

Batch Uploading

Custom scripts to efficiently upload and index massive image sets.

Health Monitoring

Dedicated /health endpoint for uptime checks.