Al Islam's History section tracks all your reading activity across Hadith, Quran, and other content. It provides detailed reading logs, powerful filtering, and a comprehensive Dashboard with metrics, statistical data, visual graphs, and reading habit analysis.
Overview
The History section is accessible in two ways:
- From the Home Screen — tap See All in the "Recent" section
- From Tools Menu — tap Tools in the bottom navigation bar, then select History
Both paths lead to the same History section with two pages: History and Dashboard.
What Gets Tracked
History automatically tracks:
- Random Hadiths — hadith you read from the Random Hadith section
- Specific verses — Quranic verses you opened or previewed
- Specific hadith — individual hadith narrations you read
- Content previews — any content you opened and viewed
- Timestamps — exact dates and times of each reading
All reading activity is automatically saved without any manual action required.
History Page
The History page displays a detailed log of all your readings.
History Listing
The main view shows all readings you've completed with:
- Content title — what you read (hadith reference, verse reference, etc.)
- Content snippet — preview of what was read
- Source section — which section it came from (Hadith, Quran, Random Hadith, etc.)
- Timestamp — exact date and time you read it
- Date — the day you read it
Interacting with History Items
From each history item, you can:
- Click to reopen — directly open that content again
- Delete — remove it from history
- View metadata — see complete details about the reading
Filtering & Searching
Source Filter Chips
At the top of the History page, below the search bar, you see filter chips showing:
- Hadith count — "Hadith: 52" (example) showing how many hadith readings you have
- Quran count — "Quran: 47" (example) showing how many Quranic readings
- Random Hadith count — "Random Hadith: 23" (example)
- Other sources — counts for any other content types
You can:
- Tap a chip to filter by that source
- Deselect chips to exclude sources from the view
- See combined totals or individual source breakdowns
Search Filter
A search bar at the top lets you:
- Search by content title — find specific verses or hadith
- Search by timestamp — look for readings from specific times
- Real-time filtering — results update as you type
Time Period Filter
Below the search bar, there's a time duration selector with:
Quick selection buttons:
- All — all history (no time limit)
- Today — only today's readings
- Yesterday — only yesterday's readings
- 3 Days — past 3 days
- 7 Days — past week
- 30 Days — past month
- 3 Months — past 3 months
- 1 Year — past year
- 2 Years — past 2 years
- 3+ Years — 3 or more years of history
Custom date range:
- Calendar button — select a custom start and end date
- Real-time updates — all data instantly reflects your chosen time period
Sorting
The history listing can be sorted:
- By date — ascending or descending
- Chronological order — newest first or oldest first
Dashboard Reflection
When you change the time period filter or search query:
- Dashboard data updates instantly to reflect your selected time range
- All metrics and graphs recalculate for the filtered period
Dashboard Page
The Dashboard page displays comprehensive metrics, statistics, and visual data about your reading habits.
Total Readings Metric
- Total readings — how many times you've opened and read content
- Reflects selected time period — changes when you adjust the time filter
- Cumulative count — total across all sources in the selected timeframe
Unique Readings Metric
- Unique readings — how many different pieces of content you've read
- Distinguishes from total — if you read the same verse twice, it counts as 1 unique reading
- Reflects time period — changes with your selected filter
Streaks
Daily Streak
- Current streak — how many consecutive days you've read content
- Best streak — your longest consecutive reading streak to date
- Reflects all-time data — does not change with time filter (shows your absolute best)
Average Metrics
Average Readings Per Day
- Average daily readings — total readings divided by number of days in the selected period
- Shows reading frequency — how many times per day you typically read
Average Unique Readings Per Day
- Average daily unique readings — unique readings divided by number of days
- Shows content variety — how many different pieces of content you read daily
Section-Specific Metrics
For each source (Hadith, Quran, Random Hadith, etc.):
- Readings in that section — total reads from that source
- Unique readings in that section — different content from that source
- Section-specific averages — average reads per day from that source
Activity Over Time Graph
A visual graph showing your reading activity:
- Vertical pillars/columns — representing reading activity on each day
- X-axis — dates (specific dates, months, or years depending on zoom level)
- Y-axis — number of readings
- Interactive zooming — pinch in/out to zoom in and out
- Time granularity — shows specific dates when zoomed in, months/years when zoomed out
- Visual clarity — easy to see reading patterns and trends
This graph helps you:
- Identify reading patterns — see when you read most/least
- Track consistency — visualize your reading habits over time
- Spot trends — observe changes in reading frequency
Reading by Hour
A time-of-day breakdown showing:
- Which hours you read most — breaks down reading activity by time of day (e.g., 6 AM, 12 PM, 9 PM)
- Reading habits by time — see if you tend to read more in morning, afternoon, or evening
- 24-hour coverage — complete view of your daily reading patterns
This metric helps you:
- Understand your reading routine — when you're most active
- Plan your day — identify your preferred reading times
- Track changes — see if your reading habits shift over time
Reading by Section
A donut/pie chart showing:
- Percentage of readings from Quran — e.g., "40% Quran"
- Percentage of readings from Hadith — e.g., "35% Hadith"
- Percentage of readings from Random Hadith — e.g., "25% Random Hadith"
- Other sources — any additional content types
This visualization helps you:
- See reading distribution — which sources you engage with most
- Balance your study — identify if you're reading from only one source
- Plan content mix — decide if you want more variety
Reading Progress in Collections
Beyond the dedicated History section, reading progress is visible throughout the app:
In Hadith Books
When you view the Hadith section and open Hadith books, you see:
- Reading progress for each book — how much of each collection you've read
- Progress bars — visual indicators of completion
- Percentage completion — how far through each book you are
- Book-by-book metrics — individual progress for each hadith collection
This lets you:
- Track completion — see how much of each book you've finished
- Plan reading — know which books need more attention
- Manage multiple collections — see progress across all your hadith books
In Quran Section
Similar reading progress is displayed for Quranic content:
- Surah progress — how much of each surah you've read
- Overall Quran progress — percentage of all 6,236 verses read
- Visual indicators — progress bars for each section
Dashboard Features & Updates
Continuous Improvement
The Dashboard is consistently being enhanced with:
- New metrics — additional statistical data added regularly
- Improved visualizations — graphs and charts enhanced with each update
- Better insights — more meaningful analysis of reading habits
You can expect:
- More detailed breakdowns — finer granularity in metrics
- Additional graphs — more ways to visualize reading data
- Advanced statistics — deeper analysis of reading patterns
Changelog Reference
Check the Changelog for:
- Dashboard updates — new metrics and features
- New statistical data — newly added analytics
- Visualization improvements — better graphs and charts
Use Cases
Tracking Reading Consistency
- Use streaks to maintain a daily reading habit
- Monitor activity over time graph to see patterns
- Use time period filters to focus on specific spans (e.g., "Did I read more last month?")
Understanding Reading Habits
- Check reading by hour to identify your preferred reading times
- View reading by section to see which content you prefer
- Analyze average readings per day to understand your typical reading frequency
Monitoring Progress
- Track total and unique readings to ensure variety in study
- Monitor section-specific metrics to balance between Hadith and Quran
- Use Hadith book progress to plan which books to read next
Setting Goals
- Use streaks as motivation for consistent reading
- Set time period targets (e.g., "Read 30 unique pieces in 7 days")
- Monitor section balance (e.g., "Aim for 50% Quran, 50% Hadith")
Data Persistence
- All history is saved locally on your device
- Reading activity persists across app sessions
- Timestamps are recorded with complete accuracy
- No data loss even if the app is closed or the device restarts
Troubleshooting
"History seems incomplete"
Possible cause: Not all readings were tracked in older app versions.
Note: History tracking has improved with each update. Recent readings should be complete.
"Dashboard shows zero metrics"
Possible cause: No readings recorded in the selected time period.
Fix:
- Check your time period filter — you may have selected a period with no activity
- Switch to "All" to see all-time metrics
"Streak was reset unexpectedly"
Cause: A day with no readings breaks the streak.
Note: Streaks require consecutive days of reading. Any day with zero reads resets the streak.
"Time period filter isn't working"
Cause: Calendar selection may not have saved.
Fix:
- Use the quick selection buttons (Today, 7 Days, 30 Days, etc.)
- Or tap the calendar button again to ensure your custom date range is saved