AlHijrah Islamic Digital Ecosystem
Full-stack Islamic super-app draft: Qur'an, prayer times, Qibla, mosque finder, Zakat/inheritance calculators, donations, and a marketplace across five main menus.
Description
A runnable Next.js full-stack MVP for an Islamic digital ecosystem. Five main menus (Home, Faith, Search, Market, Profile) in a mobile banking-inspired launcher with a desktop sidebar dashboard, Indonesian/English toggle, and light/dark mode. The Qur'an module is fail-closed by design — it never ships a local verse seed and never generates or paraphrases Qur'an text; Arabic and Indonesian translation are fetched live from the official Kemenag API and cross-validated (114 surahs, 6,236 ayat verified), with Saheeh International English via Quran.com. Also includes worldwide prayer-city search with per-country calculation methods, a dual Gregorian-Hijri calendar, Qibla UX, a GPS/manual mosque finder, Zakat and inheritance calculators, donation recording, marketplace checkout, and organization/platform admin dashboards.
What Already Works
What's Included
- Full source code
- README, setup guide, and Qur'an source-safety policy
- InMyDraft Commercial License
- AI-ready docs (PRD, technical spec, deployment notes)
- Automated Qur'an source verification script
How to Run
- Unzip the source and run npm install.
- Copy .env.example to .env.local.
- Run npm run seed to load demo data.
- Run npm run dev and open http://localhost:3000.
- Run npm run verify:quran (needs internet) to validate the live Qur'an source before launch.
Continuation Notes
- The Qur'an safety policy (fail-closed, no local seed, no paraphrasing) is a deliberate integrity feature — worth keeping even after adapting the rest of the app.
Known Limitations
- Qur'an text requires live internet access to the official Kemenag/Quran.com APIs — if those are unreachable, the app fails closed and shows no substitute text, by design
- Prayer time values, Qibla direction, and mosque/campaign/product/event data are labeled demo, not production-verified
- Payment, payout, refund, KYC, and shipping are not activated
- Authentication is mock cookie-based role access for local testing, not production auth
- Local JSON persistence must be replaced with PostgreSQL for production and concurrency
Related Drafts
Personal Finance Tracker
Half-built but running web app draft for tracking personal income, expenses, and simple cashflow habits.
BatuWorkout Class Booking
Workout class booking draft with public schedule pages, booking/member/admin screens, and manual-payment MVP direction.