Files
Church-Music/legacy-site/documentation/txt-files/SYNC_BUTTON_QUICK_CARD.txt

93 lines
3.7 KiB
Plaintext

═══════════════════════════════════════════════════════════════
🔄 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
═══════════════════════════════════════════════════════════════