User Guide

Geolocation Policy

UmmahLink detects your location on the first load to provide accurate prayer times. Once detected, the location is saved in your browser's local storage to save battery and data.

Smart Auto-Refresh

If your location is set to 'Auto-Detect', UmmahLink will automatically check for location changes ~20 minutes before each major prayer time (Fajr, Dhuhr, Asr, Maghrib, Isha). This ensures accuracy if you are traveling.

Traveling?

If you move to a new city, you can always manually update your location by clicking the 'Refresh' icon in the Prayer Times card.

How to Refresh Location

Click the 'Refresh' (circular arrow) icon in the Prayer Times card on the homepage. This will force the app to re-detect your current GPS coordinates immediately.

Settings & Manual Location

If auto-detection is off or fails, you can manually set your city or coordinates in the settings menu (gear icon). Prayer times will update immediately.

Adjust Hijri Date

If the displayed Hijri date is incorrect for your region, use this button to apply a +1 or -1 day correction. This setting is saved in your browser.

Edit Timetable

During Ramadan, click this to manually enter the full 30-day timetable for Sehri and Iftar times. This is useful if the automatic times do not match your local mosque's schedule.

Reset Timetable

Click this to delete your manually entered Ramadan timetable and revert to the automatic, location-based times provided by the API.

Reorder Cards

Press and hold (on mobile) or click and drag (on desktop) this icon on any card on the homepage to rearrange the layout to your preference.

Event Management

This section allows you to manage all your family's important dates.

Add Event

Add new birthdays, anniversaries, or other custom events. You can choose for them to repeat annually based on the Gregorian or Hijri calendar.

Edit Event

Modify the details of any existing event.

Delete Event

Permanently remove an event from your list.

Import Events

Restore your event list from a previously exported JSON file.

Export Events

Save a backup of all your family events to a JSON file on your device.

Pin Item

Click the pin icon on any library card to move it to a 'Pinned Items' section at the top for quick and easy access.

Unpin Item

Click the pin icon again on a pinned item to return it to the main library list.