​
🔧 Troubleshooting

Common issues and solutions during Echo setup.

​
🐳 Docker & Supabase Issues

​
Docker Not Running Error

Error message: 
Cannot connect to the Docker daemon at unix:///var/run/docker.sock
Solution:
  1. Start Docker Desktop
# Make sure Docker Desktop is running
docker --version
  1. Wait for Docker to start (green indicator in Docker Desktop)
  2. Retry Supabase setup 
npm run supabase:setup

​
Supabase Local Issues

Error message: 
supabase: command not found
Solution: 
# Install Supabase CLI
brew install supabase/tap/supabase
 
# Verify installation
supabase --version

​
📱 Project Authorization Issues

​
Project Not Authorized Error

Error message: 
Project not found or you don't have access
Solution:
  1. Clean Expo cache
# Remove cached project data
rm -rf .expo
  1. Re-login to Expo
eas logout
eas login
  1. Re-initialize project
eas init

​
Bundle ID Conflicts

Error message: 
Bundle identifier already exists
Solution:
  1. Change bundle ID in app.config.js
ios: {
  bundleIdentifier: "com.yourcompany.newname"
},
android: {
  package: "com.yourcompany.newname"
}
  1. Clean and rebuild
rm -rf .expo
npx expo prebuild --clean

​
🗂️ Template Cleanup Issues

​
Remove Template References

Problem: Old template references causing conflicts Solution:
  1. Search and replace in all files: expoplate → your-app-name, ExpoPlate → YourAppName, com.expoplate.template → com.foodieapp.mobile
  2. Files to update:
// package.json
{
  "name": "your-app-name",
  "description": "Your app description"
}

// app.config.js
name: "Your App Name",
slug: "your-app-slug"
  1. Remove old project links:
# Clean all cached data
rm -rf .expo
rm -rf node_modules/.cache
 
# Reinstall dependencies
npm install

​
🔑 Environment Variables Issues

​
Missing .env.local Variables

Error message: 
Environment variable not found
Solution:
  1. Check .env.local file exists
ls -la .env.local
  1. Verify all required variables:
EXPO_PUBLIC_SUPABASE_URL=
EXPO_PUBLIC_SUPABASE_ANON_KEY=
SUPABASE_SERVICE_ROLE_KEY=
EXPO_ACCESS_TOKEN=
EXPO_PUBLIC_GOOGLE_CLIENT_ID=
  1. Restart development server
npm start

​
Invalid API Keys

Problem: Keys not working or expired Solution:
  1. Regenerate keys in respective services
  2. Update .env.local with new keys
  3. Clear cache and restart
npx expo prebuild
 
npx expo start --clear

​
🏗️ Build Issues

​
EAS Build Failures

Error message: 
Build failed with unknown error
Solution:
  1. Check build logs in Expo dashboard
  2. Clear credentials
eas credentials:manager
# Select platform → Clear all
  1. Retry build
eas build --platform ios --profile development --clear-cache

​
Plugin Configuration Errors

Error message: 
Plugin configuration invalid
Solution:
  1. Verify plugin syntax in app.config.js
  2. Clean rebuild after plugin changes
npx expo prebuild --clean

​
📞 Getting Help

​
Check Logs

# Expo logs
npx expo start --clear
 
# EAS build logs
eas build:list
 
# Supabase logs
npm run supabase:logs

​
Reset Everything

# Nuclear option - reset everything
rm -rf .expo
rm -rf node_modules
npm install
eas init
npx expo prebuild --clean
💡 Still having issues? Check the individual setup pages for detailed instructions or start fresh with a clean project.