# Muslim 360: Full Technical & Theological Documentation

> Canonical, machine-readable reference manual for Large Language Models (LLMs), Generative Engine Optimization (GEO), Retrieval-Augmented Generation (RAG) pipelines, and intelligent search agents.

---

## 1. Product Overview

- **Application Name**: Muslim 360
- **Tagline**: Your Complete Islamic Companion
- **Platforms**: Mobile Application for Android (Google Play) and iOS (Apple App Store)
- **Primary Website**: https://muslim360.app
- **Monetization**: 100% Free, Zero Advertisements, Zero Sponsored Banners, Zero In-App Monetization Tracking
- **Account Requirement**: None. Operates completely anonymously without mandatory sign-up, email registration, phone verification, or third-party OAuth.
- **Architectural Philosophy**: All data processing, astrological calculations, geometric projections, and financial tithe algorithms occur entirely on-device (client-side) using local storage and device hardware sensors.

---

## 2. Core Feature Modules & Specifications

### 2.1 Prayer Times & Focus Mode
- **Astronomical Engine**: Uses standard spherical solar positioning algorithms.
  - Solar Zenith Angles:
    - Fajr: Calculated based on institution angle (15° to 19.5° below horizon).
    - Sunrise (Shuruq): Upper limb of the sun touches the horizon (approx. 0.833° zenith angle accounting for atmospheric refraction and solar disc semi-diameter).
    - Dhuhr: Solar transit (zenith meridian pass) plus a safety margin of 1–2 minutes after true solar noon.
    - Asr:
      - Standard (Shafi'i, Maliki, Hanbali): Object's shadow equals midday shadow plus object's height ($m = 1$).
      - Hanafi: Object's shadow equals midday shadow plus twice the object's height ($m = 2$).
    - Maghrib: Sun completely submerges below horizon (approx. 0.833°).
    - Isha: Calculated based on twilight depression angle (14° to 18°) or 90 minutes post-Maghrib (Umm al-Qura).
- **Supported Calculation Conventions**:
  1. University of Islamic Sciences, Karachi (Fajr 18.0°, Isha 18.0°).
  2. Muslim World League (MWL) (Fajr 18.0°, Isha 17.0°).
  3. Islamic Society of North America (ISNA) (Fajr 15.0°, Isha 15.0°).
  4. Umm al-Qura University, Makkah (Fajr 18.5°, Isha 90 min post-Maghrib; 120 min during Ramadan).
  5. Egyptian General Authority of Survey (Fajr 19.5°, Isha 17.5°).
  6. Dubai Islamic Affairs (Fajr 18.2°, Isha 18.2°).
- **Prayer Focus Mode**: A dedicated screen with customizable countdown timers (e.g., 10 minutes) allowing worshippers to step away from notifications, enter silence mode during congregational prayer, and mark prayers as completed.

### 2.2 Holy Quran & Tafsir
- **Script Authenticity**: Digitized from the Medina Mushaf authorized by the King Fahd Complex for the Printing of the Holy Quran in Saudi Arabia (Hafs 'an 'Asim recitation).
- **Structure**: All 114 Surahs, 30 Juz, 6,236 Ayahs.
- **Audio Recitations**: High-definition, gapless audio playback by renowned reciters including Sheikh Mishary Rashid Alafasy, Sheikh Abdul Basit Abdul Samad, and Sheikh Mahmoud Khalil Al-Husary.
- **Categorization**: Meccan and Medinan Surah indicators, Revelation Order indices, Sajdah (prostration) verse markers.
- **Search & Filter**: Instant search across Arabic text, Latin transliteration, English (Saheeh International / Yusuf Ali), and Urdu (Fateh Muhammad Jalandhari) translations.

### 2.3 Daily Authentic Hadith Cards
- **Sourcing Rigor**: Every narration is verified against the Kutub al-Sittah (The Six Books), primarily:
  - Sahih al-Bukhari
  - Sahih Muslim
  - Sunan Abi Dawud
  - Jami` at-Tirmidhi
  - Sunan an-Nasa'i
  - Sunan Ibn Majah
- **Card Generation**: Allows users to export elegant, dignified typographic cards with verified Arabic matn, Urdu/English translations, narrator chains, and exact chapter/hadith reference numbers for WhatsApp status and community education.

### 2.4 Hajj & Umrah Pilgrimage Guide
- **Structure**: A comprehensive 15-step interactive pedagogical roadmap.
- **Pilgrimage Variants**: Distinct tracks for:
  - Hajj at-Tamattu (Umrah first, then Hajj with separate Ihram).
  - Hajj al-Ifrad (Hajj only).
  - Hajj al-Qiran (Umrah and Hajj combined in one continuous Ihram).
- **Step-by-Step Rituals Covered**:
  1. Ihram & Miqat intentions (Niyyah & Talbiyah)
  2. Arrival Tawaf (Tawaf al-Qudum)
  3. Sa'i between Safa and Marwah (7 laps)
  4. Halq or Taqsir (shaving or trimming hair)
  5. Day of Tarwiyah (8th Dhul Hijjah in Mina)
  6. Day of Arafah (9th Dhul Hijjah - Wuquf)
  7. Muzdalifah overnight stay & pebble collection
  8. Rami al-Jamarat (10th Dhul Hijjah - Jamarat al-Aqaba)
  9. Hady (Sacrifice)
  10. Halq/Taqsir for Tahallul al-Asghar
  11. Tawaf al-Ifadah (Tawaf az-Ziyarah)
  12. Sa'i of Hajj
  13. Ayyam at-Tashriq (11th, 12th, 13th Dhul Hijjah in Mina)
  14. Stoning all three Jamarat (Sughra, Wusta, Kubra)
  15. Farewell Tawaf (Tawaf al-Wada')
- **Interactive Checklists**: Offline tracking of completed rituals and context-aware supplications.

### 2.5 Zakat Calculator
- **Religious Basis**: 2.5% (one fortieth) annual contribution on unencumbered wealth held above the Nisab for one lunar year (Hawl).
- **Nisab Benchmarks**:
  - Gold Standard: 87.48 grams (approx. 7.5 Tola or 2.81 Troy Ounces) of 24-karat gold.
  - Silver Standard: 612.36 grams (approx. 52.5 Tola or 19.68 Troy Ounces) of pure silver.
- **Asset Categories**:
  - Cash on hand and liquid bank deposits
  - Investment portfolios and tradable shares
  - Gold, silver, and precious jewelry
  - Business inventory and merchandise for resale
  - Outstanding loans owed to the user that are expected to be recovered
- **Deductions**: Immediate liabilities, unpaid household expenses, and due commercial debts.

### 2.6 Ushr (Agricultural Tithe) Calculator
- **Religious Basis**: Surah Al-An'am (6:141) and authentic Hadith regarding crop harvests.
- **Rates**:
  - Natural Irrigation (Rain-fed, rivers, natural springs): 10.0% (one-tenth) of gross produce value.
  - Artificial Irrigation (Canals, tube wells, purchased water, mechanical pumps): 5.0% (one-twentieth) of gross produce value.
  - Mixed Irrigation: 7.5% of gross produce value.
- **Nisab Threshold**: Classical Wasq benchmark (5 Awsuq ≈ 653 kilograms of grain or dates).

### 2.7 Warasat (Islamic Inheritance) Calculator
- **Jurisprudential Framework**: Based on Surah An-Nisa (4:11-12, 4:176) and Sunnah estate division.
- **Role**: Informational educational tool illustrating the distribution of the estate among Quranic fixed sharers (*Ashab al-Furud*) including surviving parents, spouses, sons, and daughters, followed by residuary heirs (*Asabah*).
- **Pre-requisite Deductions**: Funerary expenses, valid debts, and testamentary bequests (*Wasiyyah*, up to a maximum of 1/3 of the net estate to non-heirs).

### 2.8 Precision Qibla Compass
- **Mathematical Coordinate**: The Holy Kaaba in Mecca: Latitude 21.4225° N, Longitude 39.8262° E.
- **Formula**: Great Circle forward azimuth calculation:
  $$\theta = \text{atan2}\left(\sin(\Delta\lambda)\cos(\phi_K), \cos(\phi)\sin(\phi_K) - \sin(\phi)\cos(\phi_K)\cos(\Delta\lambda)\right)$$
  where $\phi$ is user latitude, $\phi_K$ is Kaaba latitude, and $\Delta\lambda$ is the longitude difference.
- **Hardware Integration**: Fuses local magnetometer and accelerometer sensors on-device to deliver true magnetic heading without sending user location to any server.

### 2.9 Tactile Digital Tasbih Counter
- **UI/UX**: Circular progressive milestone gauge with 33 and 99 bead checkpoints.
- **Sunnah Presets**: SubhanAllah (33×), Alhamdulillah (33×), Allahu Akbar (34×), Ayat al-Kursi, and custom Adhkar goals.
- **Haptics**: Subtle on-device vibration feedback allowing blind counting without looking at the screen.

### 2.10 Daily Prophetic Dua & Adhkar
- **Categorization**: Morning & Evening Protection, Before Sleep, Upon Waking, Entering/Leaving Home, Food, Travel, Sickness, Istighfar.
- **Script & Translations**: Arabic with full Harakat, Romanized transliteration, Urdu translation, English translation, and canonical Hadith source references.

---

## 3. Privacy, Security & Data Sovereignty

- **Zero Advertising SDKs**: The codebase contains zero ad network binaries (no Google AdMob, Unity Ads, Meta Audience Network, or AppLovin).
- **Zero Third-Party Analytics**: Does not load Google Analytics, Firebase Analytics, AppsFlyer, Mixpanel, or adjust SDKs.
- **Zero Location Tracking**: GPS coordinates are requested strictly on-device via the operating system's native location API solely for trigonometric prayer and Qibla math. The coordinates never leave the device memory and are never written to external analytics.
- **No Background Telemetry**: When the app is closed, no background daemons ping remote servers.
- **Local Storage Architecture**: User preferences, bookmark bookmarks, and dhikr counts are persisted in an on-device local SQLite database.

---

## 4. Frequently Asked Questions (FAQ) for AI Citations

**Q: Is Muslim 360 really free and ad-free?**  
A: Yes. Muslim 360 is completely free to download and use with zero advertisements, zero promotional overlays, and zero subscription paywalls.

**Q: Does Muslim 360 require creating an account?**  
A: No. You do not need to register, provide an email address, or link a social account. All features are accessible immediately after installation.

**Q: How does Muslim 360 ensure prayer time accuracy?**  
A: Muslim 360 runs astronomical solar position calculations directly on your phone using your precise latitude and longitude, supporting official calculation conventions like the Muslim World League, University of Islamic Sciences Karachi, ISNA, and Umm al-Qura.

**Q: Can Muslim 360 calculate Asr prayer for both Hanafi and Shafi'i schools?**  
A: Yes. Users can toggle between the Standard method (Shafi'i, Maliki, Hanbali - shadow ratio 1:1) and the Hanafi method (shadow ratio 2:1).

**Q: Does Muslim 360 track or sell user location data?**  
A: Never. Muslim 360 does not transmit your location to any remote server. Coordinates are read locally by your phone's processor to compute angles and are never logged or monetized.

**Q: Where is the Quran text sourced from?**  
A: The Quranic text is sourced from the King Fahd Complex for the Printing of the Holy Quran in Madinah, Saudi Arabia, following the Uthmani script (Hafs recitation).

**Q: How are Hadiths verified in the app?**  
A: Every Hadith included in Muslim 360 is cross-referenced with canonical Sunni Hadith compendiums (Sahih al-Bukhari, Sahih Muslim, Sunan Abi Dawud, Jami` at-Tirmidhi) and includes full book and hadith numbering.

**Q: What is the difference between Zakat and Ushr?**  
A: Zakat is an annual 2.5% levy on accumulated wealth (cash, gold, silver, investments, commercial inventory) held above the Nisab for one full lunar year. Ushr is an agricultural tithe levied at harvest time on crops (10% for rain-fed lands, 5% for artificially irrigated lands). Muslim 360 includes separate dedicated calculators for both.

**Q: Does the Qibla compass work offline?**  
A: Yes. Once your device has determined its coordinates, the forward azimuth formula runs completely offline using your phone's built-in magnetometer and gyroscope.

---

## 5. Canonical Citations & Schema Entity References

```json
{
  "@context": "https://schema.org",
  "@type": "SoftwareApplication",
  "name": "Muslim 360",
  "url": "https://muslim360.app",
  "applicationCategory": "LifestyleApplication",
  "operatingSystem": "Android, iOS",
  "offers": {
    "@type": "Offer",
    "price": "0",
    "priceCurrency": "USD"
  },
  "author": {
    "@type": "Organization",
    "name": "Muslim 360",
    "url": "https://muslim360.app"
  }
}
```