build

Build Skill

Build and run the Guidr React Native application.

Development Commands

Start Metro Bundler

npm start

Starts the Metro bundler. Keep this running while developing.

Run on Android

npm run android

Builds and runs the app on connected Android device or emulator.

Requirements:

• Android device connected via USB (with USB debugging enabled)
• OR Android emulator running
• Android SDK installed
• JDK 17 installed

Run on iOS (macOS only)

npm run ios

Builds and runs the app on iOS simulator or device.

Requirements:

• macOS
• Xcode installed
• iOS simulator or device

Build Commands

Android Debug APK

cd android
./gradlew assembleDebug

Builds debug APK at: android/app/build/outputs/apk/debug/app-debug.apk

Android Release APK

cd android
./gradlew assembleRelease

Builds release APK (requires signing configuration).

Clean Android Build

cd android
./gradlew clean

Removes build artifacts. Use when experiencing build issues.

Common Issues

Metro Bundler Issues

# Clear Metro cache
npm start -- --reset-cache

# Or manually clear
rm -rf /tmp/metro-*
rm -rf /tmp/haste-map-*

Android Build Issues

# Clear Gradle cache
cd android
./gradlew clean

# Clear node modules and reinstall
rm -rf node_modules
npm install

Port Already in Use

# Kill process on port 8081 (Metro)
lsof -ti:8081 | xargs kill -9

# Or use different port
npm start -- --port 8088

CI/CD Builds

GitHub Actions automatically builds on push/PR:

• Lint checks
• Test suite (171 tests)
• TypeScript type checking
• Android debug APK build

Workflow file: .github/workflows/ci-cd.yml

Device Requirements

Android

• Minimum SDK: 21 (Android 5.0)
• Target SDK: Latest (configured in android/build.gradle)
• Architecture: ARM64, ARMv7, x86, x86_64

iOS

• Minimum iOS: 13.0 (configured in ios/Podfile)
• Architecture: ARM64 (device), x86_64 (simulator)

Development Setup

First time setup:

# Install dependencies
npm install

# For iOS (macOS only)
cd ios && pod install && cd ..

Build Artifacts

After successful Android build, APK location:

• Debug: android/app/build/outputs/apk/debug/app-debug.apk
• Release: android/app/build/outputs/apk/release/app-release.apk

Install APK on device:

adb install android/app/build/outputs/apk/debug/app-debug.apk