Hey developers! I just shipped version 2.5.0 of Hadisku, a free and offline hadith application built for Android, Linux, and Windows. This release brings some exciting new features and performance improvements that I'm excited to share with the dev community.
🎯 What is Hadisku?
Hadisku is an open-source Islamic hadith application that provides:
- 📚 14 Imam hadith collections (Bukhari, Muslim, Abu Dawud, Tirmidhi, etc.)
- 🔌 100% offline - all data stored locally
- 📝 Personal notes system for each hadith
- 🆓 Completely free - no ads, no tracking
- 🌐 Cross-platform - Android, Linux, Windows
Live Demo: https://flagodna-developer.github.io/hadisku/
✨ What's New in 2.5.0
🎨 Hadith Card Generator
The biggest feature in this release is the Hadith Card Creator. Users can now generate beautiful, shareable images of hadiths with:
- Gradient backgrounds (WhatsApp-style cards)
- Islamic-themed image backgrounds
- Customizable text layouts
- Export as images for social media
Tech stack for this feature:
- Canvas API for rendering
- Custom gradient algorithms
- Image compression for optimal sharing
🔍 Search Performance Optimization
Completely refactored the search engine:
Before: ~500ms for complex queries
After: ~50ms for complex queries
Improvements:
- Optimized text indexing
- Better hadith number matching
- Reduced memory footprint
- Lazy loading for large datasets
🔗 Deep Linking Fix
Fixed critical issues with deep linking:
- Proper URL parsing and validation
- Better state restoration
- Smoother navigation from external links
- Cross-platform compatibility improvements
💝 Sponsor Portal Plugin
Added a sponsor portal to support ongoing development:
- Simple integration
- Multiple payment options
- Transparent funding goals
🛠️ Technical Highlights
Architecture:
- Cross-platform compatibility using [your framework]
- Local-first database approach
- Efficient data synchronization
- Modular plugin system
Performance Metrics:
- App size: [size]
- Cold start: [time]
- Search latency: <50ms
- Memory usage: [optimized amount]
🎯 Challenges & Solutions
Challenge 1: Search Performance
The original search implementation was slow with large hadith collections.
Solution: Implemented a custom indexing system with debounced queries and result caching.
Challenge 2: Cross-Platform Card Generation
Rendering consistent cards across different platforms was tricky.
Solution: Used platform-agnostic canvas rendering with fallback mechanisms.
Challenge 3: Offline-First Architecture
Keeping the app fully functional without internet.
Solution: Bundled all hadith collections with the app and implemented smart caching strategies.
📦 Installation
# Android
Download from the website
# Linux
wget [download-link]
# or use your package manager
# Windows
Download installer from website
🔮 What's Next?
Planned features for upcoming releases:
- Audio narration of hadiths
- Advanced filtering and categorization
- Hadith chain (isnad) visualization
- Community translation contributions
- Dark mode themes
🤝 Contributing
Hadisku is open-source and welcomes contributors! Whether you're interested in:
- Feature development
- Bug fixes
- UI/UX improvements
- Documentation
- Translations
Check out the project and feel free to open issues or PRs.
📊 Stats
- Downloads: [your stats]
- Active Users: [your stats]
- Supported Languages: [number]
- Hadith Collections: 15 Imams
- Total Hadiths: [number]
💭 Final Thoughts
Building a cross-platform Islamic app has been an incredible learning experience. Balancing modern UX with respect for sacred texts, ensuring accessibility, and maintaining performance across platforms presented unique challenges.
I'd love to hear your feedback, especially from developers who've built similar educational or religious applications!
Try it out: https://flagodna-developer.github.io/hadisku/
Tags: #opensource #crossplatform #islamic #app #showdev
Top comments (0)