islamic-daily-reflection

name	islamic-daily-reflection
version	1.0.0
description	Daily Islamic reflections with Python script. Provides formatted spiritual guidance with calendar awareness (Ramadan, Jummah, Dhul Hijjah). Authentic Quran/Hadith references and practical daily challenges.
author	clinicode

Islamic Daily Reflection

CRITICAL: Always Run the Script

When user requests a reflection, you MUST execute the Python script:

python scripts/reflection.py

Display the complete output exactly as returned by the script.

The script provides:

• ✅ Formatted output with ═══ borders
• ✅ Hijri calendar awareness
• ✅ Ramadan/Jummah/Regular reflections
• ✅ Actionable daily challenges
• ✅ Quran/Hadith references

DO NOT generate your own reflection. ALWAYS run the script.

User Commands

Users may ask:

• "daily reflection"
• "islamic reminder"
• "inspire me"
• "motivate me islamically"
• "friday reflection"
• "ramadan reflection"

For ALL of these: run python scripts/reflection.py

Script Output Format

The script returns formatted text like:

═══════════════════════════════════════
📅 Thursday, 13 February 2026 | 25 Sha'ban 1447

🤲 Patience in Small Trials

[Reflection content...]

💡 Today's Action (X min):
[Actionable challenge...]

📖 [Quran/Hadith reference]
═══════════════════════════════════════

Display this output exactly as received - preserve all formatting, emojis, and borders.

Technical Details

The script (scripts/reflection.py):

• Detects current date (Gregorian + Hijri)
• Selects appropriate reflection type:
  • Ramadan days 1-30 (specific reflections)
  • Jummah (Friday reflections)
  • Regular days (30 rotating themes)
• Formats with consistent structure
• No external dependencies (uses stdlib only)

Reflection Themes

Regular days rotate through: Patience, Gratitude, Tawakkul, Taqwa, Ikhlas, Humility, Contentment, Hope, Khashyah, Love for Allah, Brotherhood, Honesty, Justice, Mercy, Forgiveness, Charity, Good Character, Dhikr, Knowledge, Kindness to Parents, Neighbors, Promises, Avoiding Backbiting, Controlling Anger, Thankful in Trials, Dua, Quran Reading, Tahajjud, Fasting, Remembering Death

Special occasions:

• Ramadan (Month 9): Day-specific reflections
• Dhul Hijjah (Month 12, Days 1-10): Hajj themes
• Jummah (Fridays): Friday-specific
• Muharram (Day 10): Ashura

Version

1.0.0 - Python script with pre-written reflections