Murajah (مراجعة) is a comprehensive application designed to help Quran students memorize and maintain their memorization through systematic review and practice.
In Arabic, "muraja'ah" means review, revision, or repetition. In the context of Quranic studies, it specifically refers to the practice of repeatedly reciting and revising previously memorized verses to prevent forgetting them.
- General meaning: Review, revisiting, or revising something
- Specific meaning in Quranic studies: The essential act of repeating and reviewing already memorized portions of the Quran to maintain them
This practice is fundamental to Quran memorization, as it helps prevent memorization from deteriorating over time.
Memorizing the Quran is a profound spiritual journey, but maintenance is equally critical. Murajah addresses this by:
- Preventing Forgetting: Regular revision ensures memorization stays fresh and long-term
- Tracking Progress: Monitor what you've memorized and areas needing improvement
- Building Accountability: Daily goals and statistics keep you motivated
- Identifying Weaknesses: Track mistakes to focus on challenging verses
- Structured Learning: Organized review schedules optimize retention
- Overview of your memorization progress
- Daily statistics and achievements
- Visual progress indicators
- Full Quran text with proper formatting and Tajweed rules highlighting
- Page-by-page navigation matching the standard Quran (Madinah Mushaf)
- Word-by-word translation and meanings
- Customizable text size (Small, Medium, Large)
- Record your recitations
- Listen back to your recordings to identify mistakes
- Manage multiple recordings
- Interactive quizzes based on selected surah
- Multiple question types:
- Word completion
- Verse continuation
- Verse Translation
- Lightning modes
- Real-time score
- Visual grid display of memorized Juz
- Color-coded memorization status
- Quick access to any memorized content
- Progress overview at a glance
- Mark mistakes
- Statistics on mistakes
- Text size preferences
- Tajweed rules display toggle
- Data export and backup options
- Real-time progress metrics
- Memorization completion percentage
- Daily goal tracking
- Streak counter
- Achievement badges
- Keyboard shortcuts (Press H for more information)
- Intuitive menu system
- Quick links to all features
- Surah (chapter) selection
- Jump to page functionality
- Random memorized page
- A modern web browser (Chrome, Firefox, Safari, Edge)
- Internet connection
-
Fork or Clone the Repository
git clone https://github.com/wasi0013/Murajah.git cd Murajah -
Enable GitHub Pages
- Go to your repository settings
- Navigate to "Pages" section
- Select
masterbranch as the source - Select
/sourceas the folder - Save
-
Access Your App
- Your app will be available at:
https://yourusername.github.io/Murajah/
- Your app will be available at:
Note: Data is stored locally in your browser, so it persists across sessions on the same device.
-
Prerequisites
- Cloudflare account (free tier available)
- GitHub account with the Murajah repository
-
Connect Cloudflare to GitHub
- Log in to Cloudflare Dashboard
- Navigate to "Pages" section
- Click "Create a project"
- Select "Connect to Git"
- Authorize and select your Murajah repository
-
Configure Build Settings
- Production branch:
master - Build command: Leave empty (no build step needed)
- Build output directory:
source
- Production branch:
-
Deploy
- Save and deploy
- Your app will be available at a Cloudflare-provided URL
- You can add a custom domain if you own one
-
Access Your App
- Visit your Cloudflare Pages URL
- Navigate to
index.htmlor the root URL
Benefits of Cloudflare Pages:
- Global CDN for faster loading
- Free HTTPS/SSL
- Automatic deployments on git push
- More reliable than GitHub Pages
- Option to add custom domain
-
Clone the repository:
git clone https://github.com/wasi0013/Murajah.git
-
Navigate to the source directory:
cd Murajah/source -
Start a local server (choose one):
# Python 3 python3 -m http.server 8000 # Or with Node.js (http-server) npx http-server
-
Open your browser and visit:
http://localhost:8000/index.html
- All your data (memorization progress, mistakes, bookmarks, recordings) is stored locally in your browser
- Important: Data is specific to each browser and device
- Regular backups are recommended
- Use the Settings panel to export your progress as JSON
- Keep backups on your computer or cloud storage
- ✅ No server-side storage
- ✅ All data remains on your device
- ✅ Completely private and secure
Murajah/
├── source/
│ ├── index.html # Main application
│ ├── quiz.html # Quiz mode interface
- Frontend Framework: Vue.js 3
- Styling: Tailwind CSS
- Icons: Line Awesome
- Data Format: JSON
- Storage: Browser LocalStorage (IndexedDB)
- Fonts: Custom Quran fonts for proper Tajweed display
The app displays Quranic text with proper Tajweed (rules of recitation) highlighting, making it easier to learn correct pronunciation and recitation rules. (Press T to toggle)
Record your own recitations and compare them with standard recordings to improve your delivery. (Press R)
Track your memorization journey with detailed statistics on:
- Daily/weekly/monthly progress
- Mistakes tracking per page
- Statistics
Found a bug or have a feature request? Feel free to:
- Open an issue on GitHub
- Submit a pull request with improvements
- Share your feedback
This project is open-source and available for personal use. Please check the LICENSE file for detailed terms.
For questions, issues, or suggestions:
- Check existing issues on GitHub
- Create a new issue with detailed description
- Include your browser and device information
- Quran data sourced from https://github.com/TarteelAI/quranic-universal-library
- Tajweed font is also from quran.com
Start your memorization journey with Murajah today! Make review easy, systematic, and rewarding. 📖✨ May Allah accept your efforts in memorizing and preserve His Words in your heart. 🤍
May Allah bless all the JSON resource providers and quran.com team.