Updates, product notes, and engineering write-ups from QuranPortal, a Quran and Qaidah progress tracking app for learners, families, tutors, schools, maktabs, and madrasahs.
The blog covers the practical work behind QuranPortal: rendering digital mushaf pages, tracking mistakes at precise positions, managing classroom assignments, building Quran range parsers, and improving the daily workflows teachers and students use to review progress.
Notes on assignments, Sabaq, Sabqi, Manzil, reading practice, Qaidah progress, parent updates, and the handoff between teacher feedback and student review.
Deep dives into digital mushaf rendering, Quran text ranges, word-level mistake marking, character-level feedback, and how QuranPortal represents recitation work.
Behind-the-scenes updates on classroom management, timelines, data modeling, and the technical choices that make the app faster for real Quran programs.
How QuranPortal's updated access controls help schools, tutors, families, observers, and self-managed learners work together without exposing more student information than needed.
How we unified assignments and notes into a single queryable timeline using Rails delegated_type, with real-time Turbo Stream broadcasting to multiple teacher dashboards in 210 lines of code.
A deep dive into parsing flexible human input like 'Baqarah 255', 'juz 30 Q1-3', and 'pg 233 H1' into precise verse boundaries. Covers fuzzy surah matching, digit normalization, and progressive state feedback.
How we built character-level mistake tracking for Quranic recitation. Covers Arabic Unicode decomposition, diacritic positioning, the tap-based selection UI, and a 50+ type mistake hierarchy.
Step-by-step guide to setting up Classrooms in QuranPortal. Learn how to create classes, assign co-teachers, add students, and use the filtered teacher dashboard.
A comprehensive guide to building a digital mushaf renderer. Learn about typography, internationalization, and achieving pixel-perfect Quranic layouts.