📖 Overview
Deewan E Chishthiya is a comprehensive Islamic spiritual application designed for followers of the Chishti order. The app provides religious content including Silsila (spiritual chain), Adhkar (remembrances), PDF libraries, event management, and multi-language support.
It features a dual-app architecture (Super Admin App and User App) sharing the same Firebase backend, with Green and Purple theme options.
🎨 Theme System
| Feature | Details |
|---|---|
| Themes | Green (#1B5E20) and Purple (#3D2A5B) |
| Storage | SharedPreferences key app_theme |
| Accent | Gold (#D4AF37) for borders and highlights |
| Dashboard Background | Theme-specific images (dashgreen.png / dashimage.png) |
👥 User Roles
Access Silsila, Adhkar, PDF Library, Events, and all spiritual content
Manage Duas, Events, Messages, Images, Links, and all content
Create App Admin accounts, system configuration, full access
🕌 Adhkar System
User Features
- Categories shown as folders with count
- Arabic badge + Language count on cards
- Adjustable font size (slider panel)
- Multi-language title support
Admin Features
- Dedicated Arabic text field (RTL, Amiri font, 22px)
- Multi-language translations entry
- Category/Folder management
- Add/Edit modes with data preservation
📱 User Dashboard
| Component | Description |
|---|---|
| Top Bar | Settings + Notification icons in themed circles with golden border |
| Title | "Deewan E Chishthiya" in Amiri calligraphy with gold gradient shader |
| Top Stacked Cards | 5 full-width cards (Silsila, Wazaif, Ratheeb, Al Yaqooth, Jammiyathu Sufiyyeen) with golden borders |
| Middle Grid | 3-column scrollable grid with 15 items |
| Bottom Fixed Bar | 4 cards (Quran, Counter, Events, Message) with unread badge |
| Periodic checking | Every 10 seconds for new messages |
| Announcement popup | Via AnnouncementService |
📍 Majlis Locations System
User Features
- Beautiful animated cards with mosque icons
- Address fetched via translations
- "Get Directions" button opens Google Maps
- Share feature: copy details + native share sheet
Admin Features
- StreamBuilder showing all active locations
- Edit/Delete with soft delete (sets isActive: false)
- Multi-language entry with click-to-edit chips
- Google Maps URL validation
🔔 Notifications System
| Feature | Details |
|---|---|
| Channels | message_channel (high priority) + announcement_channel |
| Custom sound | notificationtune.mp3 |
| Priority | High importance with vibration patterns |
| iOS support | DarwinNotificationDetails |
| Push notifications | Triggers for new messages, tracks last notified message ID |
| Unread management | Read/unread status tracking |
🔐 Admin Authentication
| Feature | Details |
|---|---|
| Session management | SharedPreferences with 24-hour timeout |
| Permission system | Role-based (super_admin / app_admin) |
| Login | Email/Password with Firebase Auth |
| Super Admin | Creates App Admin accounts (email, password, name, phone, address, company) |
| App Admin | Manages all content (Duas, Events, Messages, etc.) |
👨💼 Admin Panel Screens
🌐 Multi-Language System
| Feature | Details |
|---|---|
| Storage | SharedPreferences |
| Static text | TranslationService.get(key) |
| Dynamic content | TranslationService.currentLanguage |
📱 App Screenshots
A glimpse into the Deewan E Chishthiya experience with Green and Purple themes.
All screenshots from the Deewan E Chishthiya App.
🛠️ Technology Stack
| Component | Technology |
|---|---|
| Frontend Framework | Flutter (Dart) |
| Backend & Database | Firebase Firestore (NoSQL) |
| Authentication | Firebase Authentication |
| File Storage | Firebase Storage |
| Push Notifications | Firebase Cloud Messaging (FCM) |
| PDF Viewing | flutter_pdfview |
| Image Caching | CachedNetworkImage |
| State Management | Provider |
| Local Storage | SharedPreferences |
📦 Key Features Implementation
StreamBuilder for live updates
// Multi-language
6 languages with fallback logic
// PDF caching
Permanent cache via getApplicationDocumentsDirectory()
// Permission system
Role-based (super_admin / app_admin)
🚀 Unique Selling Points
Dual-App Architecture
Separate Super Admin App and User App sharing the same Firebase backend
Dual Theme System
Green and Purple themes with gold accents, user-selectable
Complete Silsila
44-name spiritual chain with biographies and multi-language support
6-Language Support
English, Malayalam, Tamil, Kannada, Arabic, Urdu with fallback logic
Advanced Notifications
Two channels with custom sound, high priority, and unread tracking
Rich Content Management
15+ admin screens for complete content control
🔥 Key Features
🚀 Future Enhancements
📝 Conclusion
Deewan E Chishthiya is a comprehensive Islamic spiritual application that successfully combines traditional Chishti content with modern technology. With its dual-theme system, dual-app architecture, and 6-language support, it provides an exceptional platform for followers of the Chishti order.
✅ Dual-App Architecture • ✅ 6 Languages • ✅ Green + Purple Themes
✅ Complete Silsila (44 Names) • ✅ Adhkar System • ✅ PDF Library
✅ Majlis Locations • ✅ Advanced Notifications • ✅ Admin Panel
"A spiritual companion for the Chishti tradition."