Live at versemadeeasy.com

Learn Quran translation through practice. Read Arabic verses, write your understanding, and receive AI-powered feedback.

• Practice translating any of 6,236 Quranic verses
• Word-by-word analysis with roots, grammar, and morphology
• No sign-up required - start learning immediately
• Mobile-friendly, works offline after first load

git clone https://github.com/foyzulkarim/qalam.git
cd qalam
npm install
npm run dev

Visit http://localhost:3000

• Architecture - Technical overview and data flow
• Setup Guide - Detailed setup and deployment instructions
• LLM Integration - How verse analysis is generated
• Learning Philosophy - The pedagogical approach

• Next.js 16 (static export)
• TypeScript
• Tailwind CSS
• Deployed on Cloudflare Pages

Contributions welcome! See the docs for architecture details.

The Quran is sacred, and accuracy is non-negotiable.

This project does NOT use AI/LLM to generate, translate, or modify any Quranic text. All Arabic text, translations, and transliteration are taken verbatim from Tanzil.net — a trusted, peer-reviewed source used by scholars worldwide.

Where AI is used:

1. Word analysis — Linguistic breakdown (roots, grammar, morphology) generated by local LLM, stored in public/data/analysis/
2. Practice feedback — Comparing your translation attempt against the authentic Tanzil.net translation

The LLM never touches the source text. It only provides supplementary learning aids.

• Quranic text and translations from Tanzil.net — distributed verbatim, unmodified
• Sahih International translation

"Read, in the name of your Lord who created." — Al-Alaq (96:1)