skills.rest
wix
wixOFFICIAL
Explore all skills by this author →
WebsiteGitHub

engine-e2e

Runs Wix Engine iOS Detox E2E tests against locally patched React Native Navigation builds.

13.2k|2.6k|Updated Mar 11, 2016
Search Tags:#ios#mobile testing#xcodebuild#E2E Testing#deep links#Detox#react native navigation
One-click install
npx skills add https://github.com/wix/react-native-navigation --skill engine-e2e
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: engine-e2e
Source: https://github.com/wix/react-native-navigation/tree/main/.cursor/skills/engine-e2e
Command: npx skills add https://github.com/wix/react-native-navigation --skill engine-e2e

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validating React Native Navigation changes against the Wix Engine app's real-world Detox E2E suite requires patching the Engine's node_modules copy of RNN, rebuilding the iOS native binary, and running the correct test suites — a multi-step process with several environment-specific pitfalls.

Core Features & Use Cases

  • Patch and Rebuild Workflow: Apply local RNN source changes to the Engine's node_modules and rebuild the iOS binary via xcodebuild with ad-hoc signing.
  • Targeted E2E Suites: Run RNN-relevant Detox suites covering deep links, push notification navigation, lazy modules, and UI components.
  • Troubleshooting Guidance: Diagnose common failures such as keychain errors from the CI env var, missing JS bundles, and back-button testID issues on newer iOS versions.
  • Use Case: After fixing a deep-link navigation bug in RNN, patch the Engine's copy of the library, rebuild the binary, and run the ExternalLinks test suites to confirm the fix works in the real Engine app.

Quick Start

Run the Engine's iOS E2E deep-link test suites against my local React Native Navigation changes.

Frequently Asked Questions about engine-e2e

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test React Native Navigation changes against the Wix Engine app?▼

Patch your RNN source changes into the Engine's node_modules/react-native-navigation/ios directory, rebuild the iOS binary with the build-local-ios workspace script, then run the Detox E2E suites via the test:e2e:ios command.

How to run Detox E2E tests for iOS in the mobile-apps-engine repo?▼

Run yarn workspace @wix/wix-one-app-engine test:e2e:ios with the -w d flag and the suite file paths. Ensure the native binary is built first and the CI environment variable is fully unset using env -u CI.

Why does the iOS build fail with a SecKeychainUnlock keychain error?▼

The keychain error occurs because the CI environment variable is set, triggering CI-specific codepaths. Unset it completely with env -u CI before running the build command rather than setting it to 0.

Why do Detox tests time out on navigateBack on iOS?▼

The navigateBack helper taps an element with the testID 'pop', which depends on RNN's setBackButtonTestID. If the iOS back button view hierarchy changed, such as with iOS 26 Liquid Glass, the testID is not applied and the element cannot be found.

What does the 'No dist version found' error mean when running E2E tests?▼

This error means the native iOS build has not run or failed, so no .app bundle exists in the binaries.json output. Re-run the build-local-ios workspace script to produce the binary before executing tests.

Related Skills

Explore More Software Engineering Skills→
wixwix
13.2k

rnn-codebase

Trace Navigation.push() command flows across JS/TS, iOS, and Android layers.

Official
Intermediate
richardwurichardwu
2

fix-pr

Fixes GitHub pull request review comments and CI check failures locally, commits and pushes updates.

Community
Advanced
gitcoder27gitcoder27

test-architect

Transform ad-hoc tests into production-grade suites for Python and TypeScript projects.

Community
Advanced
live-codeslive-codes
1.5k

livecodes/getting-started

Bootstrap LiveCodes projects and playgrounds via CDN, npm, or self-hosted deployments.

Official
Intermediate