A comprehensive web application for studying the Quran with advanced features including multi-translation comparison, AI-powered semantic search, manuscript analysis, and more.

Visit: https://quranonlystudies.app

• Multi-Translation Comparison: Compare verses across multiple authorized translations
• AI-Powered Semantic Search: Search by meaning and context, not just keywords
• Voice Search: Speak your queries for instant results
• Manuscript Analysis: Explore mathematical patterns and verse statistics
• Root Word Analysis: Study Arabic root words and their occurrences
• AI Debater Bot: Engage with an AI assistant trained on Submission principles
• Dark Mode: Eye-friendly interface for extended study sessions

• Node.js (v14 or higher)
• npm or yarn
• Git

1. Clone the repository:

git clone https://github.com/safmy/QuranCompare.git
cd QuranCompare

2. Install dependencies:

npm install

3. Create a .env file with required environment variables:

REACT_APP_SUPABASE_URL=your_supabase_url
REACT_APP_SUPABASE_ANON_KEY=your_supabase_anon_key
REACT_APP_API_URL=your_api_url

4. Start the development server:

npm start

The app will open at http://localhost:3000.

1. Install Capacitor dependencies:

npm run ios:setup

2. Build and sync with iOS:

npm run ios:build

3. Open in Xcode:

npm run ios:open

• npm start - Run development server
• npm run build - Build for production
• npm test - Run test suite
• npm run ios:setup - Setup iOS dependencies
• npm run ios:build - Build and sync iOS app
• npm run ios:open - Open project in Xcode

QuranCompare/
├── src/
│   ├── components/     # React components
│   ├── contexts/       # Context providers
│   ├── data/          # Static data files
│   ├── utils/         # Utility functions
│   └── config/        # Configuration files
├── public/            # Public assets
├── api/              # Backend API (separate deployment)
└── ios/              # iOS app files

The backend API is deployed separately on Render. See /api/README.md for API documentation.

Contributions are welcome! Please feel free to submit a Pull Request.

This project is licensed under the MIT License.

• Built for the Submission community
• Based on the authorized translation by Rashad Khalifa
• Mathematical analysis inspired by Code 19 discoveries

For support, please visit https://quranonlystudies.app or contact the development team.# Bot restart trigger: Tue 24 Jun 2025 20:05:57 BST