Skip to content

BUILD_TROUBLESHOOTING.md

Latest commit

 

History

History
187 lines (141 loc) · 4 KB

BUILD_TROUBLESHOOTING.md

File metadata and controls

187 lines (141 loc) · 4 KB

🔧 Build Troubleshooting Guide

❌ Current Issue

Your builds are failing during the "Prepare project" phase with an "Unknown error".

Failed Builds:

  1. c00a17a8-ea14-44bd-815c-94688119bf3e
  2. 38091b61-fe35-410f-b598-4d6fb595a3d5
  3. e504d834-8838-42e7-b28a-67f6209e72b4
  4. 0b555683-33b0-4c87-b423-be2735efdef0

🔍 How to View Detailed Logs

  1. Visit your builds page: https://expo.dev/accounts/reetkumarbind/projects/ReetPortfolioApp/builds

  2. Click on the latest failed build

  3. Look for the "Prepare project" phase logs

  4. Check for specific error messages

🎯 Common Causes & Solutions

1. React 19 Compatibility Issues

Problem: React 19 is very new and might have compatibility issues with some Expo packages.

Solution: Downgrade to React 18

npm install react@18.2.0 react-dom@18.2.0
npm install @types/react@18.2.0

2. New Architecture Issues

Problem: New Architecture might not be fully compatible with all dependencies.

Solution: Already disabled in app.json ✅

3. Dependency Conflicts

Problem: Some packages might have version conflicts.

Solution: Clean install

rm -rf node_modules package-lock.json
npm install

4. Metro Bundler Cache

Problem: Cached files causing issues.

Solution: Clear all caches

npx expo start --clear
npm run build:android:preview

5. EAS Build Configuration

Problem: eas.json might need adjustment.

Solution: Try with simpler configuration

🚀 Recommended Next Steps

Step 1: Check Build Logs

Visit the build URL and look for specific error messages in the "Prepare project" phase.

Step 2: Try React 18 (Most Likely Fix)

# Downgrade React
npm install react@18.2.0 react-dom@18.2.0 @types/react@18.2.0

# Rebuild
eas build -p android --profile preview

Step 3: Simplify Dependencies

Remove optional dependencies temporarily:

npm uninstall react-native-worklets
eas build -p android --profile preview

Step 4: Try Development Build

eas build -p android --profile development

Step 5: Contact Expo Support

If all else fails, share your build logs with Expo support:

📝 What to Check in Build Logs

Look for these keywords:

  • ❌ Error:
  • ❌ Failed to
  • ❌ Cannot find
  • ❌ Module not found
  • ❌ Dependency
  • ❌ Version

🔄 Alternative: Local Build

If EAS Build continues to fail, you can build locally:

Option 1: Expo Prebuild + Android Studio

npx expo prebuild
# Then open in Android Studio and build

Option 2: EAS Build Local

eas build --local -p android --profile preview

💡 Quick Fixes to Try

Fix 1: Update Expo SDK

npx expo install --fix

Fix 2: Reset EAS Configuration

rm eas.json
eas init
eas build -p android --profile preview

Fix 3: Minimal app.json

Create a backup and try with minimal configuration:

{
  "expo": {
    "name": "ReetPortfolioApp",
    "slug": "ReetPortfolioApp",
    "version": "1.0.0",
    "android": {
      "package": "com.reetkumarbind.ReetPortfolioApp"
    },
    "extra": {
      "eas": {
        "projectId": "a2b71274-3fd7-4f9c-90df-9751646a744a"
      }
    }
  }
}

📊 Build Status Commands

# List all builds
eas build:list

# View specific build
eas build:view [BUILD_ID]

# Cancel running build
eas build:cancel

🆘 Get Help

  1. Check build logs at expo.dev
  2. Copy the error message
  3. Search Expo forums for similar issues
  4. Ask in Discord with build ID and error

📞 Next Actions

  1. ✅ Visit: https://expo.dev/accounts/reetkumarbind/projects/ReetPortfolioApp/builds
  2. ✅ Click on latest failed build
  3. ✅ Read "Prepare project" phase logs
  4. ✅ Copy error message
  5. ✅ Try React 18 downgrade (most likely fix)

Most Common Fix: Downgrade to React 18

npm install react@18.2.0 react-dom@18.2.0 @types/react@18.2.0
eas build -p android --profile preview