pure-adhkar

byJhon Mez

""" Your Role: Senior Android Engineer, Islamic App UX Designer, Kotlin Architect, and Privacy-First Mobile Product Designer specializing in modern native Android applications using Kotlin, Jetpack Compose, Material 3, Clean Architecture, and offline-first Quran applications. Short basic instruction: Build a complete native Android Qur’an application in Kotlin named “نور الذكر” (Noor Al-Dhikr). The app must be fully Arabic-first, elegant, calm, respectful, privacy-focused, scalable, ad-free, and designed for smooth everyday Qur’an reading, listening, tafsir exploration, and adhkar usage. What you should do: Create a production-quality Android application using Kotlin and Jetpack Compose with Clean Architecture + MVVM. Use Quran.com API as the primary trusted source for Qur’an text, translations, recitations, tafsir references, and verse metadata to ensure zero mistakes in Qur’an content. The app must include: 1. Core Qur’an Features * Full Holy Qur’an browsing by: * Surah * Juz * Hizb * Page * Mushaf reading mode with realistic page-style layout * Verse-by-verse reading * Smooth Arabic typography * Verse highlighting during audio playback * Bookmark verses * Continue reading feature * Daily verse reflection widget/card * Favorites system * Search in: * Arabic Qur’an text * Translations * Tafsir * Tajweed-aware text rendering if available * Night mode + sepia mode + paper Mushaf mode 2. Arabic-First UI * Entire app interface in Arabic * RTL support across all screens * Elegant Islamic-inspired typography * Readable spacing and calm visual hierarchy * Material 3 design system * Minimal and respectful animations * Large readable Arabic text sizes * Accessibility-friendly colors and contrast 3. Translations & Tafsir Include support for: * Arabic Tafsir Ibn Kathir * Tafsir Al-Saadi * Tafsir Al-Jalalayn * English Saheeh International * Additional downloadable translations architecture Allow: * Switching translations instantly * Parallel reading mode * Verse tafsir bottom sheet * Translation audio synchronization 4. Audio Recitation Features Include top 10 reciters: * مشاري راشد العفاسي * عبد الباسط عبد الصمد * ماهر المعيقلي * السديس * سعد الغامدي * ياسر الدوسري * فارس عباد * أحمد العجمي * المنشاوي * الحذيفي Audio requirements: * Stream recitations * Optional offline download caching * Background playback * Lock screen controls * Sleep timer * Repeat verse mode * Repeat range mode * Auto-next surah * Translation audio playback * Verse synchronized highlighting Use Media3 / ExoPlayer. 5. Adhkar Section Create a dedicated “الأذكار” section including: * أذكار الصباح * أذكار المساء * أذكار النوم * أذكار الصلاة * أذكار الاستيقاظ * أذكار السفر * تسبيح إلكتروني * Favorites * Daily reminders Features: * Count tracking * Elegant card UI * Soft animations * Offline storage 6. Privacy & Security Requirements The app must: * Have NO ads * Have NO in-app purchases * Require NO camera permission * Require NO microphone permission * Require NO location permission * Require NO contacts permission * Require NO unnecessary storage permission Only use: * INTERNET * FOREGROUND_SERVICE_MEDIA_PLAYBACK if needed. No analytics SDKs. No tracking SDKs. No user data collection. 7. Architecture Requirements Use: * Kotlin * Jetpack Compose * Material 3 * Clean Architecture * MVVM * Repository Pattern * Hilt Dependency Injection * Retrofit + OkHttp * Room Database * Coroutines + Flow * DataStore Preferences * Media3 ExoPlayer Project layers: * presentation * domain * data * core * designsystem Feature modularization: * feature_quran * feature_audio * feature_tafsir * feature_adhkar * feature_bookmarks * feature_settings 8. Quran.com API Integration Use Quran.com API for: * Surahs * Ayahs * Audio URLs * Translations * Tafsir metadata * Word-level data * Verse timing Implement: * API caching * Offline fallback * Retry strategy * Respectful request handling * Error-safe parsing to avoid text corruption 9. Mushaf Experience Provide: * IndoPak font support * Uthmani script support * Multiple Quran fonts * Adjustable font size * Adjustable line spacing * Realistic Mushaf page transitions * Focus mode * Distraction-free reading 10. Home Screen Design an elegant Arabic home screen containing: * Continue reading * Daily verse * Last played recitation * Quick access to adhkar * Recently opened surahs * Prayer-inspired calming visuals * Minimalist Islamic geometric accents 11. Settings Screen Include: * Font selection * Theme selection * Audio quality * Download management * Translation preferences * Tafsir preferences * Reminder settings * Cache cleanup * Accessibility settings 12. Notifications & Reminders Implement: * Daily verse reminder * Morning adhkar reminder * Evening adhkar reminder * Optional reading goals Must be: * Respectful * Non-intrusive * Locally scheduled * No cloud dependency 13. Performance Requirements The app must: * Start fast * Scroll smoothly * Work on low-end Android devices * Cache intelligently * Avoid memory leaks * Use lazy loading * Support offline reading 14. Accessibility Requirements Support: * Dynamic text scaling * TalkBack * High contrast themes * Large tap targets * RTL perfection * Reduced motion mode 15. Deliverables Generate: * Full Android project structure * Package organization * Gradle setup * API layer * Repository examples * Compose UI examples * Navigation graph * Room schemas * Media playback service * State management approach * Design system tokens * Example screens * Testing strategy * CI/CD recommendation * Play Store release checklist * Security checklist * Future scalability roadmap 16. Code Quality Requirements All code must: * Be production-grade * Follow Kotlin best practices * Use meaningful Arabic-friendly naming where suitable * Be modular and maintainable * Include comments for complex logic * Avoid deprecated Android APIs * Follow latest Android official guidance Your Goal: Create a modern, trustworthy, spiritually calming, fully Arabic Qur’an application that feels premium, respectful, simple to use, scalable for future features, and technically excellent while maintaining complete privacy and authentic Qur’an accuracy through Quran.com integration. Result: Provide: 1. Complete technical architecture 2. UI/UX structure 3. Feature roadmap 4. Folder structure 5. API integration details 6. Compose screen examples 7. Database schema examples 8. Media playback implementation approach 9. Arabic typography recommendations 10. Full development plan from MVP to production release 11. Recommended open-source libraries 12. Security and privacy configuration 13. Modern Android best practices based on latest official Android documentation Constraint: * No ads * No tracking * No unnecessary permissions * Arabic-first UX * Respectful Islamic design * Accurate Qur’an text only from trusted sources * Maintain high performance on mid-range Android phones * Fully scalable architecture * Clean and maintainable codebase Context: This app is intended to become a polished native Android Qur’an experience focused on peaceful reading, trusted Qur’an accuracy, accessibility, privacy, and elegant Arabic usability. It should feel spiritually calming, technically modern, and easy for regular Muslims of all ages to use daily. """