Al Aalim (العالم) Premium Islamic Companion & AI Spiritual Guide

Al Aalim is a modern Android application that blends spiritual utility with a state-of-the-art Glassmorphic UI. It offers a premium experience for essential Islamic tools and advanced AI interactions.

✨ Key Features

• 🕋 Precision Qibla Finder: Advanced sensor-based compass integration for accurate, real-time Kaaba direction.
• 📖 Holy Quran: A premium reading experience with clear typography, translations, and intuitive navigation.
• 🤖 Al Aalim AI Chat: A powerful multimodal AI assistant capable of answering complex religious questions and analyzing images.
• 🛍️ Al Aalim Store (Upcoming): A curated marketplace for premium Islamic products, digital assets, and spiritual tools.
• 🎨 Glassmorphism Design: A sophisticated, translucent UI system with gold accents and fluid animations.

🛠️ Detailed Tech Stack

UI & UX

• Jetpack Compose: 100% declarative UI built with the latest Compose versions.
• Material Design 3 (M3): Leveraging modern components and advanced color theming.
• Custom Glassmorphism Engine: A bespoke UI layer using Brush gradients, Blur modifiers, and custom GraphicsLayer transformations for a premium look.
• Adaptive Layouts: Fully optimized for Phone, Tablet, and Foldables using Window Size Classes.

Architecture & Logic

• Kotlin 2.1+: Leveraging the K2 compiler for high-performance builds.
• MVVM Architecture: Strict separation of concerns (ViewModel, Repository, UseCase).
• Hilt (Dependency Injection): Industry-standard DI for modularity and testability.
• Kotlin Coroutines & Flow: Reactive programming for smooth data handling and UI updates.

Data & Intelligence

• Google Gemini SDK: Powering the multimodal AI chat capabilities (supports Text + Image processing).
• Room Database: Local persistence for Quran bookmarks, chat history, and user preferences.
• Retrofit 2 & OkHttp 4: Type-safe networking for external API integrations and future store modules.
• DataStore: Asynchronous key-value storage for application settings.

System Integrations

• Sensor API: Low-latency sensor fusion for the digital compass (Accelerometer + Magnetometer).
• Modern Permissions: A centralized system for managing hardware access with glass-styled rationale dialogs.

🚀 Getting Started

1. Clone: git clone https://github.com/username/Al-Aalim.git
2. Open: Launch Android Studio (Ladybug or newer).
3. Sync & Run: Build the project and deploy to any device running Android 7.0 (API 24) or higher.

---

Salam! If you find this project helpful, please consider giving it a ⭐ on GitHub!