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

Quick Fix Guide - Get Your Data Working

Current Situation

• ✅ Backend server is running at http://localhost:5000
• ✅ Frontend is running
• ❌ Backend has no data yet (it's empty)
• ✅ Your songs and profiles are in localStorage (local device only)

Fix Steps (2 Minutes)

Step 1: Go to Settings Page

Open the app and click ⚙️ Settings in the navigation

Step 2: Choose Your Mode

Option A: Keep Everything Local (Single Device)

• Keep "Local Mode" selected (the top option)
• Click 💾 Save DNS Settings
• Your data stays on this device only
• ✅ Works offline
• ❌ Not synced to other devices

Option B: Enable Multi-Device Sync (Recommended)

• Click "Online Mode (No-IP DNS)" (the bottom option)
• Leave hostname as localhost and port as 5000
• Click 💾 Save DNS Settings
• Page will reload automatically
• You'll see a migration dialog pop up
• Click "Yes, Migrate Now"
• Wait 5-10 seconds for migration to complete
• ✅ Data now synced across all devices on your network
• ✅ Real-time updates via WebSocket

Step 3: Verify Your Data

If you chose Local Mode:

• Go to Database → you should see all your songs
• Go to Profile → you should see all your profiles

If you chose Online Mode:

• After migration completes, go to Database
• All your songs should appear
• Go to Profile → all profiles should be there
• Open another browser tab or device on same network
• Go to http://YOUR_COMPUTER_IP:3000
• You should see the same data!

Troubleshooting

"I don't see my songs after switching to Online Mode"

1. Did you click the migration button?
2. Check Settings → Data Management section
3. Click 🔄 Migrate Local Data to Backend button manually
4. Wait for success message
5. Refresh page

"Migration dialog didn't appear"

1. Go to Settings page
2. Scroll to Data Management section
3. Click 🔄 Migrate Local Data to Backend button
4. Confirm the dialog
5. Wait for success message

"Backend not responding error"

1. Check if backend is running:

   # In PowerShell, test the backend
   Invoke-RestMethod -Uri "http://localhost:5000/api/songs"
   

2. If not running, start it:

   cd "E:\Documents\Website Projects\Church_SongLyric\backend"
   npm run dev
   

"I want to access from other devices"

1. Find your computer's IP address:

   ipconfig
   

   Look for IPv4 Address (e.g., 192.168.1.50)

2. On other device, open browser to:

   http://192.168.1.50:3000
   

3. Make sure both devices are on same Wi-Fi network

Current Settings Summary

Default Settings (already configured):

• Protocol: http
• Hostname: localhost
• Port: 5000
• Mode: Local (you need to switch to Online for sync)

To Sync Across Devices:

1. Settings → Choose "Online Mode"
2. Save Settings
3. Click Migrate button when prompted (or manually in Settings)
4. Done! ✅

What Happens When You Migrate

The migration copies:

• ✅ All your songs (title, lyrics, chords, artist, band)
• ✅ All profiles (names, default keys, settings)
• ✅ All worship plans (dates, songs, notes)
• ✅ Profile-song associations
• ✅ Custom keys per profile per song

Your local data is NOT deleted - it's copied, so you always have a backup.

Need Help?

1. Check browser console (F12) for error messages
2. Check backend console for logs
3. Make sure both frontend and backend are running
4. Try the manual migration button in Settings

---

Quick Start Commands:

# Start Backend
cd "E:\Documents\Website Projects\Church_SongLyric\backend"
npm run dev

# Start Frontend (in another terminal)
cd "E:\Documents\Website Projects\Church_SongLyric\frontend"
npm start