01 / Context
What this project is solving
Nūr Quran prioritizes the reading experience over network dependency. The web layer is packaged through Capacitor into a native Android project, with the Android module and Gradle wrapper kept in the repository. Search, surah navigation, progress, dark mode, and fast startup are treated as local product fundamentals.
02 / Architecture
How the system is arranged
dist/
Tracked web build assets packaged into the Android application
app/
Native Android application module with Java entry points, resources, manifests, and Capacitor build integration
gradle/
Gradle wrapper and daemon configuration used to build the Android project
Capacitor bridge
capacitor.settings.gradle and capacitor.build.gradle connect the web bundle to Android
.github/workflows/
release-android.yml installs Capacitor, runs Gradle assembleRelease, uploads the APK, and creates a GitHub Release
03 / Shipped
What made it into the build
- Offline Quran reading
- Search by surah and Arabic text
- Surah navigation
- Reading progress
- Dark mode
- Automated Android release workflow