// Run Wix Engine (mobile-apps-engine) iOS E2E tests locally to validate RNN changes. Use when you need to test RNN fixes against the Engine's Detox test suite.
Navigate and work with the react-native-navigation (RNN) codebase. Use when fixing bugs, adding features, tracing command flows, understanding options resolution, or working across JS/iOS/Android layers in this repo.
Reference for iOS 26 navigation bar, tab bar, toolbar, and Liquid Glass building blocks (UITab, scroll-edge effects, search placement, shared-background platter, UIButton glass configurations, UIGlassEffect / UIGlassContainerEffect, UINavigationItem.style navigator/browser/editor, UICornerConfiguration / concentric corners, UISheetPresentationController, SF Symbols 7) plus the internal view hierarchy of UIBarButtonItem and UIToolbar, and how react-native-navigation maps to all of it. Use when adding or fixing iOS 26 behavior in RNN's top bar, bottom tabs, bar buttons, toolbar, modals, or any glass-styled custom chrome; when investigating iOS 26-only regressions; or when deciding how to expose a new iOS 26 capability through RNN options.
Navigate and work with the react-native-navigation (RNN) codebase. Use when fixing bugs, adding features, tracing command flows, understanding options resolution, or working across JS/iOS/Android layers in this repo.
Navigate and work with the react-native-navigation (RNN) codebase. Use when fixing bugs, adding features, tracing command flows, understanding options resolution, or working across JS/iOS/Android layers in this repo.
| name | engine-e2e |
| description | Run Wix Engine (mobile-apps-engine) iOS E2E tests locally to validate RNN changes. Use when you need to test RNN fixes against the Engine's Detox test suite. |
The Engine app (@wix/wix-one-app-engine) in ~/Documents/mobile-apps-engine consumes RNN
from node_modules/react-native-navigation. To test RNN changes against the Engine's E2E
suite, you patch the Engine's copy of RNN, rebuild the native binary, and run the tests.
nvm use default)CI env var must be unset (not 0, fully unset) to avoid CI-specific codepaths.
Use env -u CI before every command.~/Documents/mobile-apps-engine with yarn install already done.Apply your RNN source changes to the corresponding files under:
~/Documents/mobile-apps-engine/node_modules/react-native-navigation/ios/
The directory structure mirrors the RNN repo's ios/ folder exactly.
cd ~/Documents/mobile-apps-engine
unset PREFIX && . ~/.nvm/nvm.sh > /dev/null && nvm use default > /dev/null
env -u CI yarn workspace @wix/mobile-apps-engine-native-builds build-local-ios
This runs xcodebuild with -quiet flag — expect no output until it finishes.
Takes ~10-15 minutes on M-series Macs.
The build output (.app bundle) lands in:
packages/native/mobile-apps-engine-native-builds/dist/binaries.json
SecKeychainUnlock): The CI env var is set. Use env -u CI.These are needed once per checkout. Skip if already built.
env -u CI yarn workspace @wix/mobile-apps-engine-extra-bundle local:build
env -u CI yarn workspace @wix/mobile-apps-dependencies local:build
cd ~/Documents/mobile-apps-engine
unset PREFIX && . ~/.nvm/nvm.sh > /dev/null && nvm use default > /dev/null
env -u CI yarn workspace @wix/wix-one-app-engine test:e2e:ios -w d <suite_files...>
The -w d flag selects the Detox worker count.
| Suite file | What it tests |
|---|---|
e2e/suites/ExternalLinks.test.js | Deep link navigation, back button |
e2e/suites/ExternalLinksModes.test.js | Deep link modes (pop to root, tab switch) |
e2e/suites/ExternalLinksPushNotifications.test.js | Push notification deep links |
e2e/suites/ExtenalLinksWithSiteSelect.test.js | Deep links with site selection |
e2e/suites/EngineUIComponents.test.js | Error screen, UI components |
e2e/suites/LaunchArgs.test.js | Launch arguments |
e2e/suites/LazyModules.test.js | Lazy-loaded modules |
env -u CI yarn workspace @wix/wix-one-app-engine test:e2e:ios -w d \
e2e/suites/ExternalLinks.test.js \
e2e/suites/ExternalLinksModes.test.js \
e2e/suites/ExternalLinksPushNotifications.test.js
Error: No dist version found: The native build hasn't run or failed.
Run step 2 again.Cannot find module .../mobile-apps-engine-extra-bundle/index.js:
Run step 3 (local:build for extra-bundle).ENOENT .../metadata.json: Run step 3 (local:build for mobile-apps-dependencies).Unable to resolve module @rozenite/...: The Rozenite plugin import is broken.
Patch packages/wix-one-app-engine/src/rozenitePlugin/helper/rozenite-network-inspector.ts
to make the import optional with a no-op fallback.navigateBack(): The navigateBack() helper taps
element(by.id('pop')) on iOS. This relies on RNN's setBackButtonTestID working
correctly. If the back button's view hierarchy changed (e.g., iOS 26 Liquid Glass),
the testID isn't applied and the element can't be found.| File | Purpose |
|---|---|
packages/wix-one-app-engine/e2e/helpers/utils.js | Test helpers including navigateBack() |
packages/wix-one-app-engine/demo-modules/deep-links/module.js | Deep link route definitions |
packages/wix-one-app-engine/demo-modules/deep-links/Screens.js | Deep link screen components |
packages/wix-one-app-engine/internalScripts/test-e2e.js | E2E test runner script |
packages/native/mobile-apps-engine-native-builds/local_build_scripts/build_ios.js | Local iOS build script |