Files
family-hub/STARTUP_GUIDE.txt

67 lines
2.0 KiB
Plaintext

========================================
FAMILY HUB - COMPLETE STARTUP GUIDE
========================================
DATABASE IS READY! ✅
- Location: D:\Hosted\familyhub\backend\data\family_hub.db
- Users: jess, lou, william, xander, bella
- Password: password123 (for all users)
STEP-BY-STEP STARTUP:
========================================
1. START THE BACKEND
- Open Terminal #1
- Run: D:\Hosted\familyhub\start-backend.bat
- Wait until you see: "Uvicorn running on http://0.0.0.0:8001"
- Leave this terminal OPEN and RUNNING
2. TEST THE BACKEND (Optional but recommended)
- Open Terminal #2
- Run: D:\Hosted\familyhub\test_backend_api.bat
- You should see: {"status":"healthy"} and a token response
- If you see errors, the backend isn't running correctly
3. START THE FRONTEND
- Open Terminal #3
- cd D:\Hosted\familyhub\frontend
- npm run dev
- Wait until you see: "Local: http://localhost:5173"
- Leave this terminal OPEN and RUNNING
4. LOGIN TO THE APP
- Open your browser to: http://localhost:5173
- Username: jess
- Password: password123
- Click Login
TROUBLESHOOTING:
========================================
If login fails with "Invalid username or password":
1. Make sure BOTH backend AND frontend are running
- Backend: Terminal #1 should show FastAPI logs
- Frontend: Terminal #3 should show Vite logs
2. Check backend logs in Terminal #1
- You should see POST /api/v1/auth/login requests
- If you don't see any requests, there's a connection issue
3. Check browser console (F12)
- Look for CORS errors or network errors
- URL should be: http://localhost:8001/api/v1/auth/login
4. Test backend directly:
- Run: test_backend_api.bat
- This will test if backend login works
QUICK COMMANDS:
========================================
Start Backend: D:\Hosted\familyhub\start-backend.bat
Start Frontend: cd D:\Hosted\familyhub\frontend && npm run dev
Test Backend: D:\Hosted\familyhub\test_backend_api.bat
View API Docs: http://localhost:8001/docs
Login with: jess / password123