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

134 lines
3.4 KiB
Markdown

# 🔥 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