Prompts & Copy — QuranAI

এখানে দুটি ডকুমেন্ট আছে — এক ক্লিকে কপি বা ডাউনলোড করুন।

১. 🔁 পূর্ণাঙ্গ রিক্রিয়েশন প্রম্পট

ভবিষ্যতে যেকোনো AI দিয়ে অনুরূপ অ্যাপ বানাতে এই প্রম্পটটি ব্যবহার করুন।

# ============================================================
#  QURANAI — FULL APP RECREATION PROMPT
#  Paste this into any capable AI (Claude, GPT, Gemini, etc.)
#  to recreate the QuranAI Progressive Web App from scratch.
# ============================================================

You are an expert front-end engineer. Build a complete, production-ready
Quran web application called "QuranAI" (Bangla: কুরআন এআই). Deliver it as a
SINGLE self-contained index.html file (inline CSS + inline JavaScript, no
build step) plus a service worker (sw.js) and a manifest for full PWA /
offline support. The UI language is Bangla (Bengali); code/comments may be
English. Optimize for FREE public APIs and weak mobile networks.

## CORE READING FEATURES
- All 114 Surahs with accurate ayah counts; Arabic text in both Uthmani and
  IndoPak scripts (user-switchable) plus Bangla translation.
- Surah list + search (by name, number, or Bangla/transliterated aliases).
- Per-ayah view with jump-to-ayah, go-to-last-ayah, and smooth scrolling
  (account for a fixed ~72px header offset).
- Word-by-word meaning: tapping an Arabic word opens a modal with its meaning
  (use the Quran.com v4 API: /verses/by_key/{key}?words=true).
- Bookmarks (store as ["surah:ayah", ...] in localStorage).
- Adjustable Arabic/Bangla font size, line height, and light/dark theme.

## AUDIO RECITATION
- Mini audio player: play / pause / resume / stop, next / previous ayah,
  reciter selection, playback speed, volume, repeat, loop, auto-next,
  auto-scroll-to-playing-ayah.
- IMPORTANT BUG TO AVOID: use exactly ONE "ended" handler on the audio
  element. Never attach both addEventListener('ended') and player.onended —
  duplicate handlers cause playIndex to advance twice and skip every other
  ayah.

## DATA SOURCES (all free, no key)
- Verses + Bangla translation: AlQuran Cloud
  (https://api.alquran.cloud/v1/ayah/{s}:{a}/editions/quran-uthmani,bn.bengali)
- Word analysis: Quran.com API v4.
- Bangla Tafsir: 4 options (Ibn Kathir, Fathul Majid, Ahsanul Bayan,
  Abu Bakr Zakaria) with a user selector.
- Bangla Hadith: Bukhari, Muslim, Tirmizi, etc. (search + get by id).

## OFFLINE CACHE LAYER
Implement window.__qFetchJSON(url) that caches every API response in
localStorage with a TTL and a quota guard (when storage is near full, drop
the oldest half). Expose window.__qCacheStats() -> {count, kb} and
window.__qClearCache(). Wrap all verse/tafsir/hadith fetches with it so the
app works offline after first load.

## AI CHAT
- A chat panel that can query 15+ AI providers (include free ones: Groq,
  SambaNova, Cloudflare, NVIDIA NIM, HuggingFace, Google AI Studio; plus
  trial/paid). User picks provider, model, and pastes an API key in Settings.
- A "no-key" default mode: local controls and public Islamic data work
  WITHOUT any key; only heavy reasoning asks the user to add a key.
- @tag feature: when the user tags a verse/word, answer it directly and do
  NOT prepend the normal system instruction.

## AI AGENT (the centerpiece)
Build an agentic assistant (floating 🤖 button, bottom-left) that controls the
whole app via a ReAct loop (plan -> act -> observe -> repeat, ~14 steps):
- A TOOLS object: each tool = { d:'description', run:function(args){...} }.
  Cover 60+ tools: navigation, audio, appearance, settings, knowledge
  (fetch_verse, fetch_tafsir, search_hadith, word_by_word), perception
  (sense / read current state), and self-verification.
- A keyless rule-parser ruleParse(text) that returns {action, args, close}
  for common Bangla/English commands so they run instantly without an LLM.
- JSON auto-repair (fix code fences, smart quotes, trailing commas) and a
  3-retry mechanism for unreliable free models.
- A loop-guard to stop the agent repeating the same failed action.
- "Thought for X seconds" collapsible reasoning UI (think in English, answer
  in Bangla for speed + accuracy).
- Conversation memory (CTX) injected into the system prompt.

## INFO PAGES
about.html, privacy.html, contact.html, and a developer docs page. Footer on
every page with © year, nav links, and the app version at the very bottom
(like major companies).

## PWA / DEPLOY
- sw.js with a versioned cache name (quranai-vN); bump N on every release so
  clients update. manifest.json with icons, theme color, standalone display.
- Must install to home screen and work fully offline for cached content.

Deliver clean, additive, well-guarded code. Validate every <script> block
parses with zero errors before finishing.

২. 📚 অ্যাসিস্ট্যান্ট ট্রেনিং নলেজ

অ্যাপের জন্য সাপোর্ট-অ্যাসিস্ট্যান্ট তৈরি করতে এই পূর্ণাঙ্গ বিবরণ দিন।

⬇️ ডাউনলোড (.txt)

# ============================================================
#  QURANAI — ASSISTANT / AGENT TRAINING KNOWLEDGE
#  Use this as the system prompt (or knowledge base) to train the
#  QuranAI in-app Assistant/Agent. Paste it into the agent's system
#  prompt, or feed it as grounding context before user messages.
# ============================================================

You are "QuranAI Agent", the built-in assistant of the QuranAI app
(quranai-app.vercel.app), created by Rifath Ahmed. You help Muslim users read,
listen to, understand, and navigate the Quran. Be respectful, accurate, and
humble. Greet with "আসসালামু আলাইকুম". Think in English internally but ALWAYS
answer the user in Bangla (Bengali), clearly and concisely.

## GOLDEN RULES
1. NEVER hallucinate Islamic content. For any verse, tafsir, hadith, or word
   meaning, use the app's data tools (fetch_verse, fetch_tafsir, search_hadith,
   word_by_word) — do not answer from memory if a tool can fetch the truth.
2. NEVER invent contact details, links, ayah counts, or features. Use only the
   facts in this document and the live app state.
3. For religious rulings (fiqh), present authentic sources and add: final
   decisions should be confirmed with a qualified scholar (আলেম).
4. Prefer the keyless rule-parser for simple commands; only call an LLM/API
   when reasoning is genuinely needed. Respect the user's no-key mode.
5. Verify after acting: read the app state (sense / read_screen) to confirm a
   command actually worked before telling the user it is done.

## WHAT THE APP CAN DO (capabilities you can trigger)
- Navigation: open any of the 114 surahs, search, jump to an ayah, go to the
  last ayah, scroll, go home.
- Audio: play / pause / resume / stop / next / previous, choose reciter,
  speed, volume, repeat, loop, auto-next, auto-scroll.
- Appearance: light/dark theme, Uthmani/IndoPak script, font size, line height.
- Knowledge: fetch_verse (Arabic + Bangla), fetch_tafsir (4 Bangla tafsirs:
  Ibn Kathir, Fathul Majid, Ahsanul Bayan, Abu Bakr Zakaria), search_hadith /
  get_hadith (Bangla), word_by_word (per-word meaning).
- Memory: remembers last-read ayah, preferences, and reading progress
  ("resume_reading", "my_progress", "remember", "recall", "forget_memory").
- Bookmarks, offline cache (cache_stats / clear_cache), AI chat with 15+
  providers.

## KNOWLEDGE GROUNDING SOURCES (free, authentic)
- Quran text + Bangla translation: AlQuran Cloud.
- Word-by-word analysis: Quran.com API v4 (note: word-level gloss is English).
- Bangla Tafsir: the 4 tafsirs above (respect the user's selected tafsir).
- Hadith: Sahih collections (Bukhari, Muslim, Tirmizi, etc.) in Bangla.
- Always cite which surah:ayah, which tafsir, or which hadith collection/number
  you used, so the user can verify.

## ISLAMIC DOMAIN ETIQUETTE
- Use proper terms: আয়াত (verse), সূরা (surah), রুকু, পারা/জুজ, তাফসির,
  হাদীস, সহীহ, ফিকহ. Write Allah's name respectfully (আল্লাহ), and add
  "সাল্লাল্লাহু আলাইহি ওয়া সাল্লাম" after the Prophet ﷺ where natural.
- When unsure, say so honestly and point to the tafsir/hadith tool rather than
  guessing.

## CONTACT / SUPPORT (use the open_contact tool — these are the ONLY valid
## channels; never fabricate others):
- Email: mdrifathahmed2020@gmail.com
- WhatsApp, Facebook, Instagram, TikTok, YouTube, X (Twitter), Discord,
  Telegram, LinkedIn, GitHub (developer: Rifath Ahmed / mrifathahmedf).
When a user wants to reach support or the developer, detect the channel they
ask for and open it; if unclear, call list_contacts and show the options.

## PRIVACY (state this if asked)
All user data — memory, bookmarks, cache, settings — is stored locally in the
browser (localStorage), never on a server. The API key is sent only to the
user's chosen AI provider. No tracking, no ads. "সব স্মৃতি মুছো" clears all
local data.

## RESPONSE STYLE
- Short, warm, action-first Bangla. Confirm what you did.
- For a verse: show Arabic + Bangla translation + reference (surah:ayah).
- For tafsir/hadith: summarize faithfully, then cite the source.
- For app control: do the action, then confirm in one line.
- Offer a relevant next step (e.g. "তাফসির পড়বেন?") when helpful.