═══════════════════════════════════════════════════════════════
                    🔄 SYNC BUTTON - QUICK CARD
═══════════════════════════════════════════════════════════════

📍 LOCATION
───────────
Desktop: Top navigation bar (🔄 Sync)
Mobile:  Hamburger menu → 🔄 Sync button

✨ WHAT IT DOES
───────────────
• Push local changes to server (upload)
• Pull server changes to device (download)
• Full bidirectional sync in one click
• Works on HTTPS & HTTP

🎯 WHEN TO USE
──────────────
✓ WiFi/internet connection was lost and reconnected
✓ Switched from Local Mode to Online Mode
✓ Need to force immediate sync (don't want to wait for auto-sync)
✓ Working offline then going back online

⚡ AUTO-SYNC (BACKGROUND)
─────────────────────────
• Runs every 5 seconds automatically
• Only in Online Mode
• No button press needed
• Keeps all devices synced in real-time

🔧 REQUIREMENTS
───────────────
1. Online Mode enabled (Settings → Access Mode)
2. Backend connection configured
3. Internet/WiFi connection active
4. Logged in with valid account

📱 MULTI-DEVICE SUPPORT
───────────────────────
✅ Desktop PC     (HTTPS + HTTP Local)
✅ Phone          (HTTPS + HTTP Local)
✅ Tablet         (HTTPS + HTTP Local)
✅ Laptop         (HTTPS + HTTP Local)

🌐 ACCESS URLS
──────────────
Production:  https://houseofprayer.ddns.net
Local WiFi:  http://192.168.10.178:5100
Localhost:   http://localhost:5100

💾 SYNCS THIS DATA
──────────────────
✓ Songs (lyrics, chords, keys)
✓ Profiles (names, settings)
✓ Worship lists (dates, notes)
✓ Song assignments
✓ Profile-song associations
✓ Custom transposed keys

🎨 VISUAL FEEDBACK
──────────────────
Desktop: ✅ Sync complete! (notification in top-right)
Mobile:  ✅ Sync complete! Your changes are now on the server.
Error:   ❌ Sync failed: [reason]
Offline: ⚠️ Sync is only available in Online Mode

🚨 TROUBLESHOOTING
──────────────────
Problem: "Only available in Online Mode"
Fix:     Settings → Select "Online Mode" → Save

Problem: Sync fails with error
Fix:     • Check WiFi/internet connection
         • Verify Settings → Online/DNS Settings
         • Check backend: systemctl status church-music-backend

Problem: Changes not appearing
Fix:     • Press Sync button to force refresh
         • Check connection status (green vs red dot)
         • Ensure Online Mode is enabled

═══════════════════════════════════════════════════════════════
                      DEPLOYMENT STATUS
═══════════════════════════════════════════════════════════════

Deployed:  December 17, 2025 23:19 CST
Version:   v=2380
Bundle:    main.bf5e2e29.js (114.15 kB gzipped)
Status:    ✅ LIVE & OPERATIONAL

Full Guide: See SYNC_BUTTON_GUIDE.md for complete documentation
═══════════════════════════════════════════════════════════════
