​
🏗️ Building Your App

Build and deploy your Echo app to app stores.
Deployment is currently supported for iOS (App Store) only. Google Play support is coming soon.

​
📋 Prerequisites

Before building, ensure you’ve completed the setup:
  • ✅ All environment variables configured
  • ✅ npm run supabase:setup completed successfully
  • ✅ Apple Developer account (for iOS)
  • ✅ Google Play Console account (for Android)

​
🚀 Development Build

For testing on real devices during development: 
# Build development version
npx eas build --platform ios --profile development
npx eas build --platform android --profile development
Install the build on your device and test all features:
  • Authentication flows
  • Database operations
  • Push notifications
  • Subscription flows
  • Payment processing

​
📦 Production Build

When ready to submit to app stores:

​
1. Update Version

Update your app version in app.config.js: 
export default {
  expo: {
    version: "1.0.1", // Increment version
    ios: {
      buildNumber: "2" // Increment build number
    },
    android: {
      versionCode: 2 // Increment version code
    }
  }
};

​
2. Add Production Environment Variables

In your Expo Dashboard:
  1. Go to your project → Settings → Environment variables
  2. Add ALL your production environment variables
  3. Set environment to Production

​
3. Build for Stores

# Build for App Store and Play Store
npx eas build --platform all --profile production

​
4. Submit to Stores

# Submit to App Store
npx eas submit --platform ios

# Submit to Google Play Store
npx eas submit --platform android

​
🔧 Common Issues

Build Failed?
  • Check all environment variables are set
  • Ensure npm run supabase:setup completed without errors
  • Verify Apple/Google certificates are valid
App Crashes?
  • Check Sentry dashboard for error reports
  • Verify all API keys are correct
  • Test authentication flows

​
🎯 Next Steps

After successful store submission:
  1. Monitor your app via Sentry dashboard
  2. Track revenue via Revenue Cat dashboard
  3. Update your app with new features
  4. Deploy updates via EAS

​
🎉 App Built Successfully!

Your Echo app is now live in the app stores! Happy launching! 🚀