- Beautiful Mushaf Interface: Elegant, clean Quran reader
- Tajweed Highlighting: Proper color-coded tajweed rules
- Multiple Translations: Access to various Quran translations
- Tafseer Integration: Detailed tafseer of each verse
- Hifz Tracker: Memorization tracking and progress
- Multiple Collections: Access to major hadith collections
- Grading System: Hadith grading (sahih, hasan, da'if, etc.)
- Isnad Visualization: Beautiful isnad chain display
- Weak Hadith Identification: Flag weak hadiths with explanations
- Topic-Based Search: Find hadiths by specific topics
- Ask Scholar: Ask questions about Islamic knowledge
- Contextual Answers: AI responses based on Quran and Hadith
- Source Citations: All answers reference authentic sources
- Natural Language: Ask questions in English or Arabic
- Bookmarks: Save your favorite verses and hadiths
- Collections: Create custom collections of content
- Reading Goals: Set and track your reading goals
- Search & Analytics: Powerful search and reading analytics
- Profile: Customize your personal Islamic learning profile
- Type-Safe: Full TypeScript implementation
- API-First: RESTful API with OpenAPI documentation
- Modern UI: Beautiful, responsive interface with Tailwind CSS
- Fast & Optimized: Built with Vite and React
| Layer | Technologies |
|---|---|
| Frontend | React, TypeScript, Vite, Tailwind CSS |
| Backend API | Node.js, Express, TypeScript |
| Database | Drizzle ORM, PostgreSQL, SQLite |
| AI Integration | OpenAI API, LangChain |
| Testing | Vitest, Playwright |
| Tools | pnpm, ESLint, Prettier |
| API Docs | OpenAPI, Swagger UI |
- Node.js 18+
- pnpm
- PostgreSQL 15+ (optional, SQLite by default)
# Clone the repository
git clone https://github.com/Hayredin950/Al-Muhandis.git
cd Al-Muhandis
# Install dependencies
pnpm install
# Start the API server
cd artifacts/api-server
pnpm install
pnpm dev
# In another terminal, start the frontend
cd artifacts/al-muhandis
pnpm install
pnpm dev
# Open your browser at http://localhost:5173Create a .env file in the root:
# OpenAI API for AI Scholar
OPENAI_API_KEY=your_openai_api_key
# Database (optional, default is SQLite)
DATABASE_URL=postgresql://user:password@localhost:5432/al_muhandisAl-Muhandis/
├── artifacts/
│ ├── al-muhandis/ # Main React frontend
│ ├── api-server/ # Backend API
│ └── mockup-sandbox/ # Design mockup tools
├── lib/ # Shared libraries
│ ├── api-client-react/ # React API client
│ ├── api-spec/ # OpenAPI specification
│ ├── api-zod/ # Type-safe API schemas
│ ├── db/ # Database schema (Drizzle)
│ └── integrations-openai/ # OpenAI integration
├── scripts/ # Seed and utility scripts
└── ...
- Production-Ready: Scalable architecture
- Clean Code: TypeScript and proper code organization
- Open Source: MIT-licensed
- Beautiful UI: Modern, elegant interface
- Comprehensive Docs: Well-documented for developers
- AI-Powered: Cutting-edge AI integration
- Quran & Hadith: Authentic Islamic knowledge resources
MIT © Hayredin950
- GitHub: Hayredin950
- Profile: hayredin.vercel.app
Made with ❤️ for the Muslim Ummah by Hayredin950