3.3 KiB

Raw Blame History

Troubleshooting Guide

Solutions for common issues in both backend and frontend.

🔧 Backend Issues

See backend/TROUBLESHOOTING.md for detailed backend troubleshooting.

Quick Fixes

Module Not Found:

cd backend
npm install
pm2 restart chitfund-backend

Can't Delete Group:

Remove all active members first
Removed members (status='removed') are OK
Backend already fixed to count only active members

Can't Remove Member (404):

Make sure using member.userId not member.id
Already fixed in latest code

📱 Frontend Issues

Member Numbers Not Showing

Cause: Database migration not applied

Fix:

cd backend
node run-member-number-migration.js
pm2 restart chitfund-backend

Then restart Flutter app.

API Connection Error

Cause: Wrong API URL

Fix: Check luckychit/lib/core/services/api_service.dart

static const String baseURL = 'https://chitfund.deepteklabs.com/api';

Build Errors

Module errors:

cd luckychit
flutter clean
flutter pub get
flutter run

Gradle errors (Android):

cd luckychit/android
./gradlew clean
cd ..
flutter build apk

🎨 UI Issues

Text Too Small

Already fixed! Theme now uses:

30% larger fonts (fontSizeMultiplier = 1.3)
High contrast colors
Large buttons

If still small, check device font scaling in system settings.

Member Delete Not Working

Make sure you're passing member.userId:

// ✅ Correct
_service.removeMemberFromGroup(groupId, member.userId);

// ❌ Wrong
_service.removeMemberFromGroup(groupId, member.id);

Already fixed in latest code!

🔄 After Code Updates

Always do these after pulling new code:

Backend

npm install                         # Get new dependencies
node run-member-number-migration.js # Apply migrations (if not done)
pm2 restart chitfund-backend        # Restart
pm2 logs chitfund-backend           # Check logs

Frontend

flutter pub get                     # Get new dependencies
flutter clean                       # Clean build cache
flutter run                         # Run app

📊 Verification

Check Backend is Healthy

curl http://localhost:3000/health
# Should return: {"success":true}

curl http://localhost:3000/api/auth/profile -H "Authorization: Bearer YOUR_TOKEN"
# Should return user data

Check Migration Applied

sudo -u postgres psql -d luckychit -c "SELECT member_number FROM group_members LIMIT 1;"
# Should show a number (1, 2, 3...)

Check Frontend Connects

# In Flutter app, try to login
# Should connect to backend successfully

🆘 Still Having Issues?

💡 Common Solutions

99% of issues are fixed by:

# Backend
cd backend
npm install
pm2 restart chitfund-backend

# Frontend
cd luckychit
flutter clean
flutter pub get
flutter run

If all else fails, see DEPLOYMENT.md for complete reset procedure.

3.3 KiB Raw Blame History