تطبيق ويب تقدمي (PWA) لقراءة الأذكار اليومية مخرج من كتب السنة النبوية المطهرة.
عرض التطبيق المباشر • المميزات • التثبيت • المساهمة
حِصن هو تطبيق ويب إسلامي مجاني ومفتوح المصدر، يهدف إلى تسهيل قراءة الأذكار اليومية (أذكار الصباح، المساء، النوم، الاستيقاظ، وأذكار متفرقة) بطريقة عصرية، مريحة للعين، وخالية من المشتتات. تم بناء التطبيق بالكامل باستخدام تقنيات الويب الأساسية (HTML, CSS, JavaScript) بدون الاعتماد على أطر عمل معقدة، مما يجعله سريعاً جداً وخفيفاً على الأجهزة.
- 📱 تطبيق ويب تقدمي (PWA): إمكانية تثبيت التطبيق على الهواتف الذكية والحواسيب ليعمل كتطبيق أصلي (Native App).
- 📴 دعم العمل بدون إنترنت (Offline Mode): بفضل الـ Service Worker، يمكنك قراءة الأذكار في أي وقت وأي مكان حتى بدون اتصال بشبكة الإنترنت.
- 🌙 الوضع الليلي (Dark Mode): واجهة مريحة للعين تدعم الوضع المظلم وتتجاوب تلقائياً مع إعدادات نظام التشغيل الخاص بك.
- 🔍 بحث فوري وسريع: محرك بحث مدمج للوصول السريع للأذكار المطلوبة.
- 📿 تكرار تفاعلي: عداد تفاعلي مدمج مع كل ذكر يقل تدريجياً عند النقر عليه، مع استجابة مرئية.
- 📋 ميزة النسخ: إمكانية نسخ أي ذكر بسهولة ومشاركته مع الآخرين.
- ♿ سهولة الوصول (Accessibility): مراعاة معايير سهولة الوصول لدعم جميع فئات المستخدمين.
- ⚡ أداء فائق: مبني بـ Vanilla JS و CSS النقي لضمان سرعة التحميل والأداء السلس.
تم بناء المشروع بالاعتماد على تقنيات الويب الأساسية للحفاظ على بساطته وسرعته:
- HTML5: لبناء هيكل الصفحات بشكل دلالي (Semantic).
- CSS3: لتصميم واجهة المستخدم، مع استخدام المتغيرات (CSS Variables) لدعم الثيمات المختلفة بشكل ديناميكي.
- JavaScript (ES6+): لإضافة التفاعلية، إدارة حالة التطبيق، والتعامل مع البيانات بدون أطر عمل.
- Service Workers & Web App Manifest: لتحويل الموقع إلى تطبيق ويب تقدمي (PWA).
التطبيق عبارة عن ملفات ثابتة (Static Files)، لذا لا يحتاج إلى بيئة تشغيل معقدة (Node.js أو قواعد بيانات).
للاستمتاع بجميع ميزات التطبيق (مثل الـ PWA)، يفضل تشغيله عبر خادم محلي (Local Server):
-
نسخ المستودع:
git clone https://github.com/Kingaoi/Hisn.git cd Hisn -
تشغيل خادم محلي: يمكنك استخدام أي خادم ثابت، مثل:
# باستخدام Python python3 -m http.server 5500 # أو باستخدام Node.js (عبر npx) npx serve .
-
معاينة التطبيق: افتح المتصفح وانتقل إلى
http://localhost:5500
المشروع جاهز للنشر المباشر على منصات الاستضافة المجانية مثل Vercel، Netlify، أو GitHub Pages.
النشر السريع على Vercel:
إذا كان لديك Vercel CLI مثبتاً:
npx vercel --prodيحتوي المشروع على ملف vercel.json لضبط إعدادات الكاش (Cache) تلقائياً لضمان تحديث التطبيق لدى المستخدمين بسلاسة.
Hisn/
├── public/ # الملفات العامة (أيقونات، PWA assets)
│ ├── icon.svg
│ ├── mosque-icon-navbar-detailed-1024.png
│ ├── manifest.json
│ ├── robots.txt
│ ├── sitemap.xml
│ └── sw.js # Service Worker للعمل بدون إنترنت
├── css/ # ملفات التصميم (مقسمة لسهولة الصيانة)
│ ├── tokens.css # متغيرات الألوان والخطوط (Design Tokens)
│ ├── layout.css # تخطيط الصفحة
│ ├── components.css # مكونات الواجهة (الأزرار، البطاقات)
│ ├── animations.css # الحركات والتأثيرات
│ └── ...
├── js/ # ملفات الجافاسكريبت (مقسمة منطقياً)
│ ├── data.js # بيانات الأذكار
│ ├── renderer.js # دوال عرض وبناء واجهة المستخدم
│ ├── main.js # نقطة الدخول الأساسية (Entry Point)
│ └── ...
├── index.html # الصفحة الرئيسية والوحيدة للتطبيق
├── vercel.json # إعدادات النشر لـ Vercel
├── LICENSE # رخصة المشروع (MIT)
├── CONTRIBUTING.md # دليل المساهمة
├── CODE_OF_CONDUCT.md # مدونة قواعد السلوك
└── README.md # هذا الملف!
نحن نؤمن بقوة المجتمع ونرحب بأي مساهمة لتحسين تطبيق "حِصن" ونشر الخير. إذا كنت ترغب في المساهمة، سواء بكتابة كود، تحسين التصميم، أو حتى الإبلاغ عن مشكلة:
- يرجى قراءة دليل المساهمة (CONTRIBUTING.md).
- نرجو الالتزام بـ مدونة قواعد السلوك (CODE_OF_CONDUCT.md) الخاصة بنا.
هذا المشروع مفتوح المصدر بالكامل ومتاح تحت رخصة MIT. لك الحرية في استخدامه، تعديله، وتوزيعه للأغراض الشخصية أو التجارية، ونسأل الله أن يجعله صدقة جارية وينفع به الجميع.
تم صُنع هذا العمل ابتغاء مرضاة الله، لا تنسونا من صالح دعائكم.