Quran Hifz Helper — Official User Guide
App: Quran Hifz Helper
Website: https://quran.shakeeb.in
Developer: Shakeeb Ahmad
Version: 1.0.0
Getting Started
What is Quran Hifz Helper?
Quran Hifz Helper is a free, open-source Progressive Web App (PWA) for reading, memorizing, and exploring the Holy Quran. It works offline, looks like a native app, and is available on every platform — Android, iOS, Windows, Mac, and Linux.
How to Install
📱 Android — Play Store
- Open the Google Play Store on your device.
- Search for "Quran Hifz Helper" by Shakeeb Ahmad.
- Tap Install.
- Open the app and start reading!
📱 Android — PWA (Alternative)
- Open Chrome and go to https://quran.shakeeb.in.
- Tap the three-dot menu (⋮) in the top right.
- Tap "Add to Home Screen" or "Install App".
- The app icon will appear on your home screen.
🍎 iPhone / iPad — PWA
- Open Safari and go to https://quran.shakeeb.in.
- Tap the Share button (⬆) at the bottom.
- Scroll down and tap "Add to Home Screen".
- Tap Add. The app icon will appear on your home screen.
💻 Windows / Mac / Linux — PWA
- Open Chrome or Edge and go to https://quran.shakeeb.in.
- Click the install icon (⊕) in the address bar, or go to Menu → "Install Quran Hifz Helper".
- Click Install. The app will open in its own window.
Home Screen
When you open the app, you'll see the Home Dashboard with everything at a glance.
Banner
A promotional or informational banner may appear at the top. Swipe left/right if there are multiple banners. Tap the button (if shown) to take action.
Read & Learn Section
| Button | What it Does |
|---|---|
| Full Quran | Open the complete Quran reader. Tap the ▼ icon to choose a different text source. |
| Browse | See all 30 Juz and 114 Surahs in a grid. Tap any to start reading. |
| Scanned | View high-quality scanned images of physical mushafs. |
| Listen | Listen to audio recitation of any surah by famous Qaris. |
| Memorize | Track your hifz progress with spaced repetition review system. |
Discover
Tap the Discover card to enter a beautiful, Instagram-like experience. Swipe up to see random ayahs with translations on stunning card designs.
Daily Targets
Set your daily reading and memorization goals:
- Tap the ⚙ icon next to "Daily Target".
- Set your daily page target (tilawat), daily ayah target (hifz), number of khatm, and target days.
- Tap Save.
- Tap the tilawat or hifz card to log your progress each day.
- Watch your weekly heatmap and streak grow!
Dark Mode
Tap the 🌗 contrast icon in the top right to toggle dark mode.
Reading the Quran
Opening the Reader
- Tap Full Quran to read the entire Quran page by page.
- Tap Browse → select a Juz or Surah to read a specific section.
- Share any URL like
quran.shakeeb.in/surah/2/ayah/255to jump directly to Ayat ul Kursi.
Navigating Pages
- Swipe left/right to turn pages (Arabic RTL: swipe right = next page).
- Use the ◀ ▶ arrows in the bottom toolbar.
- Type a page number in the page input field.
- Use the ⋮ menu in the bottom right for "First page" / "Last page".
Font Size
- Tap − / + buttons in the bottom toolbar or in the settings sidebar.
- The current size is shown as a number badge.
Immersive Mode
- Tap the ↕ expand icon in the top toolbar to hide all toolbars.
- Tap anywhere on the text to toggle toolbars back.
Settings (⚙ Sidebar)
Tap the settings icon in the top toolbar to open the sidebar:
- Quick Toggles: Immersive, Translate, Inline, Tajweed.
- Tajweed: Toggle tajweed color highlighting. See the color legend below. Tap the 🎨 icon to customize colors for each rule.
- Font Size: Adjust text size.
- Tatweel: Toggle Arabic text stretching (kashida justification).
- Word-by-Word: Show English meaning under each Arabic word.
- Inline Translation: Show English or Urdu translation below each line.
- Themes: Choose from 10 beautiful reading themes.
- Custom Background: Enter any CSS color, gradient, or image URL.
- Custom Text Color: Change text color to any value.
- Qari: Choose a reciter for audio playback.
Scan View
Toggle between Unicode text and scanned page images. Pinch-to-zoom on scanned images.
Long-Press Options
Long-press (hold) on any line to see options:
- Play Audio: Listen to this ayah.
- Ayah Details: Open translation/tafseer modal.
- Bookmark: Save this line with a note.
- Select Text: Enable native text selection to copy multiple lines.
Bookmarks
- Tap the 🔖 bookmark icon in the top toolbar to view all bookmarks.
- Your current page is automatically bookmarked.
- Organize bookmarks in folders.
Search
- Tap the 🔍 search icon to search for any Arabic text across all pages.
Tafseer / Translation Modal
When you tap an ayah in the reader (or use the long-press menu):
- A bottom-sheet modal opens with the Arabic text at the top.
- Word by Word: Tap to expand — see each word's meaning and transliteration. Tap any word to hear its pronunciation.
- Translations: Multiple English and Urdu translations shown in colored blocks. Tap to expand/collapse each.
- Reorder Translations: Tap the ⚙ icon in the footer to enter config mode. Use ↑/↓ arrows to reorder, 👁 to show/hide.
- Tafsir: Tap buttons to load Ibn Kathir (Arabic/Urdu) or Ma'arif ul Quran (English).
- Navigate: Use ◀ ▶ to go to previous/next ayah, or swipe left/right.
- External Link: Tap 🌐 to open on tafsir.app for full commentary.
- Close: Tap ✕ or press the back button.
Discover (Ayah Reels)
- From the home screen, tap Discover.
- Beautiful full-screen cards appear with a random ayah.
- Swipe up to see the next ayah, swipe down for the previous.
- Each card shows the Arabic text, Urdu translation, and English translation.
- Share (↗): Copy the ayah with translations to clipboard.
- Read (📖): Jump to this ayah in the Quran reader.
- Settings (🌐): Choose your preferred English and Urdu translators.
- Press ✕ to go back to the home screen.
Memorize (Hifz Tracker)
- From the home screen, tap Memorize.
- Choose tracking mode: Juz (30 items) or Surah (114 items).
- Tap any juz/surah to update your memorization progress.
- Complete items trigger a confetti celebration! 🎉
- Due for Review shows items that need revision based on spaced repetition intervals.
- Weekly Heatmap shows your review activity this week.
- Mastery levels: Items progress from New → Learning → Reviewing → Mastered.
- Stay consistent — the app tracks your streak and shows motivational quotes.
Recommended Chapters
Quick-start your memorization with commonly memorized surahs: Al-Fatiha, Ya-Sin, Ar-Rahman, Al-Waqiah, Al-Mulk, Al-Kahf.
Listen (Audio Player)
- From the home screen, tap Listen.
- Browse or search for a surah.
- Tap a surah name to start playing.
- Choose your preferred Qari from the dropdown at the top.
- Audio controls (play/pause/seek) appear below the surah list.
- Audio playback continues even when browsing other parts of the app.
Scanned Mushaf
- From the home screen, tap Scanned.
- Choose a scanned source from the dropdown:
- 15-Line Saudi Mushaf
- 16-Line Darussalam
- 13-Line Taj Company
- 16, 17, 18, or 21-Line Taj Company
- Navigate pages with ◀ ▶ buttons or page number input.
- Pinch-to-zoom for closer inspection.
- For the 15-line Saudi source, use Juz and Surah jump controls at the top.
Tips & Shortcuts
| Action | How |
|---|---|
| Quick resume | Tap "Full Quran" — it remembers your last page. |
| Share a page | Copy the URL from the browser address bar (e.g., /surah/36). |
| Offline reading | The app works offline after the first load. |
| PWA shortcuts | Long-press the app icon on your home screen for quick actions. |
| Keyboard nav | In Discover, use ↑↓ arrow keys to navigate cards. |
Frequently Asked Questions
Q: Does the app work offline?
A: Yes! After the first load, all core reading features work offline. Audio and some translations may need internet.
Q: How do I change the text source (15-line vs 16-line)?
A: On the home screen, use the mushaf source selector. Or in the reader, open settings and change the source.
Q: Why does some text look different?
A: Different text sources use different fonts. Archive sources use Muhammadi font, Quran.com sources use IndoPak Waqf Lazim font.
Q: How do I report a bug or suggest a feature?
A: Tap "Feedback" in the footer of the home page to reach us on Telegram.
Q: Is the app free?
A: Yes, completely free and open-source.
Contact & Support
- Website: https://quran.shakeeb.in
- Developer: Shakeeb Ahmad
- Feedback: Telegram
- Source Code: GitHub
May Allah accept this effort and make it beneficial for the Ummah. Ameen.