Demo Mode

No student ID available

Telebort | Learning to code made fun!

Activity 12: Deploy Ready

Complete EAS Build configuration template for deploying React Native apps to iOS App Store and Google Play Store.

📦 What's Included

This template provides a 65-70% complete deployment configuration. You'll customize the remaining 30-35% for your specific app.

✅ Pre-Built (100% Complete)

App.js - Simple demo app showcasing deployment readiness
eas.json - Complete EAS Build configuration with all profiles
package.json - React 19 + React Native 0.79.5 + Expo SDK 53
.gitignore - Comprehensive ignore file for React Native projects
docs/DEPLOYMENT_GUIDE.md - Step-by-step deployment instructions
docs/APP_STORE_CHECKLIST.md - Complete submission checklist
scripts/generate-assets.sh - Automated asset generation script

📝 To Customize (30-35%)

app.json - Update app name, bundle IDs, permissions (TODO #2)
assets/ - Replace template icons and splash screens (TODO #1)
docs/PRIVACY_POLICY.md - Customize privacy policy template

🚀 Quick Start

One. Install Dependencies

bash

# Install packages
npm install --legacy-peer-deps

# Install EAS CLI globally
npm install -g eas-cli

# Login to Expo
eas login

# Configure EAS project
eas build:configure

2. Complete TODOs

TODO #1: Create App Assets (60 min)

Replace template assets with your designs:

bash

# Required assets:
assets/icon.png          # 1024x1024px PNG
assets/splash.png        # 2048x2732px PNG
assets/adaptive-icon.png # 1024x1024px PNG (Android)

# Use the asset generator script:
./scripts/generate-assets.sh path/to/your/icon.png path/to/your/splash.png

Design Requirements:

Icon: Simple, recognizable at small sizes, no text
Splash: Center-focused logo, solid background color
Adaptive Icon: Center 66% always visible (Android)

TODO #2: Configure app.json (30 min)

Update these fields in app.json:

json

{
  "expo": {
    "name": "YourAppName",                          // TODO #2.1
    "slug": "your-app-name",                        // TODO #2.2
    "version": "1.0.0",                             // TODO #2.3
    "description": "Your app description",          // TODO #2.4
    "splash": {
      "backgroundColor": "#4A90E2"                  // TODO #2.5
    },
    "ios": {
      "bundleIdentifier": "com.yourname.yourapp"    // TODO #2.6
    },
    "android": {
      "package": "com.yourname.yourapp",            // TODO #2.8
      "adaptiveIcon": {
        "backgroundColor": "#4A90E2"                // TODO #2.7
      }
    }
  }
}

Important:

Bundle IDs must be globally unique
Use reverse domain notation: com.yourname.appname
Update permission descriptions to match your app's functionality

TODO #3: Build and Submit (60 min)

Create production builds and submit to app stores:

bash

# Build for both platforms
eas build --profile production --platform all

# Or build separately:
eas build --profile production --platform ios
eas build --profile production --platform android

# Submit to app stores:
eas submit --platform ios
eas submit --platform android

Follow docs/DEPLOYMENT_GUIDE.md for complete step-by-step instructions.

📚 Documentation

Essential Guides

DEPLOYMENT_GUIDE.md - Complete deployment workflow
- EAS Build setup
- Creating builds (dev, preview, production)
- Submitting to iOS App Store
- Submitting to Google Play Store
- Troubleshooting common issues
APP_STORE_CHECKLIST.md - Submission requirements
- iOS App Store checklist
- Google Play Store checklist
- Asset requirements
- Metadata requirements
- Common rejection reasons
PRIVACY_POLICY.md - Privacy policy template
- Customizable template
- GDPR and CCPA compliant
- Covers common data collection scenarios
- Hosting instructions

🏗️ EAS Build Profiles

This template includes three build profiles:

Development Profile

bash

eas build --profile development --platform ios

Includes Expo Developer Menu
For internal testing and debugging
iOS: Simulator builds
Android: APK with dev tools

Preview Profile

bash

eas build --profile preview --platform android

Production-like builds
For beta testing
iOS: TestFlight internal testing
Android: Direct APK download

Production Profile

bash

eas build --profile production --platform all

App store ready builds
Optimized and signed
iOS: .ipa for App Store
Android: .aab for Play Store
Auto-increment build numbers

🔧 Project Structure

graphql

activity-12-deploy-ready/
├── App.js                      # Demo app (100% complete)
├── app.json                    # App config (80% complete - needs customization)
├── eas.json                    # EAS config (100% complete)
├── package.json                # Dependencies (100% complete)
├── .gitignore                  # Git ignore file
├── README.md                   # This file
├── assets/
│   ├── icon.png                # App icon template (replace with yours)
│   ├── splash.png              # Splash screen template (replace)
│   └── adaptive-icon.png       # Android adaptive icon (replace)
├── docs/
│   ├── DEPLOYMENT_GUIDE.md     # Complete deployment guide (100% complete)
│   ├── APP_STORE_CHECKLIST.md  # Submission checklist (100% complete)
│   └── PRIVACY_POLICY.md       # Privacy policy template (80% complete)
└── scripts/
    └── generate-assets.sh      # Asset generator (100% complete)

📋 Deployment Workflow

Phase One: Preparation

Complete TODO #1 (assets)
Complete TODO #2 (configuration)
Test app on physical devices
Create privacy policy
Set up Apple Developer / Google Play accounts

Phase 2: Building

Configure EAS: eas build:configure
Create production builds: eas build --profile production --platform all
Wait for builds to complete (~15-30 minutes)
Download and test builds on devices

Phase 3: Submission

Create app in App Store Connect (iOS)
Create app in Play Console (Android)
Upload screenshots (6+ for iOS, 2+ for Android)
Write app descriptions
Submit builds: eas submit --platform [ios|android]
Complete store listings
Submit for review

Phase 4: Launch

Monitor review status (1-3 days typical)
Respond to reviewer feedback if needed
Celebrate when approved!
Announce on social media
Monitor analytics and user feedback

✅ Assets Created: Professional icons and splash screens that represent your app ✅ Configuration Complete: All app.json fields properly set ✅ Builds Successful: Both iOS and Android production builds created ✅ Stores Submitted: Apps uploaded to App Store Connect and Play Console ✅ Review Approved: Apps pass review and are published

🆘 Troubleshooting

Build Fails

bash

# Clear cache and rebuild
rm -rf node_modules package-lock.json
npm install --legacy-peer-deps
eas build --profile production --platform [ios|android] --clear-cache

"Command not found: eas"

bash

# Reinstall EAS CLI
npm install -g eas-cli

Bundle ID Already Taken

json

// Update app.json with a more unique ID
{
  "ios": {
    "bundleIdentifier": "com.yourname.yourapp123"
  },
  "android": {
    "package": "com.yourname.yourapp123"
  }
}

Permission Errors

json

// Add detailed descriptions for all permissions in app.json
{
  "ios": {
    "infoPlist": {
      "NSCameraUsageDescription": "This app uses your camera to scan barcodes."
    }
  }
}

See docs/DEPLOYMENT_GUIDE.md for comprehensive troubleshooting.

📱 Requirements

Developer Accounts

iOS: Apple Developer Program ($99/year)
- Sign up: https://developer.apple.com
Android: Google Play Developer ($25 one-time)
- Sign up: https://play.google.com/console/signup