Initial commit - Church Music Database

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

@@ -0,0 +1,133 @@
+# 🔥 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