IslamApp est une application web moderne, rapide, et sécurisée conçue pour accompagner au quotidien la communauté musulmane. Construite sur une architecture React / Express et pensée comme une PWA (Progressive Web App), elle offre une expérience native sur mobile et un "Dashboard" élégant sur ordinateur.
- 🕌 Horaires de Prière & Géolocalisation : Calcul dynamique des heures de prière en fonction de votre ville ou de votre position GPS automatique.
- 📖 Le Noble Coran : Lecture des 114 sourates avec textes en arabe authentique (Uthmani) et écoute audio synchronisée.
- 🤲 Adhkar & Invocations : Accès rapide aux invocations du matin et du soir.
- 📿 Tasbih Numérique : Un compteur élégant pour faciliter vos dhikrs.
- ⭐ Les 99 Noms d'Allah : Liste complète avec translittération et sens.
- 📅 Calendrier & Événements : Suivi des grandes dates islamiques (Ramadan, Aïd, Hajj, Achoura) et compte à rebours dynamique basé sur le calendrier hégirien.
- 💬 Chatbot "Imam Virtuel" : Une IA spécialisée répondant à vos questions théologiques avec bienveillance, stricte conformité à la Sunnah, et humilité (Allahu A'lam).
L'interface de l'application a été méticuleusement conçue pour offrir un standard professionnel :
- Responsive Design Avancé : Navigation inférieure (Bottom Nav) sur smartphone pour une ergonomie native, et barre latérale (Sidebar) élégante sur Desktop.
- Thème Sombre Intégral : Contraste maîtrisé (noir, gris, blanc) pour réduire la fatigue oculaire.
- Iconographie Vectorielle : Utilisation exclusive d'icônes SVG nettes (via
lucide-react), aucun emoji texte.
Le backend (Node.js/Express) agit comme une forteresse pour protéger l'application et proxy les requêtes API (OpenRouter, Aladhan, Quran.com) :
- CORS strict : Autorise uniquement le frontend.
- Helmet & HPP : Protection contre les vulnérabilités courantes (XSS, Clickjacking, Parameter Pollution).
- Rate-Limiting (Anti-DDoS) : Blocage automatique des abus via
express-rate-limit(limite à 100 requêtes / 10 minutes par IP).
- Node.js (v18+)
- Cloner ce dépôt.
Créez un fichier .env à la racine de vos dossiers FRONTEND et BACKEND (voir les templates fournis) avec vos clés.
Exemple pour le backend :
PORT=4000
OPENROUTER_API_KEY=votre_cle
PROMPT_SYSTEM="Tu es un savant musulman..."cd BACKEND
npm install
npm run startLe serveur se lancera sur le port 4000.
cd "FRONTEND/islam app"
npm install
npm run devDes scripts de tests d'intégrité sont inclus dans le dossier /scripts/ :
- Test Frontend (
node scripts/test_frontend.js) : Valide les dépendances, exécute les tests unitaires (Vitest) et compile la PWA. - Test Backend (
python3 scripts/test_backend.py) : Bombarde l'API locale pour vérifier que les sécurités (HPP, Rate Limiting) repoussent les attaques.
Cette application utilise vite-plugin-pwa pour générer automatiquement les Service Workers.
Une fois compilée via npm run build, elle peut être installée directement sur l'écran d'accueil d'un iPhone (Safari) ou Android (Chrome) fonctionnant 100% comme une application native.
Conçu avec rigueur pour être utile à la communauté.