Islamic Homepage

Islamic Homepage — A Serene New Tab Experience
Version 1.03 | Chrome Extension | MIT License

Transform every new tab into a peaceful spiritual sanctuary. Islamic Homepage helps modern Muslims stay mindful of daily prayers and their Islamic routine amidst a busy professional life—all with beauty, simplicity, and focus.

✨ Overview

Islamic Homepage replaces Chrome's default new tab page with a calming, feature-rich Islamic experience. Built for productivity-minded Muslims who value both aesthetics and functionality, it provides accurate prayer times, daily Quran inspiration, and cinematic visuals—all without tracking, ads, or distractions.

Single Purpose: A dedicated Islamic new tab experience with prayer times, Quran verses, and spiritual ambiance.

---

🌟 Key Features

🕐 Accurate Prayer Times
- Real-time prayer schedules based on your exact GPS location
- Live countdown to next Salah with elegant progress indicators
- 15+ calculation methods** including:
- Muslim World League (MWL)
- Islamic Society of North America (ISNA)
- Umm Al-Qura University (Makkah)
- Diyanet (Turkey)
- Egyptian General Authority of Survey
- Kuwait, Qatar, Gulf Region, and more
- Juristic school support: Shafi (standard) & Hanafi for Asr calculations
- High-latitude adjustment methods (Middle of Night, One Seventh, Angle-Based)
- Smart region detection: Auto-selects appropriate calculation method based on your country
- Forbidden time indicators: Sunrise, Zawal, and Ghurub periods marked clearly

📖 Daily Quran Inspiration
- "Ayah of the Day" with authentic Arabic text
- Clear Sahih International English translation**
- RTL Arabic typography for proper rendering
- Direct links to Quran.com for deeper study
- Navigate through previous verses (stores last 100)
- No personal data sent—just verse numbers to the API

🌌 Peace Visuals
- Real-time sky gradients that shift with the time of day
- Procedural night mode with layered stars (small, medium, large)
- Subtle shooting star animations
- GPU-optimized for minimal CPU impact
- Smooth transitions between dawn, day, dusk, and night
- Works on both desktop and laptop screens

📍 Smart Location
- One-time geolocation request (optional)
- Manual city search powered by OpenStreetMap Nominatim
- Reverse geocoding via BigDataCloud for readable city/country names
- Auto-detects region-specific prayer calculation methods
- Falls back to Mecca, Saudi Arabia if location denied

⚙️ Fully Customizable
- Clock format: 12-hour or 24-hour display
- Live settings preview: See changes instantly
- Calculation method override** (auto or manual)
- Juristic school selection**
- Latitude adjustment method**
- Midnight mode** (Standard or Jafari)
- Reset to defaults** with one click

🔒 Privacy-First Design

We do not:
- ❌ Track your browsing activity
- ❌ Collect analytics or telemetry
- ❌ Sell or share your personal data
- ❌ Serve ads or affiliate links without disclosure
- ❌ Require account creation

We do:
- ✅ Store all preferences locally in your browser (`localStorage`)
- ✅ Use location **only** for prayer time calculations (never stored on our servers)
- ✅ Fetch prayer times & Quran via third-party APIs (see below)
- ✅ Provide a transparent, in-extension privacy policy
- ✅ Comply fully with Chrome Web Store policies

Third-Party Services (all HTTPS):
| Service | Purpose | Data Sent |
|---------|---------|-----------|
| Aladhan API | Prayer times & Hijri date | Coordinates, calculation params |
| Alquran Cloud | Quran text & translation | Ayah number only |
| BigDataCloud | Reverse geocoding | Coordinates → city/country |
| OpenStreetMap | Manual location search | Search query |
| SupportKori | Optional support widget | **None unless you click** |

SupportKori Disclosure:The "Buy Me a Coffee" widget is **completely optional**. Its iframe loads **only when you explicitly click the button**—no background preloads, no periodic popups. Your support is appreciated but never forced.

Full details in the in-extension **Privacy Policy** modal (accessible via the info icon).

---

📋 What's New in Version 1.03

🛡️ Compliance & Policy Updates
- **Fixed SupportKori widget loading behavior:** Now loads **only on explicit user click** to comply with Chrome Web Store Affiliate Ads policy (previously auto-loaded after 30–60 seconds)
- **Removed periodic auto-show:** The widget no longer appears automatically every 20 minutes
- **Enhanced privacy policy:** Added mandatory "Limited Use" statement and detailed per-API data transmission disclosures
- **Code cleanup:** Removed dead code; improved maintainability

🔧 Technical Improvements
- Migrated to cleaner, more modular UI initialization in `InfoUI`
- Streamlined SupportKori widget script for better performance
- Updated external documentation with full permission justifications
- No breaking changes to user-facing functionality

**Previous Versions:**
- **1.02** – Initial public release with prayer times, Quran verses, dynamic backgrounds
- **1.01** – Bug fixes: Location caching, prayer time calculation edge cases
- **1.0** – Beta launch

---

## 🎯 Use Cases

| User | Benefit |
|------|---------|
| **Students** | Quick prayer time checks between classes without distracting apps |
| **Professionals** | Subtle desktop notifications for Salah during work hours |
| **Retirees** | Simple, uncluttered interface with large, readable text |
| **Developers** | Clean, open-source code (MIT License) you can inspect or fork |

---

🌐 Supported Regions

Works worldwide with **15+ prayer calculation methods** covering:
- North America (ISNA, MWL)
- Middle East (Umm Al-Qura, Diyanet, Kuwait, Qatar, Gulf)
- Europe (MWL, France, Russia)
- South Asia (Karachi, Bangladesh)
- Southeast Asia (JAKIM, MUIS, Kemenag)
- Africa (Egypt)
- And others

**Hijri date** conversion included for all regions.

🛠️ Technical Details

- Manifest Version: 3 (MV3)
- Permissions: `geolocation`, `storage`
- Host Permissions: 5 HTTPS endpoints for APIs
- No background page: Uses service worker only for notifications (disabled by default)
- No external dependencies: All fonts, icons, and styles included locally
- Size:~2.5 MB unpacked (mostly fonts and images)
- Open Source: MIT License – code available on GitHub (see Support & Feedback)

📞 Support & Feedback

We're a small independent team building tools for the Muslim community. Your feedback directly shapes our roadmap.

- Website: https://core10.site
- GitHub Issues:https://github.com/coretenofficial-debug/islamic-homepage-issues/issues
- Facebook: https://www.facebook.com/people/Core10/61588830811804/
- LinkedIn: https://www.linkedin.com/company/core10x10/
- Email: coreten.official@gmail.com

Note: We do not collect usage statistics. If you encounter a bug, please describe the steps to reproduce it and your location/device details.

---

📜 License

Licensed under the **MIT License** – free to use, modify, and distribute. See LICENSE file in repository.

🙏 Acknowledgments

- Prayer times powered by **Aladhan API**
- Quran text from **Alquran Cloud** (Sahih International translation)
- Location services by **BigDataCloud** and **OpenStreetMap Nominatim**
- Iconography: **Material Symbols Outlined** (Google)
- Fonts: **Plus Jakarta Sans** (NASA Type), **Amiri** for Arabic

⚖️ Chrome Web Store Policy Compliance

This extension adheres to all Chrome Web Store Developer Program Policies:

- ✅ Single, narrow purpose
- ✅ Minimal permissions (geolocation, storage only)
- ✅ No spyware, malware, or obfuscated code
- ✅ Transparent data handling (privacy policy built-in)
- ✅ No deceptive installation tactics
- ✅ No affiliate/ad injection without user action (SupportKori fixed in v1.03)
- ✅ No prohibited content (religious content is allowed)

Built with ❤️ for the Ummah. May Allah accept our efforts.

Islamic Homepage v1.03 – May 13, 2026