Church-Music/legacy-site/documentation/md-files/FORCE_REFRESH_MOBILE.md

🔥 FORCE MOBILE CACHE CLEAR - NUCLEAR OPTIONS

✅ Server Changes Applied

• Nginx now sends AGGRESSIVE no-cache headers
• cache-buster.js script deployed (kills service workers)
• Version tracking enabled

📱 MOBILE DEVICE INSTRUCTIONS

Option 1: Clear Site Data (RECOMMENDED - STRONGEST)

For iOS Safari

1. Go to Settings → Safari
2. Scroll down to Advanced → Website Data
3. Search for "houseofprayer"
4. Swipe left and Delete the entry
5. OR tap "Remove All Website Data" (clears everything)
6. Close Safari completely (swipe up from bottom, swipe Safari away)
7. Open Safari and visit the site fresh

For Android Chrome

1. Open Chrome → Three dots menu (⋮)
2. Go to Settings → Privacy and security → Site settings
3. Scroll to View permissions and data stored across sites
4. Search for "houseofprayer.ddns.net"
5. Tap it → Clear & reset
6. Close Chrome completely (recent apps → swipe away)
7. Open Chrome and visit the site fresh

---

Option 2: Private/Incognito Mode (QUICK TEST)

• iOS Safari: Tap tabs button → Private → New tab
• Android Chrome: Three dots → New Incognito Tab
• Visit: https://houseofprayer.ddns.net
• If it works here, your cache is the problem - use Option 1

---

Option 3: Hard Refresh (BROWSER OPEN)

• While on the page, try:
  • Pull down to refresh (hold and keep pulling)
  • Long press the refresh button (if visible)
  • iOS: Tap address bar → reload icon

---

Option 4: Clear Browser Cache (LESS EFFECTIVE)

iOS Safari

1. Settings → Safari
2. Clear History and Website Data
3. Confirm
4. Restart Safari

Android Chrome

1. Chrome → Three dots (⋮) → History → Clear browsing data
2. Select Cached images and files
3. Time range: All time
4. Clear data
5. Restart Chrome

---

🎯 VERIFICATION STEPS

After clearing:

1. Visit: https://houseofprayer.ddns.net
2. Check the version in bottom-right corner of app
3. Should see: v2025.12.15.2319 or newer
4. Go to Database section
5. Song sheets should show 3 columns (compact cards with lyrics)
6. Go to Profile section
7. Song sheets should show 1-2 columns (large cards)

---

🔧 WHY THIS HAPPENS

Mobile browsers AGGRESSIVELY cache web apps to:

• Save data usage
• Improve speed
• Support offline mode

iOS Safari and Android Chrome are the worst offenders. Standard "clear cache" often doesn't work because:

• Service workers cache assets separately
• PWA mode has isolated storage
• Mobile OS manages cache differently than desktop

---

🆘 IF NOTHING WORKS

1. Uninstall if installed as PWA:

   • iOS: Long press app icon → Delete
   • Android: Long press → Uninstall

2. Try different browser:

   • iOS: Try Chrome or Firefox
   • Android: Try Firefox or Samsung Internet

3. Wait 24 hours - sometimes mobile cache expires automatically

4. Access from desktop first - verify changes are live

---

📞 CURRENT BUILD INFO

• Build Date: Dec 15, 2025 23:15:49 CST
• Bundle: main.6bce11a9.js (379KB)
• Version: v2025.12.15.2319
• Cache-Buster: ACTIVE
• Nginx Headers: NO-CACHE (max-age=0)

---

✨ WHAT CHANGED

• Profile Section: 1-2 columns (large cards, NO lyrics)
• Database Section: 3 columns everywhere (compact cards WITH lyrics)
• Server: All services restarted
• Cache: Nuclear cache-busting deployed