The new Hijri Calendar in Al Islam is a complete Islamic calendar system designed to make Hijri dates, Islamic occasions, fasting days, moon phases, personal events, date conversion, and calendar customization available in one deeply integrated place. It is not a simple month grid that only shows dates. It is built as a full calendar environment where the user can understand the current Islamic date, see what is coming next, browse months and years, inspect individual days, log fasts, create personal Hijri or Gregorian events, convert dates, find Hijri birthdays, and customize how the entire calendar behaves.
The feature is designed with the same philosophy as the rest of Al Islam: it keeps the surface experience clean, visual, and convenient, while still providing advanced controls and detailed information for users who want more precision. A normal user can open the Hijri Calendar and immediately see today’s Hijri date, the current month, the moon phase, and upcoming Islamic occasions. A more advanced user can change the calendar calculation method, adjust sighting offsets, change week layout, control companion dates, enable or disable fasting lenses, export fasting history, or use the date converter for exact Hijri-Gregorian conversion.
The Hijri Calendar is available inside the app as a dedicated Islamic time and calendar feature. It can also be surfaced from the Home section, making the current Hijri date and upcoming Islamic occasions accessible without forcing the user to manually search for them. This makes it useful both as a daily reference and as a deeper planning tool.
Current Hijri Day Overview
When the user opens the Hijri Calendar, the first thing they see is a rich current-day view. This top card presents the current Hijri date in a way that is easy to read and visually meaningful. Instead of only showing a number, the app shows the day, Hijri month, Hijri year, Arabic month name, corresponding Gregorian date, weekday, and contextual labels.
For example, the screen can show Muharram 1448 AH, with the Arabic name of the month underneath and the Gregorian range beside it, such as Jun – Jul 2026. The selected day card can show that the user is on Thursday, 24 Muharram 1448 AH, corresponding to 9 July 2026. The date is shown prominently, while the Hijri month and Arabic name are displayed alongside it so the user can recognize both the numeric date and the Islamic month identity.
The current-day card also includes contextual Islamic information. If the current month is one of the sacred months, the card can show a sacred month label. This gives the calendar religious context instead of treating all months as visually identical. The card can also show the current progress through the month, such as day 24 of 29, using a progress bar and a day counter. This helps the user understand how far the current Hijri month has advanced and how close the next month is.
The card also includes a live moon phase display. The moon phase is shown visually as a moon disc, along with the phase name and illumination percentage. For example, it can show a Waning crescent with 33% lit. This makes the calendar feel connected to the lunar nature of the Hijri system. The user does not only see dates; they also see the actual lunar phase associated with the date.
The same overview area can also show the next important Islamic occasion. For example, it may show that Mawlid an-Nabi ﷺ is coming in 47 days, or that the White Days are coming in a certain number of days. This gives users immediate awareness of upcoming religious dates without needing to manually inspect each month.
Upcoming Occasion Strip
Below the main current-day card, the Hijri Calendar includes an upcoming occasion strip. This strip presents important upcoming days as cards that the user can horizontally browse. The cards can show occasions such as White Days, Mawlid an-Nabi ﷺ, and other Islamic dates, each with its remaining countdown and date.
These cards are designed to be fast to read. They show the occasion name, its Hijri date, its Gregorian date, and how many days remain. For example, a card may show White Days with 13 Safar · 27 Jul 2026, and a countdown such as in 18 days. Another card may show Mawlid an-Nabi ﷺ, its date, and a countdown such as in 47 days.
This makes the calendar much more useful than a static grid. The user does not need to scan multiple months to know what is coming. The app surfaces upcoming occasions directly under the header, keeping the next important dates visible and convenient.
Main Month Calendar Grid
The main calendar grid is the core month view of the Hijri Calendar. It displays the selected Hijri month as a full calendar layout, with weekday headers and date cells. The grid supports normal calendar interaction, but each date cell is enriched with Islamic, Gregorian, fasting, event, and moon-related information.
Each date cell can show the main date number and a smaller companion date. Depending on the user’s settings, the main date can be Hijri-first or Gregorian-first. For example, when the grid follows the Hijri calendar, the main number represents the Hijri day, while the smaller number can show the corresponding Gregorian day. This is important because users often need both systems together. A Hijri date may be religiously meaningful, while the Gregorian date may be needed for daily planning.
The calendar grid also visually distinguishes special days. Fridays can be highlighted so that Jumu’ah is easier to notice across the month. Today can be marked with a distinct outline or breathing highlight. Selected dates can be shown with a clear selection state. Days outside the current month can be dimmed so that previous-month and next-month spillover dates do not visually compete with the active month.
The grid also supports small indicators and dots inside date cells. These dots are used to show different categories of information, such as Islamic occasions, fasting-related days, personal events, moon phases, or logged fasts. Different colors and markers help users understand that a date contains something meaningful without opening it first. A day can contain a sacred or important occasion, a fasting recommendation, a logged fast, a moon phase marker, or a personal event. This turns the calendar grid into an information map rather than a plain date table.
The user can swipe between months naturally. This makes month-to-month browsing fast and convenient. They can move through Muharram, Safar, Rabi’ al-Awwal, Ramadan, Dhul-Hijjah, and other months with normal gesture navigation, while the header, cards, and event indicators update accordingly.
Selected Day Details
When the user selects a date, the calendar can show detailed information about that day. The selected day panel displays the weekday, Hijri date, Gregorian date, moon phase, occasion information, and available actions.
For example, selecting 12 Rabi’ al-Awwal 1448 AH can show the Gregorian date 25 August 2026, a moon phase disc with illumination percentage, a countdown such as in 47 days, the Arabic month name, and the occasion Mawlid an-Nabi ﷺ with a short description. The selected-day panel can explain that the date is traditionally associated with the birth date of the Prophet ﷺ.
The selected-day panel also includes action buttons. A user can add or open an event, log a fast, share the date or occasion, or copy the information. This makes each date practical. The calendar is not only for viewing information; it allows the user to interact with the day and preserve or share it.
The Log fast action is especially important. When the user logs a fast for a date, the calendar can visually mark that date with a checkmark or indicator. This makes fasting history visible directly on the calendar. Users can track which days they fasted, see patterns, and maintain a record of voluntary or obligatory fasts depending on the date.
The selected-day system is also connected with moon information. When the user changes the selected date, the moon phase and illumination can update accordingly. This means the day panel becomes a small lunar and Islamic date dashboard for that specific day.
Year Overview
The Hijri Calendar includes a year overview mode. Instead of only viewing one month at a time, the user can see the full Hijri year as a set of month cards. Each month appears as its own compact visual grid.
For example, the year overview can show 1448 AH with all twelve Hijri months: Muharram, Safar, Rabi’ al-Awwal, Rabi’ al-Thani, Jumada al-Awwal, Jumada al-Thani, Rajab, Sha’ban, Ramadan, Shawwal, Dhul-Qa’dah, and Dhul-Hijjah. Each card can show whether the month has 29 or 30 days, how many events it contains, and a compact dot-map of the month.
This is a powerful planning view. The user can see at a glance which months contain more occasions. Ramadan and Dhul-Hijjah, for example, can visually show more event markers than quieter months. A month card can show event counts such as 29 days · 6 events, 30 days · 3 events, or 30 days · 15 events depending on the month.
The year overview also supports quick navigation. Tapping a month can take the user directly into that month’s calendar. The user can also move between years using navigation controls. This gives the calendar both a close-up daily mode and a broad annual planning mode.
Jump to Month and Year
The Hijri Calendar includes a dedicated Jump to system for fast navigation. This is useful when the user does not want to swipe month by month through many years.
The Jump dialog allows the user to select a Hijri year and month directly. The year can be changed through a swipeable or typeable year selector, and the month can be selected from month chips. For example, the dialog can show Rabi’ al-Awwal 1448 AH · Aug – Sep 2026, with the year selector focused on 1448 and month chips such as Safar, Rabi’ al-Awwal, and Rabi’ al-Thani.
The user can also use a Today button inside the dialog. If they have moved far away from the current date while browsing, the Today action immediately returns them to the current Hijri date. This is a small but very important convenience feature because calendar browsing can easily take users far away from the present month.
The Jump system makes the calendar suitable for both casual daily use and long-range planning. Users can quickly move to Ramadan, Dhul-Hijjah, a future Hijri year, or a specific month without friction.
Events and Occasions
The Hijri Calendar includes a dedicated Events & Occasions section. This section collects Islamic occasions, personal events, fasting logs, reminders, and upcoming dates into one organized place.
At the top, the section can show fasting statistics. For example, it can show how many fasts were logged this month, in the last 30 days, and all time. This gives users an immediate summary of their fasting activity. Depending on the app’s tracking model, this area can also support long-term fasting history and progress-style insights.
The Events & Occasions section includes filters such as All, Occasions, and Personal. This allows users to separate built-in Islamic occasions from their own custom events. The search field allows users to search events, occasions, and notes. This is important because once a user has many personal events and Islamic dates, browsing manually becomes inefficient.
Events are grouped by time, such as This Month, Next Few Months, and Later This Year. This makes the list readable and planning-focused. The user can immediately see nearby occasions first, then future dates later. Each event row can show an icon, event name, Hijri date, Gregorian date, and countdown badge.
Built-in occasions can include important Islamic dates such as White Days, Ramadan-related dates, Eid-related dates, Arafah, Ashura, Rajab begins, and other significant calendar moments. The exact set can be controlled through the Islamic occasions lens in customization.
Personal Events
Users can create their own personal events inside the Hijri Calendar. This turns the feature into a personal Islamic calendar, not just a static list of built-in dates.
When creating a new event, the user can enter an event title. The title field is flexible and can be used for Hijri birthdays, anniversaries, personal reminders, vows, family dates, study milestones, religious goals, or any other date-based note. The placeholder itself suggests use cases such as a Hijri birthday, a nadhr, an anniversary, and similar personal occasions.
The event can be visually customized. Users can select an emoji or icon for the event. The interface can show common choices such as a star, cake, ring, mosque, tasbih, hands, money bag, airplane, and other icons. The app also supports any emoji from the user’s keyboard, so the event style is not limited to the built-in choices.
The user can also choose a color. The screen includes quick color choices such as yellow, teal, green, orange, blue, purple, white, and other options, as well as a full color wheel/palette. This allows personal events to be visually distinct on the calendar grid and event list.
Personal events can be based on either a Hijri date or a Gregorian date. This is essential because some personal events are Islamic-date based, while others are Gregorian-date based. For example, a Hijri birthday should recur on the Hijri date and move through the Gregorian seasons, while a civil anniversary may be tied to the Gregorian calendar. The event editor allows the user to choose the date system and keep the conversion synced.
The event date can be selected with a beautiful integrated picker. The user can open the calendar picker, use wheels, or type the date manually. The selected date displays its corresponding date in the other calendar system, so the user can immediately see how the Hijri and Gregorian dates relate.
Events can repeat every year. For Hijri-based events, repeating every year means the event recurs on the same Hijri date, moving through the Gregorian seasons the way Ramadan does. This explanation is shown directly in the UI so the user understands the behavior. Users can also make events one-time events when repetition is not needed.
Personal events can include reminders. Reminder options can include off, on the day, one day before, three days before, or one week before. These reminders are designed to be surfaced through the daily digest system, so important personal dates are not forgotten.
The event editor also includes Markdown notes. Users can write optional notes with Markdown support, including bold text, lists, links, and other formatting. A write/preview toggle allows users to compose the note and preview it. This is useful for storing context, duas, intentions, family details, or personal meaning attached to an event.
Personal events can be managed over time. They can be edited, shared, copied, archived, or deleted depending on the event workflow. This gives users control over their personal calendar data rather than treating events as fixed entries.
Fasting Logs
Fasting support is built directly into the Hijri Calendar. Users can log fasts on specific dates, and those logs become visible throughout the calendar and events system.
When a fast is logged, the date can show a checkmark or marker on the calendar grid. The Events & Occasions section can count fasts for this month, the last 30 days, and all time. This allows the user to maintain a practical fasting history without needing a separate tracker.
The fasting lens also helps interpret dates. It can highlight Sunnah fasting days, obligatory days, forbidden days, and logged days. For example, White Days can appear as upcoming fasting opportunities. Monday and Thursday fasting nudges can also be supported when enabled. The app can show a fasting nudge such as “Tomorrow is Monday — sunnah fast?” so the calendar becomes proactive rather than passive.
This makes the Hijri Calendar useful for worship planning. It does not merely show that a date exists; it helps the user recognize meaningful fasting opportunities and keep a personal record.
Date Converter
The Hijri Calendar system includes a dedicated Date Converter. This converter allows users to convert between Hijri and Gregorian dates using large, smooth, visual date wheels.
The Date Converter shows the Hijri date on one side and the Gregorian date on the other side. When the user changes the Hijri date, the Gregorian date updates immediately. When the user changes the Gregorian date, the Hijri date updates immediately. This real-time synchronization makes conversion feel natural and interactive.
For example, the converter can show 24 Muharram 1448 AH ⇄ 9 July 2026. The Hijri side can show day, month, and year wheels, while the Gregorian side shows day, month, and year wheels. A swap button allows the user to reverse or focus the conversion direction.
The result card below the wheels shows the converted date clearly, including weekday, Hijri date, Gregorian date, Arabic month name, and moon phase disc. It can also show whether the date is today, how many days ago it was, or how many days remain. For example, a past date can show 12331 days ago, while a future date can show a remaining countdown.
The result card also includes actions such as Today, Open in calendar, Copy, and Share. This makes the converter practical. The user can convert a date, jump directly to it in the calendar, copy it, or share it without extra steps.
Hijri Birthday Finder
The Date Converter also includes a Hijri Birthday Finder. This is a highly useful feature because many people know their Gregorian birth date but do not know the Hijri date of birth or when their next Hijri birthday will occur.
The user sets the Gregorian side to their date of birth. The app then calculates the corresponding Hijri date of birth and shows age information in both Hijri and Gregorian terms. For example, it can show the Hijri date of birth, age in Hijri years, age in Gregorian years, and the next Hijri birthday date with a countdown.
This is valuable because Hijri years are shorter than Gregorian years, so a person’s Hijri age can differ from their Gregorian age. The app makes that difference visible and understandable.
The birthday finder can show information such as the Hijri date of birth, Age in Hijri years, Age in Gregorian years, and Next Hijri birthday with the Gregorian date and countdown. This turns the Date Converter into a personal Islamic date utility, not only a generic conversion tool.
Integrated Hijri/Gregorian Date Picker
The Hijri Calendar includes an integrated date picker that can be reused across the app. This picker supports both Hijri and Gregorian dates and is designed to be more flexible than a simple Android date picker.
The picker can open in calendar mode, wheels mode, or type mode. In Calendar mode, the user can tap a date visually from a month grid. In Wheels mode, the user can scroll day, month, and year wheels. In Type mode, the user can directly enter numeric day, month, and year values.
The picker can switch between Hijri and Gregorian mode using a toggle button. This means the same dialog can be used when the user wants to select a Hijri date or a Gregorian date. The selected date shows both systems, so the user remains aware of the conversion.
This picker is not limited to the calendar screen. It can be integrated throughout Al Islam wherever date selection is needed. For example, it can be used in Prayer Times date switching and other date-based tools. This keeps the app consistent: users learn one powerful date picker and can use it everywhere.
The picker also includes a Today button, month navigation, clear selection feedback, and confirmation/cancel actions. This makes it fast, modern, and convenient while still being precise.
Calendar Customization
The Hijri Calendar includes a full Calendar Customization screen. This is one of the most important parts of the feature because Hijri date handling can vary by calculation method, sighting adjustment, regional expectation, and user preference. The customization system gives users control without making the main calendar screen complicated.
The settings are grouped into logical sections, including calculation, layout, lenses, cards and surfaces, behavior, daily digest, data management, and reset controls. This keeps the customization screen comprehensive but still understandable.
Calendar Calculation Settings
The Calculation settings control how Hijri dates are determined.
The reckoning method setting allows the user to choose the Hijri calendar calculation model. Supported methods can include Islamic Civil, Umm al-Qura, Islamic tabular/TBLA-style calculation, and astronomical-cycle based methods. This is important because different regions and use cases may rely on different Hijri calendar conventions. Some users may prefer a civil calculated calendar, while others may prefer Umm al-Qura or another supported reckoning method.
The calendar also supports sighting adjustment or date offset. This allows the user to adjust the Hijri date when local moon sighting differs from the calculated date. The current date can update in real time as the user changes the adjustment, making it clear how the offset affects the calendar.
This matters because Hijri calendars are lunar and may differ by region or sighting authority. The app’s customization allows users to align the calendar with their local context instead of being locked into a single global assumption.
Calendar Layout Settings
The layout settings control how the calendar grid is presented.
The grid follows setting allows the user to choose whether the calendar grid is Hijri-first or Gregorian-first. In Hijri-first mode, Hijri dates are the primary calendar dates and Gregorian dates appear as companion dates. In Gregorian-first mode, Gregorian dates can be primary while Hijri dates appear as companions. This flexibility is important because some users may use the Hijri calendar as their main religious calendar, while others may want Gregorian planning with Hijri context.
The week starts at setting allows the user to choose the first day of the week. All seven days can be supported. This is important because different regions and users expect calendars to start on Saturday, Sunday, Monday, or another day.
The Hijri numerals setting allows users to choose between Western numerals and Eastern Arabic numerals. This gives users control over how dates are displayed linguistically and visually.
The density setting allows users to choose between layouts such as cozy, compact, and spacious. Compact layouts fit more information on screen, while spacious layouts improve readability. Cozy provides a balanced experience.
The grid size slider allows the user to adjust how large the date cells appear. This is useful across different phone sizes and user preferences.
The companion dates toggle controls whether the other calendar’s date appears inside each cell. For example, in Hijri-first mode, the Gregorian date can appear smaller inside each Hijri date cell.
The dim outside days toggle controls whether previous-month and next-month spillover dates are faded. This makes the active month easier to read.
The Highlight Jumu’ah toggle controls whether Fridays are visually emphasized. This makes weekly Islamic rhythm visible directly in the calendar.
Calendar Lenses
The Hijri Calendar includes “lenses,” which are visual information layers that can be enabled or disabled. This is a strong design choice because it lets users decide which types of information matter to them.
The Islamic occasions lens controls whether built-in Islamic occasions appear on the calendar. This includes dates such as Ramadan, the Eids, Arafah, Ashura, the White Days, and other significant occasions.
The Personal events lens controls whether the user’s own events appear on the calendar. Users who want a clean religious calendar can hide personal events, while users who want a full personal calendar can keep them visible.
The Fasting lens controls fasting-related visual information. It can show Sunnah and obligatory days, flag forbidden days, and include the user’s own fast logs. This makes fasting opportunities and fasting history visible directly in the calendar grid.
The Moon phases lens controls whether moon phase badges appear on the grid and in the day panel. This keeps the lunar nature of the Hijri calendar visible.
Cards and Surfaces
The Cards & Surfaces settings control the major visual sections around the calendar.
The Today card toggle controls whether the main current-day card is shown. This card includes both Hijri and Gregorian dates, the live moon phase, and the next occasion.
The Upcoming strip toggle controls whether countdown cards appear under the header. This strip shows upcoming Islamic occasions and fasting days.
The Occasions to look ahead setting controls how many upcoming occasions are displayed. This is handled with a slider, such as showing 8 upcoming items. Users who want a compact calendar can reduce this number, while users who plan further ahead can increase it.
The Fasting nudge toggle controls whether the app can show helpful fasting prompts, such as a reminder that tomorrow is Monday and may be a Sunnah fasting opportunity.
These controls keep the calendar adaptable. The user can make it simple and minimal or more proactive and information-rich.
Behaviour Settings
The Behavior section controls how the calendar feels during use.
The Pulse on today setting shows a soft breathing ring on the current day. This makes today easier to notice without using harsh visual styling.
The Haptic month ticks setting provides a tactile tick as each month page settles. This gives month navigation a polished physical feel and makes swiping between months more satisfying.
These small interaction details matter because they make the calendar feel modern and carefully built rather than static.
Daily Digest
The Hijri Calendar includes a Morning digest option. This is designed as a single notification that can summarize today’s occasions, due reminders, and fasting nudges.
The morning digest is disabled by default, which is important because notifications should not be forced on the user. When enabled, it can help users stay aware of Islamic dates, personal event reminders, and fasting opportunities without needing to manually open the calendar every morning.
This makes the feature proactive while still respecting user control.
Data Export and Import
The Hijri Calendar includes data management for personal calendar information. Users can export and import their events and fast log as a JSON file.
Exporting allows users to back up personal events and fasting history. Importing allows users to restore or move that data. The import system is designed carefully: imports land as new entries, and existing entries are not overwritten. This reduces the risk of accidental data loss.
This is important because personal events and fasting logs can become meaningful long-term records. A user may build years of fasting history or personal Hijri events, so the app provides backup support rather than keeping that information trapped without recovery.
The customization screen also includes a Reset all to defaults option, allowing the user to restore calendar settings back to their default state.
Overall Design Philosophy
The Hijri Calendar is built as a complete Islamic time system. It brings together the daily Hijri date, Gregorian correspondence, moon phase, Islamic occasions, fasting days, personal events, date conversion, Hijri birthday calculation, reusable date picking, and deep customization.
The strongest part of the feature is that it remains convenient despite its depth. The user is not forced to understand calculation methods, event lenses, moon phases, or date offsets just to use it. They can simply open the calendar and see today’s Islamic date. But when they need more, the system is already there: year overview, jump dialog, events, personal reminders, fasting logs, date conversion, birthday finder, picker modes, data backup, and extensive customization.
This makes the Hijri Calendar useful for daily religious awareness, Ramadan and Dhul-Hijjah planning, Sunnah fasting, family event tracking, Hijri birthdays, Islamic occasion reminders, and long-term personal record keeping. It is modern, visual, highly configurable, and deeply integrated into the app rather than being a separate lightweight add-on.