feat(ci): add devbox plugin integration testing

[abueide]

Summary

Adds comprehensive CI testing for mobile-devtools devbox plugin integration in E2E examples.

Changes

1. New Workflow: devbox-plugin-integration.yml

Tests the devbox plugin integration across both E2E examples (E2E-compat and E2E-latest) on both platforms (Android and iOS).

Triggers:

• ✅ Pull Requests to feat/rn-devbox-plugin when devbox files change
• ✅ Weekly Schedule (Mondays 10am UTC) to catch upstream plugin changes
• ✅ Manual Trigger with options to test specific examples/platforms
• ✅ Workflow Call for use as release prerequisite

2. Test Coverage

Validation Job:

• Validates devbox.json configuration
• Checks mobile-devtools plugin is included
• Runs on ubuntu-latest (fast, cheap)

Android Build Tests:

• Tests E2E-compat Android build
• Tests E2E-latest Android build
• Verifies Android tools availability
• Runs yarn install and Gradle build
• Runs on ubuntu-latest

iOS Build Tests:

• Tests E2E-compat iOS build
• Tests E2E-latest iOS build
• Verifies iOS tools availability
• Runs yarn install, pod install, and Xcode build
• Runs on macos-14 (required for Xcode)

Summary Job:

• Aggregates all test results
• Fails if any job fails
• Provides clear feedback on which tests failed

3. Benefits

✅ Early Detection - Catches breaking changes in mobile-devtools plugin before they affect developers

✅ Example Parity - Ensures both E2E-compat and E2E-latest work with the plugin

✅ Release Safety - Can be called as prerequisite to prevent releasing incompatible SDK

✅ Clear Feedback - Matrix-style testing shows exactly which example/platform combination fails

✅ Cost Optimization - Only runs iOS tests on macos-14 runners (expensive), uses ubuntu-latest where possible

Testing

Local Testing

# Tested E2E-compat
cd examples/E2E-compat
devbox version  # ✓ 0.17.2
devbox run install  # ✓ Yarn install successful
devbox run --list  # ✓ All scripts available

# Tested E2E-latest
cd examples/E2E-latest  
devbox run install  # ✓ Yarn install successful

CI Testing

This PR will trigger the workflow and validate:

• ✓ Configuration validation
• ✓ Android E2E-compat build
• ✓ Android E2E-latest build
• ✓ iOS E2E-compat build
• ✓ iOS E2E-latest build

Integration

Use as Release Prerequisite

To use this as a release prerequisite, add to .github/workflows/release.yml:

jobs:
  devbox-integration:
    name: Devbox Plugin Integration
    uses: ./.github/workflows/devbox-plugin-integration.yml
    with:
      example: 'all'
  
  release-production:
    needs: [ci, devbox-integration]  # Add this dependency
    # ... rest of release job

Manual Testing

Developers can trigger manually via Actions tab:

1. Go to Actions → Devbox Plugin Integration Tests
2. Click "Run workflow"
3. Select example (E2E-compat, E2E-latest, all)
4. Select platform (android, ios, both)

Architecture Decisions

Separate Jobs per Example/Platform

• Makes it clear which combination fails
• Allows parallel execution
• Reduces total runtime

Conditional Execution

• Only runs relevant jobs based on trigger
• Saves CI minutes on scheduled/manual runs

Pure Shell Mode

• Uses devbox run --pure to ensure reproducible builds
• Isolates from host environment

Node.js Caching

• Caches yarn dependencies via actions/setup-node
• Speeds up subsequent runs

Known Issues

Android SDK Nix Build Warning

• Android SDK evaluation shows build failures on macOS
• This is expected and doesn't block builds
• Android tools are installed on first use
• CI uses Linux runners which don't have this issue

Related

• Branch: feat/rn-devbox-plugin
• Mobile-devtools plugin: https://github.com/segment-integrations/mobile-devtools
• Previous commits:
  • 8ea2ade5 - fix: update E2E examples for mobile-devtools devbox plugin compatibility
  • ab47da45 - feat: add mobile-devtools devbox plugin to E2E examples

---

🤖 Generated with Claude Code