Rest Abeg - QA Testing Guide

Steps:

1. Clear app data or use new user account
2. Navigate to Home page
3. Verify automatic redirect to Onboarding page
4. Verify progress dots show 7 steps

Steps:

1. On first onboarding screen, verify welcome message
2. Verify 'Rest Abeg' branding with yoga emoji
3. Verify Nigerian-friendly welcome text ('My dear… you've been carrying plenty things')
4. Tap 'Start' button

Steps:

1. Verify 'Why Rest?' heading displays
2. Verify explanatory text about rest benefits
3. Test 'Continue' button navigation
4. Test 'Skip' link navigates to Default Length screen

Steps:

1. Verify 4 steps are displayed with emojis (🎯 🌬️ 😌 🤲)
2. Verify each step has label and description
3. Tap 'I'm Ready' button

Steps:

1. Verify 3 options: 1 minute, 3 minutes, 5 minutes
2. Try to proceed without selection - button should be disabled
3. Select '3 minutes' option
4. Verify selection is visually highlighted with checkmark
5. Tap 'Next' button

Steps:

1. Verify 2 tone options displayed
2. Verify 'Calm + Nigerian Auntie' has 'Recommended' badge
3. Test selecting each tone option
4. Verify selection persists with checkmark
5. Tap 'Next' button

Steps:

1. Verify reminder toggle is OFF by default
2. Toggle reminders ON
3. Verify frequency options appear (2h, 3h, 3x day)
4. Select a frequency
5. Tap 'Finish Setup' button

Steps:

1. Verify 'Well done, my dear' message with sparkle emoji
2. Tap 'Start My First Rest' button
3. Verify navigation to RestSession page
4. Verify session uses selected default duration
5. Complete session and return to Home
6. Verify Home page now loads (not redirect to onboarding)

Steps:

1. Navigate to Settings page
2. Find 'Reset Onboarding' option
3. Tap to reset
4. Verify redirect to Onboarding page
5. Complete onboarding again to verify it works

Steps:

1. Start onboarding flow
2. On mobile device, verify all screens are properly centered
3. Verify content doesn't overflow viewport
4. Verify proper max-width constraint applied
5. Verify content is vertically centered on screen

Steps:

1. Navigate to Home page
2. Verify header shows 'Rest Abeg' branding
3. Verify daily prompt card displays with sparkles icon
4. Verify points display shows current points
5. Verify streak display shows current/longest streak
6. Verify weekly goal progress bar displays

Steps:

1. Locate duration picker section
2. Tap '1 min' option
3. Verify it becomes selected (highlighted)
4. Tap '3 min' option
5. Verify selection changes
6. Tap '5 min' option
7. Verify selection changes

Steps:

1. Select a duration (e.g., 3 min)
2. Tap on 'Mental Reset' category card
3. Verify navigation to RestSession page
4. Verify URL contains category=mental_reset&duration=180

Steps:

1. Scroll to bottom of Home page
2. Locate 'Drop Everything' button (red/orange gradient)
3. Tap the button
4. Verify navigation to RestSession with category=drop_everything&duration=60

Steps:

1. Locate 'Your Rest Plan' card (purple)
2. Tap the card
3. Verify navigation to RestPlan page

Steps:

1. Start any rest session from Home
2. Verify mood selection screen appears first
3. Verify 5 mood options: Stressed, Tired, Anxious, Okay, Good
4. Try tapping Continue without selecting - should be disabled
5. Select a mood (e.g., 'Stressed')
6. Verify selection is highlighted
7. Tap Continue button

Steps:

1. After mood selection, verify intro screen appears
2. Verify breathing circle animation displays
3. Verify 'Ready to rest?' heading
4. Verify duration text (e.g., '3 minutes of peace awaits')
5. Tap 'Begin Rest' button

Steps:

1. Begin a rest session
2. Verify breathing circle animates (inhale/hold/exhale)
3. Verify timer countdown displays and decrements
4. Verify guidance text appears and rotates (every ~8 seconds)
5. Verify category label shows in header
6. Verify pause/play button in header works

Steps:

1. During active session, tap sound picker button
2. Verify sound panel expands
3. Select 'Rain' sound
4. Verify audio plays (may require user interaction first)
5. Adjust volume slider
6. Verify volume changes
7. Select 'None' to disable
8. Verify audio stops

Steps:

1. During active session, tap 'End session early' link
2. Verify session ends and shows completion screen

Steps:

1. Complete a session (or end early)
2. Verify 'Well done, my dear!' message
3. Verify duration completed is shown
4. Verify mood selector appears (Calm, Refreshed, Peaceful, Grateful, Same)
5. Select a post-session mood
6. Optionally add journal note
7. Tap 'See Summary' button

Steps:

1. After completing mood selection, verify summary displays
2. Verify points earned section shows with breakdown
3. Verify streak status shows
4. Verify weekly goal progress bar
5. If first session, verify 'first_rest' badge earned
6. Tap 'Done' button
7. Verify navigation back to Home

Steps:

1. Start a 3-minute session
2. After 1 minute, tap 'End session early'
3. Complete mood selection and journal
4. On summary screen, verify duration shows 1 minute (not 3 minutes)
5. Verify points calculation is based on actual time (not full duration)

Steps:

1. Note current points on Home page
2. Complete a 3-minute session fully
3. Verify points calculation: 10 (base) + 15 (5 per minute × 3) + 10 (completion) = 35 points
4. Check if streak bonus (+5) applies
5. Verify new total on Home page

Steps:

1. Complete a session today
2. Verify streak shows at least 1
3. Note: Streak increments only once per day
4. Multiple sessions same day shouldn't increase streak count

Steps:

1. On Home page, note weekly goal (default 30 min)
2. Complete sessions to add to weekly total
3. Verify progress bar updates
4. When goal reached, verify +50 bonus points

Steps:

1. Complete first session - verify 'first_rest' badge
2. On Home page, verify badge section displays
3. Hover/tap badges for tooltip info

Steps:

1. On Home page, tap the edit icon on goal progress
2. Verify goal options dialog appears (15, 30, 45, 60, 90 min)
3. Select new goal
4. Verify goal updates on Home page

Steps:

1. Navigate to Rest Plan page
2. If no plan exists, verify empty state shows
3. Tap 'Create Personalized Plan' button
4. Verify loading state displays
5. Wait for AI to generate plan (may take 5-10 seconds)
6. Verify plan displays with sessions grouped by day

Steps:

1. After plan generation, verify AI insights card shows
2. Verify insights are personalized based on user data

Steps:

1. On a generated plan, tap 'Edit' on any session
2. Verify edit dialog opens
3. Change category, duration, time of day, or ambient sound
4. Tap 'Save Changes'
5. Verify session updates in the plan

Steps:

1. Edit a session
2. Tap 'Remove' button
3. Verify session is removed from plan

Steps:

1. Tap 'Add Session' link
2. Configure new session in dialog
3. Save the session
4. Verify it appears in the plan

Steps:

1. On a plan session card, tap the play button
2. Verify RestSession starts with correct category and duration

Steps:

1. With existing plan, tap 'Generate New Plan'
2. Verify old plan is replaced with new one

Steps:

1. Navigate to History page via bottom nav
2. Verify completed sessions list
3. Verify sessions show category, duration, date
4. Verify sessions grouped by date

Steps:

1. Verify total rest time stat
2. Verify total sessions count
3. Verify streak display

Steps:

1. Navigate to Settings page
2. Tap 'Email Reminders' menu item
3. Verify EmailReminders page loads
4. Verify current settings display

Steps:

1. On Email Reminders page, toggle 'Email Reminders' ON
2. Verify toggle icon changes to branded color (#D4B8A6) when enabled
3. Verify frequency options appear (Daily, Weekly) in larger, rounded cards
4. Verify time picker appears with touch-friendly controls
5. Verify timezone is auto-detected and displayed with explanation text

Steps:

1. With email reminders enabled, select 'Daily' frequency
2. Verify setting saves
3. Change to 'Weekly' frequency
4. Verify setting updates

Steps:

1. Tap time picker dropdown (now larger with rounded borders)
2. Select a time (e.g., 9:00 AM)
3. Verify selection saves
4. Verify time displays in user's timezone
5. Verify information card explains timezone setting clearly

Steps:

1. Toggle 'Email Reminders' OFF
2. Verify frequency and time options disappear
3. Verify setting persists after page refresh

Steps:

1. As admin user, navigate to 'Test Email Reminders' from Settings
2. Tap 'Send Test Email'
3. Check email inbox for test message
4. Verify email is branded with company logo
5. Tap 'Run Reminder Check' to trigger system check

Steps:

1. Navigate to Settings via bottom nav
2. Verify page title 'Settings' displays
3. Verify menu items display with icons

Steps:

1. Verify Default Rest Length shows selected value
2. Verify Voice Tone shows selected style
3. Verify Reminders shows On/Off status

Steps:

1. Navigate to Home page
2. Select a duration (1 min, 3 min, or 5 min)
3. Verify selection is highlighted
4. Navigate away and return to Home
5. Verify selected duration persists

Steps:

1. From Settings, tap 'Push Notifications'
2. On NotificationSettings page, tap back arrow
3. Verify navigation returns to Settings page (not Home)
4. From Settings, tap 'Reminders'
5. On Reminders page, tap back arrow
6. Verify navigation returns to Settings page

Steps:

1. Tap 'Reset Onboarding' option
2. Verify UserSettings.has_completed_onboarding is set to false
3. Verify redirect to Onboarding page

Steps:

1. As non-admin user, navigate to Settings
2. Verify 'Test Notifications' option is NOT visible
3. As admin user, navigate to Settings
4. Verify 'Test Notifications' option IS visible (purple highlight)
5. Tap 'Test Notifications'
6. Verify TestNotifications page loads

Steps:

1. Verify bottom nav shows: Home, Meditate, Rewards, History, Settings
2. Verify nav has proper height (20px / 5rem) and padding
3. Verify nav items use flex-1 for equal spacing
4. Verify text is 10px font size
5. Tap each icon and verify correct page loads
6. Verify active state highlighting (clay color)
7. On mobile, verify nav items are not truncated or overlapping

Steps:

1. Start a rest session
2. Verify bottom navigation is hidden
3. Complete or exit session
4. Verify navigation reappears

Steps:

1. Scroll to bottom of any page
2. Tap any navigation item to navigate to different page
3. Verify new page loads scrolled to the top (not at bottom)

Steps:

1. From footer, tap 'Privacy Policy' link
2. Verify bottom navigation is hidden
3. Navigate back and tap 'Terms of Service'
4. Verify bottom navigation is hidden
5. Tap 'Disclaimer' link
6. Verify bottom navigation is hidden

Steps:

1. Navigate deep into app (Home → RestPlan → Edit)
2. Use back buttons to navigate back
3. Verify correct page hierarchy

Steps:

1. Clear localStorage to trigger mini tour
2. Navigate to Home page after onboarding
3. Verify mini tour modal appears
4. On mobile devices, verify modal is properly centered on screen
5. Verify modal does not overflow or get cut off
6. Verify modal backdrop covers full screen

Steps:

1. Test with user who has no sessions
2. Verify onboarding triggers for new users
3. Complete onboarding
4. Verify Home shows 0 points, 0 streak
5. Verify History shows empty state
6. Verify first session awards 'first_rest' badge

Steps:

1. Start a session
2. Use X button to exit mid-session
3. Verify no data is saved for incomplete exit
4. Start another session and end early via link
5. Verify partial session is saved

Steps:

1. Trigger rating modal (after 3rd, 10th, or 20th session)
2. Fill out rating form with star rating and feedback
3. If network error occurs during submission, verify error toast displays
4. Verify modal remains open for retry
5. On success, verify success toast and modal closes

Steps:

1. With slow/no network, attempt to save session
2. Verify appropriate error handling
3. Test AI plan generation with slow network

Steps:

1. Tap 'Meditate' in bottom navigation
2. Verify meditation library page loads
3. Verify theme filter tabs display (All, Stress Relief, Focus, Sleep, etc.)
4. Verify meditation cards display with title, description, duration

Steps:

1. On Meditations page, tap 'Stress Relief' filter
2. Verify only stress relief meditations show
3. Tap 'Focus' filter
4. Verify list updates to focus meditations
5. Tap 'All' to reset filter

Steps:

1. Tap play button on any meditation card
2. Verify MeditationPlayer page loads
3. Verify meditation title displays
4. Verify script text displays
5. Verify timer and controls appear

Steps:

1. On a meditation card, tap the heart icon
2. Verify heart fills/highlights
3. Navigate away and return to Meditations page
4. Verify favorite state persists

Steps:

1. Start and complete a meditation
2. Return to Meditations page
3. Verify completed indicator shows on that meditation
4. Check times_completed counter increments

Steps:

1. Start a meditation with recommended sound
2. Verify ambient sound picker available
3. Change ambient sound during meditation
4. Verify audio switches correctly

Steps:

1. Navigate to Settings page
2. Tap 'Push Notifications' menu item
3. Verify NotificationSettings page loads

Steps:

1. On NotificationSettings page, tap 'Enable Notifications'
2. Browser should prompt for notification permission
3. Grant permission
4. Verify 'Notifications are enabled' message shows
5. Verify notification type toggles appear

Steps:

1. With notifications enabled, verify Daily Reminders toggle
2. Toggle Daily Reminders ON
3. Verify time picker appears
4. Select a reminder time (e.g., 9:00 AM)
5. Verify selection saves

Steps:

1. Toggle 'Session Suggestions' off
2. Toggle 'Group Updates' off
3. Toggle 'Achievements' off
4. Refresh page
5. Verify toggle states persist

Steps:

1. With notifications enabled, tap 'Disable' link
2. Verify master toggle turns off
3. Verify notification type toggles disappear

Steps:

1. If notification permission was denied in browser
2. Verify warning message about blocked notifications
3. Verify Enable button is disabled with explanation

Steps:

1. As admin user, navigate to TestNotifications page from Settings
2. Verify push notifications are enabled
3. Tap 'Re-engagement' quick test button
4. Verify test notification is sent and success message displays
5. Try 'Milestone Alert', 'Weekly Summary', 'Daily Reminder', and 'Achievement' tests
6. Test custom notification with custom title and body
7. Tap 'Run Full Check' to test system notification check

Steps:

1. As a non-admin user, navigate to Settings
2. Verify 'Admin Analytics' option is NOT visible
3. As an admin user (role='admin'), navigate to Settings
4. Verify 'Admin Analytics' option IS visible (purple highlight)

Steps:

1. As non-admin, try to directly access AdminAnalytics page URL
2. Verify 'Access Denied' message displays
3. Verify shield icon and explanation text
4. Verify 'Go Back' button works

Steps:

1. As admin, navigate to Admin Analytics
2. Verify page loads with time range selector (7d, 14d, 30d, 90d)
3. Verify key metrics cards display (Total Users, Active Users, Total Sessions, Avg Session)

Steps:

1. Click '14d' time range button
2. Verify charts update to show 14-day data
3. Click '30d' button
4. Verify charts update again
5. Verify '+X this period' text updates

Steps:

1. Verify bar chart displays session counts
2. Hover over bars to see tooltips
3. Verify X-axis shows dates, Y-axis shows count

Steps:

1. Verify line chart displays new user signups
2. Verify chart updates with time range selection

Steps:

1. Verify pie chart shows popular categories
2. Verify legend shows category names and counts
3. Verify colors differentiate categories

Steps:

1. Scroll to 'Most Active Users' section
2. Verify list shows up to 10 users
3. Verify each row shows email and session count
4. Verify ranking numbers (1-10)

Steps:

1. Scroll to 'Mood Insights' section
2. Verify 'Before Sessions' column shows mood distribution
3. Verify 'After Sessions' column shows mood distribution

Steps:

1. Verify meditation usage section shows
2. Verify counts for: Available, Completions, Favorites

Steps:

1. Navigate to Settings page
2. Tap 'Offline Content' menu item
3. Verify OfflineContent page loads
4. Verify online/offline status banner displays

Steps:

1. Navigate to Meditations page
2. On any meditation card, tap the download icon
3. Verify icon changes to checkmark (downloaded)
4. Navigate to Offline Content page
5. Verify meditation appears in 'Downloaded Meditations' list

Steps:

1. On Offline Content page, find a downloaded meditation
2. Tap the trash icon
3. Verify meditation is removed from list
4. Return to Meditations page
5. Verify download icon reappears on that meditation

Steps:

1. Simulate offline mode (disable network in browser DevTools)
2. Verify offline indicator banner appears at top of screen
3. Verify banner shows 'Offline Mode' with WifiOff icon
4. Re-enable network
5. Verify 'You're back online!' toast appears

Steps:

1. Go offline (disable network)
2. Complete a rest session
3. Verify 'Session saved. Will sync when online' message
4. Go to Offline Content page
5. Verify 'Sessions to Sync' banner shows count
6. Re-enable network
7. Verify sessions sync automatically
8. Verify pending count goes to 0

Steps:

1. Download a meditation while online
2. Go offline
3. Navigate to Meditations page
4. Tap on the downloaded meditation
5. Verify meditation player loads with cached content

Steps:

1. Download several meditations
2. Navigate to Offline Content page
3. Verify stats show correct counts: Meditations, Rest Scripts, Total

Steps:

1. Navigate to Landing page (while logged out)
2. Verify hero section with 'Rest Abeg' branding
3. Verify animated breathing circle in phone mockup
4. Verify 'Start Resting Free' CTA button
5. Verify 'Watch Demo' button

Steps:

1. Scroll to features section
2. Verify 7 feature cards display: Sessions, Meditations, Drop Everything, Progress, Reminders, AI Plans, Offline Mode
3. Verify each card has icon, title, and description

Steps:

1. Tap 'Watch Demo' button
2. Verify YouTube modal opens
3. If no video ID set, verify placeholder with 'Coming Soon' message
4. Tap X to close modal
5. Verify modal closes smoothly

Steps:

1. If YouTube video ID is set, open demo modal
2. Verify video loads in iframe
3. Verify autoplay starts
4. Verify video controls work
5. Close modal and verify video stops

Steps:

1. Tap 'Start Resting Free' button
2. Verify redirect to login/signup page
3. After authentication, verify redirect to Home page

Steps:

1. Scroll to footer section
2. Tap 'Privacy Policy' link
3. Verify Privacy Policy page loads
4. Navigate back and tap 'Terms of Service'
5. Verify Terms page loads
6. Navigate back and tap 'Disclaimer'
7. Verify Disclaimer page loads

Steps:

1. Start a rest session
2. Verify guidance text displays during session
3. Verify text rotates every ~8 seconds
4. Check that scripts match selected tone style

Steps:

1. Complete onboarding with 'Calm + Nigerian Auntie' tone
2. Start a session and note guidance text style
3. Reset onboarding and select 'Calm Minimalist' tone
4. Start session and verify different text style

Steps:

1. Start 1-minute session, note script content
2. Start 3-minute session, note script content
3. Start 5-minute session, note script content
4. Verify scripts are appropriate length for duration