Skip to main content
Find answers to the most commonly asked questions about Open Mushaf Native.

​
General Questions

Open Mushaf Native is a modern, cross-platform Quran Mushaf application built with React Native and Expo. It provides an offline-first reading experience with features like gesture navigation, Tafseer popups, and advanced search capabilities.The app is available on:
  • Android (Google Play Store)
  • iOS
  • Web (PWA)
  • macOS
  • Windows
Yes, Open Mushaf Native is completely free and open-source under the MIT License. There are no ads, subscriptions, or in-app purchases.
Yes! Open Mushaf Native is designed for offline use. All Quran pages, Tafseer content, and search functionality work without an internet connection after the initial download.
Currently, the app supports:
  • Hafs (رواية حفص عن عاصم)
  • Warsh (رواية ورش عن نافع)
You can switch between narrations in the Settings screen.

​
Features

Open Mushaf Native includes multiple authentic Tafseer sources:
  • Ibn Katheer (تفسير ابن كثير)
  • Al-Wasseet (التفسير الوسيط)
  • Al-Tanweer (التحرير والتنوير)
  • Asbab Al-Nuzool (أسباب النزول للواحدي)
You can switch between Tafseer sources using the tabs in the Tafseer popup.
The app offers multiple search modes:Simple Search
Direct text matching for finding exact phrasesFuzzy Search
Flexible matching that finds results even with minor spelling variationsRoot Search
Search by Arabic root words to find all derivativesLemma Search
Morphological search for finding word formsSearch results are highlighted for easy identification.
The Daily Reading Tracker helps you maintain consistent Quran reading habits:
  • Set daily reading goals (in pages, Hizb, or Juz)
  • Track your progress throughout the day
  • Get notifications when you complete your goal
  • Progress resets automatically each day
Enable tracker notifications in Settings to stay motivated.
The Android widget displays your current reading position on your home screen:
  1. Long-press on your home screen
  2. Select “Widgets”
  3. Find “Open Mushaf Widget”
  4. Drag it to your home screen
  5. The widget syncs automatically with your reading progress
The widget requires Android and updates every hour to reflect your latest position.
Yes! The app automatically saves your last reading position. You can:
  • Resume reading from where you left off
  • View your current position in the Reading Position Banner
  • Navigate directly to bookmarked pages
The Reading Position Banner can be collapsed by tapping on it.
Open Mushaf Native offers multiple navigation methods:Swipe Gestures
Swipe right-to-left or left-to-right to flip pagesTop Menu
Tap the screen to show the top menu, which displays:
  • Current Surah name
  • Current Juz number and progress
  • Page number
Bottom Navigation
Access different sections:
  • Mushaf (reading view)
  • Lists (Surah/Juz index)
  • More (settings and info)
Direct Navigation
Use the Lists tab to jump directly to any Surah or Juz
Yes! The app supports both portrait and landscape orientations. Landscape mode provides a wider reading experience, especially on tablets.
To view Tafseer for any verse:
  1. Tap on the verse you want to read about
  2. The Tafseer popup will appear from the bottom
  3. Drag the handle to resize the popup
  4. Switch between different Tafseer sources using the tabs
  5. Swipe down to close the popup
Enable notifications in Settings to receive alerts when you:
  • Complete a Hizb (حزب) - 1/60th of the Quran
  • Complete a Juz (جزء) - 1/30th of the Quran
This helps you track progress during longer reading sessions.

​
Settings & Customization

Open Mushaf Native automatically follows your system dark mode setting. You can also:
  1. Go to Settings
  2. Adjust the “Dark Mode Brightness” slider (0-100%)
  3. This controls the contrast of Mushaf pages in dark mode
The app includes optimized splash screens for both light and dark modes.
Yes! To enable the page flip sound:
  1. Open Settings
  2. Toggle “صوت قلب الصفحة” (Page Flip Sound)
The sound plays each time you navigate to a new page.
To switch between Hafs and Warsh narrations:
  1. Go to Settings
  2. Under “إختيار الرواية” (Choose Narration)
  3. Select your preferred narration
The Mushaf images will update to reflect the selected narration.
If you need to reset all settings and data:
  1. Go to Settings
  2. Tap “إعادة ضبط التطبيق” (Reset App)
  3. Confirm the action
This will delete all saved data including bookmarks, settings, and reading progress. This action cannot be undone.

​
Technical Questions

Open Mushaf Native runs on:
  • Android 5.0+ (API level 21+)
  • iOS 13.0+
  • Web (modern browsers with PWA support)
  • macOS 10.15+
  • Windows (via web or development build)
The app is built with React Native and Expo for maximum compatibility.
Minimum Requirements:
  • 100 MB free storage space
  • Internet connection for initial download
  • Modern device (manufactured after 2015 recommended)
For Development:
  • Node.js v22+
  • Expo SDK 54+
  • npm or yarn package manager
Yes! The web version is a full PWA, which means:
  • Install it on your device like a native app
  • Works offline after installation
  • Receives updates automatically
  • Optimized loading and caching
To install the PWA, visit the web version and look for the “Install” prompt in your browser.
Open Mushaf Native is built with modern web and mobile technologies:
  • React Native 0.81.5 - Cross-platform framework
  • Expo SDK 54 - Development and build tools
  • TypeScript - Type-safe development
  • Jotai - Lightweight state management
  • React Native MMKV - Fast persistent storage
  • Expo Image - Optimized image loading
  • Fuse.js - Fuzzy search
  • Quran Search Engine - Advanced Quranic search
Yes! Open Mushaf Native is open-source under the MIT License. You can:
  • View the source code on GitHub
  • Contribute to development
  • Report issues and bugs
  • Fork and customize for your needs
See the Contributing Guide for more information.

​
Troubleshooting

Try these steps:
  1. Close other apps running in the background
  2. Restart the app
  3. Clear app cache (Android: Settings > Apps > Open Mushaf > Storage > Clear Cache)
  4. Ensure you have at least 200 MB free storage space
  5. Update to the latest version
If issues persist, see the Troubleshooting guide for more solutions.
We welcome bug reports and feature requests!GitHub Issues (Recommended)
Open an issue on GitHubContact Form
Use the in-app contact form (More > Contact Us)Please include:
  • Device model and OS version
  • App version
  • Steps to reproduce the issue
  • Screenshots if applicable

​
Privacy & Data

Open Mushaf Native respects your privacy:
  • All reading data is stored locally on your device
  • No user data is sent to external servers
  • No analytics or tracking
  • No ads or third-party services
See the full Privacy Policy for details.
Yes! After the initial download:
  • All Quran pages are cached
  • All Tafseer content is available offline
  • Search works offline
  • Settings and bookmarks are stored locally
You only need internet for:
  • Initial app installation
  • App updates
  • Sharing content

Build docs developers (and LLMs) love

Get started for freeTalk to us