🔧 Troubleshooting

Common issues and solutions during ExpoBase setup.

🐳 Docker & Supabase Issues

Docker Not Running Error

Error message:

Cannot connect to the Docker daemon at unix:///var/run/docker.sock

Solution:

Start Docker Desktop

# Make sure Docker Desktop is running
docker --version

Wait for Docker to start (green indicator in Docker Desktop)
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:

Clean Expo cache

# Remove cached project data
rm -rf .expo

Re-login to Expo
```
eas logout
eas login
```
Re-initialize project
```
eas init
```

Bundle ID Conflicts

Error message:

Bundle identifier already exists

Solution:

Change bundle ID in app.json

ios: {
  bundleIdentifier: "com.yourcompany.newname"
},
android: {
  package: "com.yourcompany.newname"
}

Clean and rebuild

rm -rf .expo
npx expo prebuild --clean

🗂️ Template Cleanup Issues

Remove ExpoPlate References

Problem: Old template references causing conflicts

Solution:

Search and replace in all files:
- expoplate → your-app-name
- ExpoPlate → YourAppName
- com.expoplate.template → com.foodieapp.mobile

Files to update:

# Update package.json
{
  "name": "your-app-name",
  "description": "Your app description"
}
 
# Update app.json
name: "Your App Name",
slug: "your-app-slug"

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:

Check .env.local file exists
```
ls -la .env.local
```

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=

Restart development server
```
npm start
```

Invalid API Keys

Problem: Keys not working or expired

Solution:

Regenerate keys in respective services
Update .env.local with new keys

Clear cache and restart

npx expo prebuild
 
npx expo start --clear

🏗️ Build Issues

EAS Build Failures

Error message:

Build failed with unknown error

Solution:

Check build logs in Expo dashboard

Clear credentials

eas credentials:manager
# Select platform → Clear all

Retry build

eas build --platform ios --profile development --clear-cache

Plugin Configuration Errors

Error message:

Plugin configuration invalid

Solution:

Verify plugin syntax in app.json
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.