🕌 CodeTune - Islamic Coding Companion

Transform your VS Code into a spiritual environment.
Authentic Islamic reminders, Quran recitation, prayer times, and spiritual focus tools — all without leaving your editor.

🚀 Installation • ✨ Features • 📖 Usage • ⚙️ Configuration • 🐛 Troubleshooting

📖 Overview

CodeTune integrates spirituality seamlessly into your development workflow. It helps you maintain faith and focus by providing context-aware Islamic content, prayer times based on your location, and a high-quality Quran player — all without leaving your editor.

"Indeed, in the remembrance of Allah do hearts find rest." (Surah Ar-Ra'd, 13:28)

🏆 What's New in v1.3.0 "Tawasul"

🌐 Full 5-Language Internationalization (MAJOR)

• 100% Translation Coverage: Complete localization across English, Arabic (العربية), Spanish (Español), French (Français), and Russian (Русский)
• Live Runtime Switching: Instant UI updates when changing language with zero window reload
• Bi-directional Layouts: Polished RTL (Right-to-Left) for Arabic and LTR for European languages
• Zero Hardcoded Strings: Every button, modal, label, and notification is fully localized

🕌 Ayah Al-Kursi After-Prayer Reminders (NEW)

• Post-Prayer Admonition: Automatic notification 15–40 minutes after each prayer and immediate prompt upon marking prayer completed:

  «Whoever recites Ayah Al-Kursi after each obligatory prayer, nothing prevents him from entering Paradise except death.»

• Modal Recitation View: Full Arabic text in authentic Uthmani script with Harakat plus full English translation in a dedicated dialog
• Extended Daily Azkar: Added Ayah Al-Kursi and Sayyid Al-Istighfar to Morning & Evening Azkar

⚙️ Glassmorphic Settings & Persistent Preferences

• Modern Settings Card: Sleek design matching the rest of the spiritual dashboard
• Rock-Solid Persistence: Settings sync seamlessly between VS Code configuration, globalState, and localStorage
• Zero Console Errors: All configuration keys officially registered in schema

🎨 Contrast Theme Engine

• Light & Dark Themes: Native contrast modes with real-time reactive CSS variables

⚡ IPC Performance & Bug Fixes

• Heartbeat Optimization: Eliminated 1-second IPC polling spam; replaced with a 30s heartbeat & client UI ticker
• Surah Al-Fatihah Fix: Corrected selection validation in player that was blocking playback of Surah 1
• Component Global Scope: Reliable event handling and communication across all UI components

📊 Previous: v1.2.0 "Fajr"

🕌 Islamic Date Tracking System

• Fajr-Based Day Tracking: Daily goals now reset at Fajr (dawn) instead of midnight
• Timezone-Safe Date Arithmetic: Noon-anchored date calculations prevent DST errors
• Smart Streak Calculation: Streak survives until next Fajr, not midnight
• Fajr Time Sync: Prayer times flow from API to SpiritualTracker automatically

🎵 Audio → Tracker Sync Fix

• Accumulator Pattern: Short listening sessions (45s) no longer lost — milliseconds accumulate until a full minute
• Webview-to-Extension Bridge: localStorage data now properly crosses to SpiritualTracker
• Real-Time Dashboard Update: Quran listening minutes show in progress bar immediately

🐛 14 Bug Fixes

• Config registration, 403 Forbidden, message handlers, duplicate buttons, dhikr counter sync, modal transparency, and more

🧠 Smart Focus Mode

• Coding-Aware Notifications: Detects when you're actively typing and pauses reminders automatically
• Auto-Resume: Notifications resume after you stop coding — never breaking your flow again
• Quiet Hours: Configurable night hours where all notifications are fully silenced

📊 Spiritual Progress Dashboard

• Daily Goals Tracker: Visual progress bars for Quran listening minutes and Dhikr count
• Streak System: Tracks consecutive days of spiritual activity with motivational messages
• Achievements: Unlock badges like "One Week Warrior" (7-day streak) and "Legend" (30-day streak)
• Weekly Summary: Overview of your spiritual activity over the last 7 days
• All-Time Stats: Total Quran minutes, Dhikr count, and personal records

🛡️ Intelligent Error Recovery

• "You're Offline" Screen: Beautiful network status UI with pending retry queue
• Auto-Retry: Automatically re-attempts failed audio streaming when connection returns
• User-Friendly Errors: No scary stack traces — just clear, helpful messages
• Exponential Backoff: Smart retry logic that doesn't hammer the server

🔒 Reliability & Security Improvements

• XSS Protection: All dynamic content is fully sanitized before rendering
• Memory Leak Prevention: All intervals, timers, and event listeners are properly disposed
• Error Black Box: Background error logging for debugging without UI clutter
• Retry Manager: Robust network request handling with configurable max retries

✨ Features

🧠 Smart Focus Mode

• Detects active coding (typing, file saves) and pauses non-urgent reminders
• Quiet Hours setting prevents notifications during sleep/prayer times
• Zero configuration — works intelligently out of the box

📊 Spiritual Progress Tracker

• Daily Goals: Log Quran listening time and Dhikr count with simple modal inputs
• Streak Counter: Days-in-a-row tracker with midnight-safe date logic
• Achievements: Gamified spiritual milestones to keep you motivated
• Weekly Heatmap: See which days you were most spiritually active

🤖 Intelligent Reminders System

• Time-Aware Azkar: Morning Azkar (Fajr → Sunrise), Evening Azkar (Asr → Maghrib)
• Friday Special: Enhanced Friday content — Jumu'ah duas, Surah Al-Kahf enforcement, Salawat
• Customizable: Intervals from 5 minutes to 4 hours
• Authentic Content: 500+ verified Adia, Hadis, and Quranic wisdom

🕌 Prayer Times & Calendar

• Live Countdown: Real-time countdown to next prayer with precise astronomical calculation
• Hijri Date: Umm al-Qura calendar with accurate date display
• Auto-Location: Automatic timezone detection — no manual setup needed

🎵 Premium Quran Player

• 15+ Reciters: Mishary Alafasy, Al-Sudais, Abdul Basit, Al-Minshawy, Maher Al-Muaiqly, and more
• Smart Auto-Reading: Auto-page turner with adaptive speed for Khatmah
• Background Play: Independent volume and seamless CDN streaming
• Statistics: Daily/Weekly/Monthly listening metrics

🧿 Islamic Dhikr Counters

• Tasbih (سُبْحَانَ اللَّهِ / الْحَمْدُ لِلَّهِ / اللَّهُ أَكْبَرُ)
• Istighfar, Salawat with Friday-aware daily targets
• Adhkar collection with one-click increment
• Persistent cross-session storage

🚀 Installation

1. Open VS Code
2. Press Ctrl+Shift+X to open Extensions
3. Search for "CodeTune"
4. Click Install
5. Click the 🕌 Mosque icon in the Activity Bar to open the dashboard

📖 Usage

Activity Bar Dashboard

Click the Mosque Icon (🕌) in the left Activity Bar to access everything.

Logging Spiritual Activity

In the Spiritual Progress section:

• Click 📖 Log Quran Time → enter minutes → dashboard updates automatically
• Click ✨ Track Dhikr → enter count → streak and goals update

Smart Focus Mode

Just code normally — the extension watches your activity. When you stop typing for 30+ seconds, any pending notifications are delivered. You'll never see a popup mid-keystroke.

⚙️ Configuration

All settings are available in the UI panel. No JSON editing required.

📿 Reminders

📊 Tracker

🎵 Audio

🔧 Technical Details

• Prayer Calculation: Adhan library with Egyptian calculation method
• Audio: High-quality MP3 streaming from Islamic Network CDN
• Privacy: No data collected. All stats stored locally on your machine
• Architecture: Clean Extension Host / Webview separation with secure postMessage bridge
• Error Handling: Background ErrorReporter with exponential backoff RetryManager

🐛 Troubleshooting

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes
4. Open a Pull Request

Please ensure all Islamic content additions are verified against authentic sources (Quran, Bukhari, Muslim, etc.)

❤️ License & Attribution

• License: MIT
• Audio: Islamic Network CDN
• Prayer Times: Adhan.js
• Fonts: Google Fonts — Amiri Quran, Scheherazade New, Noto Naskh Arabic