Under the Hood of Dhikrly
A transparent technical guide to every open-source library, astronomical solar engine, audio DSP pipeline, and external API powering Dhikrly.
Zero Tracking
No analytics cookies · No ad SDKs
Zero Third-Party Trackers. 100% Offline Capable. Client-Side Cryptography.
Unlike commercial apps that sell your location data or inject telemetry trackers, Dhikrly contains zero Facebook Pixels, zero Google Analytics tags, and zero third-party advertising scripts. Prayer calculations, missed prayer tracking, and dhikr counts happen entirely on your local device.
System Architecture Layers
Next.js 16 + React 19 App Router with Turbopack, Tailwind CSS design system, and Service Worker offline caching.
Web Audio API multi-bus DSP mixer with gain nodes, lossless Haramayn ambient soundscapes, and W3C MediaSession controls.
Quran.com API v4, EveryAyah CDN, Adhan.js astronomical math, OpenStreetMap Nominatim & Overpass QL spatial queries.
Supabase PostgreSQL with Row Level Security (RLS), Web Push VAPID alerts, and planned dedicated Go/Rust microservices.
Detailed Technologies & APIs Directory
Filter by category to inspect exact versions, roles, and technical specifications.
Next.js 16 (App Router)
High-performance React application framework with Turbopack, static site generation (SSG) across all 32+ routes, streaming SSR, and edge route handlers.
React 19
Latest React engine featuring concurrent rendering, modern hooks, transition handling, and client/server component boundaries.
TypeScript 5
100% strict type safety across all spiritual data models, prayer calculations, storage abstractions, and external API responses.
Tailwind CSS & Design Tokens
Custom bespoke design system using HSL color tokens, dark/light mode CSS custom properties, backdrop blur glassmorphism, and responsive breakpoints.
Progressive Web App (PWA)
Native-like installable app with custom service worker, cache-first strategy for static assets, network-first for pages, and standalone display mode.
Web Audio API
Multi-channel Web Audio DSP mixer providing independent gain nodes, zero-latency loop points, and binaural focus mixing for Haramayn ambient soundscapes.
Quran.com API v4
Official REST endpoints providing authentic Uthmani scripture, Saheeh International translations, verse metadata, and isolated word-by-word pronunciations.
EveryAyah Audio CDN
High-bandwidth distributed audio CDN serving verse-by-verse recitations by Sheikh Mishary Rashid Alafasy, Sheikh Mahmoud Khalil Al-Husary, and Sheikh Abdul Basit.
Adhan.js (Astronomical Math)
Astronomical solar positioning library calculating Fajr, Sunrise, Dhuhr, Asr, Maghrib, and Isha using trigonometric solar declination and equation of time.
OpenStreetMap Nominatim
Open-source, privacy-preserving geocoding engine that translates latitude and longitude into city and country names without tracking users or requiring Google API keys.
OpenStreetMap Overpass API
Spatial Overpass QL querying that dynamically discovers mosques and places of worship within a 15km radius of the user anywhere in the world.
Open Food Facts & EFSA
Barcode lookup database combined with a localized European Food Safety Authority (EFSA) E-number catalog classifying over 350 food additives as Halal, Haram, or Mushbooh.
Web Push Protocol (RFC 8292)
Standardized VAPID push protocol delivering morning and evening adhkār notifications, Friday Al-Kahf reminders, and Adhan alerts even when the browser is closed.
Supabase Cloud Infrastructure
Managed PostgreSQL with Row Level Security (RLS), GoTrue identity authentication, and Realtime WebSocket replication for multi-device data synchronization.
MediaSession API (W3C)
Native operating system media controls on iOS, Android, and macOS allowing play, pause, seek, and artwork display on lock screens and watch complications.
Planned: Dedicated Go / Rust Backend
High-throughput dedicated microservice backend powering native iOS, Android, and macOS apps with gRPC, HTTP/3, and sub-millisecond prayer caches.
Planned: Whisper v3 Speech Cluster
GPU speech recognition worker nodes running ONNX-optimized Whisper models for real-time Arabic recitation evaluation with zero voice recording storage.
Planned: Zero-Knowledge Encryption
Client-side AES-256-GCM encryption with PBKDF2 key derivation. Your personal spiritual logs, duas, and notes are encrypted before leaving your device.
Planned Dedicated Backend Architecture (Go / Rust)
Technical specification for scaling Dhikrly across native mobile apps and heavy AI inference.
1. High-Performance API Gateway
Written in Go or Rust with gRPC and HTTP/3. Eliminates cold-start serverless overhead, manages connection pools, and routes requests to specialized workers.
2. Whisper AI GPU Speech Cluster
Dedicated inference pods running ONNX-optimized Whisper v3 models. Audio streams are analyzed in real-time for Quran memorization (Hifdh) and destroyed immediately without storage.
3. Realtime WebSockets & Presence
Lightweight WebSocket cluster for Family & Halāqah Khatmah circles, allowing real-time shared reading progress and communal Ramadan milestones.
Have an API suggestion or security feedback?
We welcome contributions and corrections from the community.