Dashboard and calendar
The main Tracking screen is a dashboard: it summarizes today, shows the week in a chart, lets you browse the month, and open day detail. Full pillar lists are reached via Quick access.
→ Tracking — overview · Reminders
Screen overview
Section titled “Screen overview”flowchart TB H[Your day + streaks] W[Activity over 7 days] M[Month calendar] Q[Quick access] R[Recent activity] H --> W --> M --> Q --> R| Block | App label | Role |
|---|---|---|
| Hero | Your day | Today’s progress + quick add actions |
| Chart | Activity over 7 days | Bars per day (reading, prayer, meditation) |
| Calendar | Month | Active days; tap → detail |
| Shortcuts | Quick access | Reading / Prayer / Meditation lists |
| Feed | Recent activity | Latest logs |
Pull the page down to refresh dashboard and displayed month.
Your day
Section titled “Your day”Date and context
Section titled “Date and context”The displayed date matches the dashboard server context (usually today in your timezone, localized format).
Three circles (Reading, Prayer, Meditation)
Section titled “Three circles (Reading, Prayer, Meditation)”| Visual | Meaning |
|---|---|
| Colored check | At least one session logged that day for that pillar |
| Gray + | None today — tap opens Add… (date = today, cannot change date in that sheet) |
Messages (insights)
Section titled “Messages (insights)”| Case | Text |
|---|---|
| 0 / 3 | One small step is enough: use a quick action below to get started. |
| 1–2 / 3 | {n} of 3 practices today — keep going. |
| 3 / 3 | Well done — reading, prayer, and meditation are all here today. |
Streaks
Section titled “Streaks”Labels such as:
- Reading · {n} d.
- Prayer · {n} d.
- Meditation · {n} d.
Streaks reflect consecutive days with activity per pillar (server calculation).
This week summary
Section titled “This week summary”Example: Reading: 4 d · Prayer: 3 d · Meditation: 2 d
And: {count} day(s) with at least one activity — a day counts if any of the three practices is present.
Activity over 7 days
Section titled “Activity over 7 days”Title: Activity over 7 days — subtitle The week at a glance.
| Element | Detail |
|---|---|
| Data | One bar per day in the current week (API week_start … week_end) |
| Legend | Bars: reading, prayer, meditation (count per day). |
| Reading | Bar height / segment = count of reading sessions that day |
| Prayer | Same |
| Meditation | Same |
A day can stack multiple sessions.
Month calendar
Section titled “Month calendar”Navigation
Section titled “Navigation”| Gesture | Effect |
|---|---|
| Month arrows | Change displayed month (focusedMonth) |
| Future days | Not tappable (tap ignored) |
| Past day or today | Opens day detail sheet |
Active days
Section titled “Active days”Days with at least one logged activity are highlighted (active_dates for the month).
| Mode | Date source |
|---|---|
| Online (dashboard loaded) | Dashboard month_summary when same month as context date |
| Otherwise / partial offline | Separate month query — possible banner: Month view is approximate offline — reconnect to refine. |
If month fails to load: The calendar will update after activities load.
Dashboard error
Section titled “Dashboard error”Unable to load dashboard. Check your connection. — calendar may still try a separate month load.
Day detail (modal sheet)
Section titled “Day detail (modal sheet)”Title: Tracking (with the day’s date).
Content:
| Area | Content |
|---|---|
| Day lists | Readings, prayers, meditations for that day (up to 50 per type) |
| Actions | Add a reading / prayer / meditation with initialDay = chosen day |
| Edit | From a row → edit (date editable) |
Useful to catch up a missed day: pick yesterday on the calendar and add missing activities.
Quick access
Section titled “Quick access”Three cards (Reading, Prayer, Meditation):
| Card | Opens |
|---|---|
| Reading | Bible reading list + FAB Add a reading |
| Prayer | Prayer list |
| Meditation | Meditation list |
Returning from a list refreshes dashboard and current month calendar.
Recent activity
Section titled “Recent activity”| State | Text |
|---|---|
| Empty | No activity logged yet. |
| Filled | Mix of reading / prayer / meditation (type, summary, date, duration or references) |
Accessibility: Show all recent activities / Collapse activity list when the list is long.
Tap a row to open that pillar’s entry.
Home vs Tracking tab
Section titled “Home vs Tracking tab”| Home — Today | Tracking tab | |
|---|---|---|
| Today’s progress | Yes | Yes (Your day) |
| 7-day chart | Possible mini version | Full Activity over 7 days |
| Month calendar | No | Yes |
| Lists / FAB | Limited shortcuts | Quick access + lists |
| Recent activity | No | Yes |
Data consistency and offline
Section titled “Data consistency and offline”| Situation | Behavior |
|---|---|
| Offline create | Local entry; dashboard updates after sync |
| Refresh | Pull-to-refresh + invalidation when returning from lists |
| Offline month | Calendar approximate until reconnected |
→ Offline mode · Synchronization
Common issues
Section titled “Common issues”| Symptom | Explanation | Action |
|---|---|---|
| Empty chart | No week data yet | Log an activity |
| Day not highlighted | No activity that day | Normal |
| Tap future day | Blocked | Pick today or past |
| Stats “out of date” | Sync in progress | Wait for sync, refresh |
Frequently asked questions
Section titled “Frequently asked questions”Does the dashboard count journal drafts?
No — only logged Tracking activities (reading, prayer, meditation).
Can I see a distant month?
Yes: navigate the calendar; active days load for that month.
Are streaks per pillar?
Yes — three independent counters (reading, prayer, meditation).
Related guides
Section titled “Related guides”| Topic | Link |
|---|---|
| Overview | Overview |
| Each pillar | Reading · Prayer · Meditation |
| Reminders | Reminders and notifications |