📖 Al Hadith (আল হাদিস) Desktop

Al Hadith is a fast, lightweight, offline-first cross-platform desktop application built to bring authentic Hadith collections and prophetic traditions (Sunnah) directly to your desktop.

---

🚀 Release Notes (v2.1.0)

🌟 Major Migration: Electron to Tauri v2

• Rust Backend Integration: Replaced Node.js/Electron backend with a high-performance Tauri v2 Rust backend.
• Embedded SQLite Engine: Native rusqlite static integration for reading hadiths.db with sub-millisecond query performance.
• Frameless Window: Custom frameless titlebar with window controls (Minimize, Maximize / Restore, Close) connected to native Rust window APIs.

🔍 Enhanced Search Capabilities

• Enter Key Binding: Press Enter on the keyboard in the search input to execute searches instantly.
• Multi-Keyword Search: Multi-word queries (e.g. সালাত সময়) perform intelligent AND matching across Hadiths.
• Multi-Field Search: Searches across Bangla text, Arabic text, Narrator (রাবী), Commentary Note, and Hadith Primary Numbers.
• Number & Bangla Digit Search: Input Hadith numbers in Bangla (১২৩) or English (123) to jump directly to specific Hadiths.
• SQL Safety: Single quote escaping (') to prevent SQL syntax errors.
• Book Filter: Filter search results by specific Hadith books (Sahih Bukhari, Sahih Muslim, Sunan An-Nasa'i, etc.).
• Multi-Word Text Highlighting: Matched search terms are highlighted with distinct badges in search results.

⚙️ Font & Reader Customization Settings

• Show / Hide Arabic: Toggle Arabic text visibility for a simplified reading view.
• Arabic Font Size Control: Dynamic range slider and +/- buttons (16px – 44px) to adjust Arabic font size.
• Bangla Font Size Control: Dynamic range slider and +/- buttons (12px – 32px) to adjust Bangla font size.
• Persistent Preferences: Settings persist automatically across app restarts via localStorage.

---

✨ Features

• 📚 Comprehensive Hadith Collections: Includes major authentic books categorized by chapters, sections, and thematic subcategories.
• ⚡ Offline First: Fully functional without an internet connection using local SQLite storage.
• 🎨 Modern Theme Support: Toggle between Dark and Light modes for comfortable day or night reading.
• 🎯 Authenticity Badges: Displays validity status (Sahih, Hasan, Da'if, etc.) for every Hadith.
• 🖥️ Minimalist UI: Clean, responsive layout with custom fonts (Kalpurush, Kitab, AnekBangla).

---

🛠️ Tech Stack

• Core Desktop Framework: Tauri v2 (Rust)
• Database: SQLite3 (rusqlite crate with bundled feature)
• Frontend Framework: React 19 + Vite 7
• Styling: Tailwind CSS v4
• State Management: Zustand
• Icons: React Icons (react-icons/vsc, react-icons/fa6)

---

📦 Building & Running Locally

Prerequisites

• Node.js (nodejs.org) (v18+)
• Rust & Cargo

Installation

1. Clone the repository: bash git clone https://git.code.sf.net/p/al-hadith/code al-hadith cd al-hadith

2. Install frontend dependencies: bash npm install

3. Run in Development Mode: bash npm run tauri dev

4. Build Production Installers: bash npm run tauri build Built packages (MSI, NSIS Setup .exe, .AppImage, .dmg) will be placed in src-tauri/target/release/bundle/.

---

📜 Acknowledgments & License

• Hadith database resources compiled from public Islamic publication references (IRD Foundation).
• Released under the open-source MIT License.