walidozich/quran-app

Sahibok, called quran-app in this repository, is a mobile app for Quran learning built for Arabic speaking families. Students record themselves reciting the Quran, and teachers listen back and leave timestamped feedback pinned to the exact moment of a mistake, combining a voice correction, a text comment, and tags at that point in the recording. Teachers can assign wirds, meaning specific portions of the Quran to recite, and track how each student is progressing over time. Students see their feedback organized around those exact moments, can filter past mistakes by tag, and respond with new recorded attempts, forming an ongoing review conversation. The app supports multiple people sharing one phone through a family style profile picker, up to six profiles per account, and any profile can switch between being a student or a teacher depending on the class. A single class can also have more than one teacher, joining with a shared class code, while administrative control stays with the original class owner. The app is built with Expo and React Native in TypeScript, laid out right to left for Arabic, and it uses a cloud Supabase backend for accounts, file storage, and access control, so phones do not need to be on the same WiFi network to work together. To try it during development, you install Node 20 or newer and the Expo Go app, then run a provided script that connects to the cloud backend over a tunnel. To install it as a normal app on an Android phone, a separate script builds an installable APK file using JDK 17 and the Android SDK. This project is explicitly a charity project, described by the author as a sadaqah, a continuing charitable deed, and it is released under the PolyForm Noncommercial License. That license does not allow selling it, charging for access, adding paywalls, or adding advertising, though anyone can use it, modify it, and share it for free. It is aimed at Quran teachers and students, particularly families or small classes looking for a structured way to give and receive recitation feedback.