Hilal — Ramadan Habit Tracker & Spiritual Companion
Projects
🌙 Frontend Developer

Hilal — Ramadan Habit Tracker & Spiritual Companion

Progressive Web App that gamifies Ramadan habits with streak tracking, prayer times, daily Quran verses, and Hadith. Features bilingual support (Arabic RTL/English LTR), offline functionality, a 56-item reward system with unlockable companions and themes, and an IDE-style interactive Learn Mode that teaches developers the architecture behind every UI element. Achieved 98/100 performance score with Next.js 16 App Router, client-side encryption, and optimized caching strategies.

98
Performance
96
Accessibility
96
Best Practices
92
S E O
100+
Components
35,000+
Lines of Code
20
Custom Hooks
22
Modules
56
Unlockable Rewards
2
Languages
3
A P I Integrations
The Challenge icon

The Challenge

During Ramadan, Muslims worldwide struggle to maintain consistent spiritual habits across 30 days. Existing habit trackers lack cultural context, don't support Arabic RTL properly, miss essential features like prayer times and Islamic content, and fail to provide the motivational feedback needed for a month-long commitment. Users needed a unified platform that combines habit tracking with spiritual resources while respecting Islamic aesthetics and bilingual requirements.

The Solution icon

The Solution

Built a production-ready Next.js 16 PWA with App Router, leveraging TypeScript for type safety and feature-based architecture across 22 modules. Implemented comprehensive bilingual support (Arabic RTL/English LTR) using next-intl with Tailwind logical properties for automatic text direction handling. Integrated three Islamic APIs—Aladhan for prayer times, Alquran Cloud for daily Ayah, and HadithAPI for daily Hadith—all with Next.js 16 Cache Components and fallback strategies. Designed a gamified reward system with 56 unlockable items (companions, themes, decorations, patterns, badges, titles) driven by a debounced reward engine and progressive disclosure (Fog of War) mechanics. Implemented client-side AES-256-GCM encryption for localStorage data privacy, a pub/sub event bus for cross-module communication, and split context patterns to prevent unnecessary re-renders. Built an interactive IDE-style Learn Mode with Ctrl+Click navigation, hover peek cards, architecture diagrams, 46+ design pattern case studies, and guided walkthroughs—turning the app itself into a teaching tool for developers.

The Impact icon

The Impact

Delivered a fully functional PWA achieving 98/100 performance score, 96/100 accessibility, and 92/100 SEO on Google PageSpeed Insights. Shipped 100+ components, 20 custom hooks, and 35,000+ lines of TypeScript across 10 feature domains and 12 infrastructure modules. Created an interactive Learn Mode that documents the entire codebase through annotated UI overlays, Mermaid architecture diagrams, and guided code walkthroughs. Demonstrated mastery of modern React patterns (split contexts, event-driven architecture, headless reward orchestration), PWA capabilities, bilingual internationalization, Islamic API integration, and performance optimization techniques. The project showcases ability to build culturally-sensitive, accessible, and performant web applications with complex state management, real-world API integrations, and developer-facing documentation tooling.

Bilingual Support

Full RTL/LTR support — every component adapts its layout, spacing, and text direction

Ramadan Mubarak
Track your spiritual journey
🌙
Fajr Prayer
Quran Reading
Charity
Dhikr
Fasting
🔥 7-Day Streak
Progress: 78%
LTR →|← RTL

7 Dynamic Themes

Each theme transforms the entire UI — colors, gradients, glass effects, and pattern overlays adapt seamlessly

Companion System

6 unlockable companions with 5 mood states each — hover to see them react to your progress

Baby Crescent — idle
🌙 Baby Crescent
Starter
Little Lantern — idle
🏮 Little Lantern
3-day streak
Star Sprite — idle
Star Sprite
7-day streak
Scholar's Cat — idle
🐱 Scholar's Cat
All habits 3 days
Golden Falcon — idle
🦅 Golden Falcon
14-day streak
Celestial Owl — idle
🦉 Celestial Owl
21-day streak

Reward System

47+ unlockable rewards including progressive lanterns, achievement badges, and collectible decorations

1
Amber Lantern
Amber
Day 1
2
Emerald Lantern
Emerald
3-day streak
3
Sapphire Lantern
Sapphire
7-day streak
4
Ruby Lantern
Ruby
14-day streak
5
Gold Lantern
Gold
21-day streak
6
Rainbow Lantern
Rainbow
28-day streak
7
Platinum Lantern
Platinum
Complete Ramadan

Islamic Patterns

6 culturally-authentic pattern tiles that serve as unlockable decorations and UI accents

Stars
Stars
Classic Islamic star tessellation
Crescents
Crescents
Interlocking crescent motif
Geometric
Geometric
Infinite geometric tiling
Floral
Floral
Arabesque floral pattern
Calligraphy
Calligraphy
Arabic calligraphic art
Muqarnas
Muqarnas
3D honeycomb vaulting

Technologies Used

Next.js 16
TypeScript
React 19
Tailwind CSS
Framer Motion
next-intl
PWA (Service Workers)
Aladhan API
Alquran Cloud API
HadithAPI
Web Crypto API (AES-GCM)
LocalStorage Encryption
Mermaid Diagrams
Lucide React