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 rich reward system with unlockable companions and themes, and comprehensive progress visualization. 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
30+
Components
8,000+
Lines of Code
15+
Features
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. Implemented comprehensive bilingual support (Arabic RTL/English LTR) using next-intl with proper text direction handling. Integrated multiple Islamic APIs: Aladhan for prayer times and Hijri calendar conversion (with Egypt timezone adjustment), Alquran Cloud for daily Ayah, and HadithAPI for daily Hadith—all with intelligent caching and fallback strategies. Created a gamified reward system with unlockable companions, themes, decorations, and achievements that respond to user progress. Implemented client-side AES-GCM encryption for localStorage data privacy, custom hooks for state management, and a comprehensive logging utility for production error handling. Applied performance optimizations: Next.js 16 Cache Components with custom cache profiles, lazy loading, skeleton screens, and strategic API timeouts. Designed an accessible UI with WCAG 2.1 AA compliance, proper semantic HTML, and keyboard navigation support.

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. Successfully implemented 30+ reusable components following feature-based architecture, comprehensive habit tracking with streak calculations, calendar visualization, and progress analytics. Created a production-ready logging system that eliminated all console errors in production while maintaining full debugging capabilities in development. Demonstrated mastery of modern React patterns, 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 and real-world API integrations.

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
LocalStorage Encryption