A cross-platform desktop application built with React and Electron that provides easy access to commonly used Arabic Islamic texts such as Subḥānahu wa Taʾālá and Sallá Allāhu ʿAlayhī wa as-Salam.
- 16 Islamic Arabic phrases with English transliterations and meanings
- One-click copying to clipboard
- Hover tooltips showing meanings
- Cross-platform support (macOS, Windows, Linux)
- Update checking functionality
- Modern UI with dark theme
- Documentation access
The application maintains the same visual design as the original Python version with a dark theme (#1b1c27) and grid layout of Arabic phrase buttons.
The latest release can be downloaded from the official website or from the GitHub releases page.
- Node.js 18+ and npm
- Git
# Clone the repository
git clone https://github.com/itextc/itc-osx.git
cd itc-osx
# Install dependencies
npm install
# Run in development mode
npm run dev# Build for production
npm run build
# Package for distribution
npm run dist
# Platform-specific builds
npm run dist-mac # macOS DMG
npm run dist-win # Windows installer
npm run dist-linux # Linux AppImage- Frontend: React 19.1.1
- Desktop Framework: Electron 38.1.0
- Build System: Webpack 5
- Package Manager: npm
- Build Tool: electron-builder
This project has been migrated from Python/macOS to React/Electron for improved cross-platform support and better developer experience. See MIGRATION.md for detailed migration documentation.
The original Python implementation files are still present for reference:
itc.py- Original tkinter implementationctk_itc.py- CustomTkinter implementationsetup.py- py2app build configurationrequirements.txt- Python dependencies
Contributions are welcome! This includes:
- Bug fixes
- Adding more Islamic texts
- UI/UX improvements
- Cross-platform testing
- Documentation improvements
- Maintain the existing visual design and user experience
- Ensure cross-platform compatibility
- Follow React best practices
- Test thoroughly on all supported platforms
The migration resolves several build issues from the Python version:
- ✅ Python dependency conflicts (pyinstaller version issues)
- ✅ macOS-only build limitations
- ✅ Complex py2app configuration
- ✅ Platform-specific environment issues
This project is licensed under the GPL-3.0 License - see the LICENSE file for details.
- Nāsir Ātif - Original concept and development
- Abdur-Rahman Bilal - Development and contributions
بارك الله فيك (May Allāh bless you) to all contributors and users of this application.
For technical support or feature requests, please open an issue on GitHub.