Skip to content

Error Codes ​

These codes describe the public diagnostic vocabulary currently emitted by Vifx packages and CLI commands.

CodeMeaning
VIFX_INTERNAL_ERRORAn unexpected failure was normalized into a structured Vifx error.
VIFX_ASSET_INVALID_SCALEAn asset scale group was malformed or inconsistent.
VIFX_ASSET_NOT_FOUNDThe requested asset file or asset group does not exist.
VIFX_ASSET_UNSUPPORTED_TYPEThe requested asset type is outside the supported asset registry extensions.
VIFX_BABEL_CONFIG_LOAD_FAILEDThe target project's Babel configuration exists but could not be loaded or evaluated.
VIFX_BUILD_INVALID_MODEA build command received a bundle mode other than development or production.
VIFX_BUILD_INVALID_PLATFORMA build command received an unsupported platform value.
VIFX_BUILD_TARGET_NOT_FOUNDNo configured build target matched the requested platform.
VIFX_BUILD_TARGETS_MISSINGThe config does not contain any Vite bundle targets.
VIFX_COMPAT_INVALID_LIBRARY_CASEA compatibility library case is missing its per-toolchain support-matrix expectation.
VIFX_CONFIG_INVALIDA Vifx config value failed schema or shape validation.
VIFX_CONFIG_LOAD_FAILEDA config file existed but could not be imported or evaluated.
VIFX_CONFIG_MISSINGProject inspection did not find a vifx.config.* file.
VIFX_CONFIG_NOT_FOUNDA required or explicitly requested config file was missing.
VIFX_CORE_MISSING_PRIMITIVEA lazy core primitive could not be loaded from its package.
VIFX_DEV_BUNDLE_NOT_FOUNDThe dev server could not find an existing bundle artifact to serve.
VIFX_DEV_INVALID_PLATFORMThe dev command received an unsupported platform value.
VIFX_DEV_INVALID_PORTThe dev command received a malformed port value.
VIFX_DEV_PLATFORM_REQUIREDMultiple dev targets exist and the command needs an explicit platform.
VIFX_DEV_REQUIRES_REACT_NATIVEvifx dev was run outside a bare React Native project.
VIFX_DEV_TARGET_NOT_FOUNDNo configured dev target matched the requested platform.
VIFX_DEV_TARGETS_MISSINGThe config does not contain any React Native dev targets.
VIFX_DEVTOOLS_MIDDLEWARE_FAILEDThe React Native DevTools middleware failed while handling an inspector proxy request.
VIFX_DYNAMIC_CONTEXT_MODE_UNSUPPORTEDA require.context call requested a context mode other than the supported sync mode.
VIFX_DYNAMIC_CONTEXT_NOT_STATICA require.context call used arguments that cannot be statically analyzed at build time.
VIFX_DYNAMIC_IMPORT_NOT_STATICA native bundle contains a dynamic import() whose specifier is not a string literal.
VIFX_EXPERIMENTAL_EXPOThe inspected Expo workflow is outside what Vifx currently supports.
VIFX_EXPO_CONFIG_INVALIDA dynamic Expo app config (app.config.js / app.config.ts) threw or did not evaluate to a config object.
VIFX_EXPO_CONFIG_NOT_FOUNDThe Expo layer could not find or read app config metadata.
VIFX_EXPO_DEV_CLIENT_SIGNING_UNSUPPORTEDA manifest request demanded a code-signed response, which the Vifx dev server does not support.
VIFX_EXPO_DEV_INVALID_PLATFORMAn Expo dev command received an unsupported platform value.
VIFX_EXPO_DEV_INVALID_PORTAn Expo dev command received a malformed port value.
VIFX_EXPO_DEV_PLATFORM_REQUIREDMultiple Expo dev targets exist and the command needs an explicit platform.
VIFX_EXPO_DEV_REQUIRES_EXPO_MODEExpo dev serving was run without vite.mode = "expo".
VIFX_EXPO_DEV_REQUIRES_WEB_COMPATAn Expo dev target must opt into reactNativeCompat: "web" before browser serving.
VIFX_EXPO_DEV_TARGET_NOT_FOUNDNo configured Expo dev target matched the requested platform.
VIFX_EXPO_DEV_TARGETS_MISSINGThe config does not contain any Expo dev targets.
VIFX_EXPO_DEV_WATCH_UNAVAILABLEThe Expo Go dev server could not watch the project for changes; automatic reloads are disabled.
VIFX_EXPO_EXPORT_DUPLICATE_PLATFORMExpo export generation received more than one bundle for the same platform.
VIFX_EXPO_EXPORT_INVALID_PLATFORMAn Expo export command received an unsupported platform value.
VIFX_EXPO_EXPORT_NOT_FOUNDThe Expo export inspector could not find the requested export root.
VIFX_EXPO_EXPORT_REQUIRES_EXPO_MODEExpo export generation was run without vite.mode = "expo".
VIFX_EXPO_EXPORT_TARGET_NOT_FOUNDNo configured Expo export target matched the requested platform.
VIFX_EXPO_EXPORT_TARGETS_MISSINGExpo export generation did not receive any Vifx bundle artifacts.
VIFX_EXPO_PLUGIN_BUNDLE_PHASE_NOT_FOUNDThe Expo config plugin found no "Bundle React Native code and images" Xcode build phase.
VIFX_EXPO_PLUGIN_GRADLE_LANGUAGE_UNSUPPORTEDThe Expo config plugin only rewrites Groovy android/app/build.gradle files.
VIFX_EXPO_PLUGIN_GRADLE_REACT_BLOCK_UNTERMINATEDThe react {} block in android/app/build.gradle never closes.
VIFX_EXPO_PLUGIN_SHELL_SCRIPT_UNREADABLEThe Xcode bundle build phase shell script could not be parsed.
VIFX_EXPO_SMOKE_INVALID_ASSET_LIMITAn Expo smoke command received a malformed asset sampling limit.
VIFX_EXPO_SMOKE_REQUIRES_EXPO_MODEExpo Go smoke validation was run without vite.mode = "expo".
VIFX_EXPO_SMOKE_WEBSOCKET_UNAVAILABLEThe current Node.js runtime cannot open the WebSocket loop required by Expo Go smoke validation.
VIFX_EXPORT_EMBED_BUNDLE_OUTPUT_REQUIREDexport:embed was run without the required --bundle-output path.
VIFX_EXPORT_EMBED_INVALID_FLAGAn export:embed value flag was passed without its value.
VIFX_EXPORT_EMBED_INVALID_PLATFORMexport:embed received a --platform other than ios or android.
VIFX_EXPORT_EMBED_PROJECT_NOT_FOUNDThe positional project path passed to export:embed is not a directory.
VIFX_HERMES_COMPILE_FAILEDHermes compiler execution failed.
VIFX_HERMES_INPUT_MISSINGThe requested Hermes input bundle does not exist.
VIFX_HERMES_OUTPUT_MISSINGHermes completed without creating the requested bytecode output.
VIFX_HERMES_UNAVAILABLENo Hermes compiler was found through explicit path, env, workspace, or PATH.
VIFX_METRO_RESOLVE_REQUEST_MIGRATIONProject inspection found a custom Metro resolveRequest; port it to vite.config.vifx.ts with vifxResolveRequest.
VIFX_MIGRATION_UNSAFE_CHANGEA requested migration step was too risky or targeted the wrong project type.
VIFX_MODULE_FORMAT_UNSUPPORTEDA bundle target requested the metro module format before Metro-graph serialization shipped.
VIFX_MODULE_REGISTRY_ENTRY_MISSINGA module-registry build produced no entry module or no module chunks.
VIFX_MODULE_REGISTRY_REQUIRE_UNRESOLVEDA staged module require could not be resolved into the module-registry bundle.
VIFX_MODULE_REGISTRY_SOURCEMAP_INVALIDA staged chunk source map could not be parsed while composing the module-registry map.
VIFX_MONOREPO_EXPERIMENTALProject inspection detected a workspace path, and monorepo support is still limited.
VIFX_NO_ISSUESProject inspection completed without finding actionable issues.
VIFX_PROD_ASSET_VARIANT_MISSINGA production asset group reached the writer without any file variants to copy.
VIFX_PROD_ASSET_WRITE_FAILEDA production asset could not be written, or its destination escaped the assets dest.
VIFX_PROJECT_EXPERIMENTAL_EXPO_SDKThe project's Expo SDK is on the experimental support tier: static analysis only, not device-validated.
VIFX_PROJECT_INVALID_APP_JSONSetup codemods could not parse or use the project's app.json.
VIFX_PROJECT_INVALID_PACKAGE_JSONProject detection could not parse or use a package manifest.
VIFX_PROJECT_UNSUPPORTED_EXPO_VERSIONThe project's Expo version falls outside the current experiment range.
VIFX_RESOLVE_AMBIGUOUS_PLATFORM_FILEMultiple platform candidates matched and Vifx could not pick one safely.
VIFX_RESOLVE_GENERATED_MODULE_MISSINGA path-like import did not resolve and likely needs a project codegen/build step (e.g. lingui compile) to be run first.
VIFX_RESOLVE_INVALID_PACKAGE_JSONResolver could not parse or use a package manifest.
VIFX_RESOLVE_INVALID_SPECIFIERResolver received a malformed package specifier.
VIFX_RESOLVE_NOT_FOUNDResolver could not find a matching module for the requested platform.
VIFX_RUN_INVALID_PLATFORMA run command received an unsupported platform value.
VIFX_RUN_INVALID_PORTA run command received a malformed port value.
VIFX_RUN_PLATFORM_REQUIREDMultiple runnable targets exist and the run command needs an explicit platform.
VIFX_RUN_REQUIRES_WEB_COMPATA target must opt into reactNativeCompat: "web" before it can be served.
VIFX_RUN_RUNTIME_MISSINGRuntime preview artifacts were not found after a build attempt.
VIFX_RUN_RUNTIME_NOT_FOUNDRuntime preview artifacts were missing when running with --no-build.
VIFX_RUN_TARGET_NOT_FOUNDNo configured runtime target matched the requested platform.
VIFX_RUN_TARGETS_MISSINGThe config does not contain any Vite runtime targets.
VIFX_SOURCEMAP_INVALIDA source map failed validation or comparison.
VIFX_SETUP_APP_JSON_REQUIREDvifx setup --experimental-embed needs a static app.json to register the embed plugin.
VIFX_SETUP_CONFIRMATION_REQUIREDvifx setup was run without --yes in a non-interactive session.
VIFX_SETUP_EXPO_ONLYvifx setup was pointed at a non-Expo project even though the v1 flow supports Expo only.
VIFX_UNSUPPORTED_METRO_RESOLVE_REQUESTLegacy code, retained for compatibility; a custom resolveRequest is now supported (see VIFX_METRO_RESOLVE_REQUEST_MIGRATION).
VIFX_UNSUPPORTED_METRO_SERIALIZERProject inspection found a custom Metro serializer outside Vifx scope.
VIFX_USER_VITE_CONFIG_CONFLICTA user Vite config tried to override a vifx-reserved option (resolve conditions/dedupe, defines, or output).
VIFX_VITE_BUNDLE_MISSINGA Vite bundle build finished without the expected JavaScript bundle artifact.

Direction ​

  • Keep this table aligned with VIFX_ERROR_CODES in @vifx/errors.
  • Link high-volume codes to dedicated troubleshooting pages once the code list is stable enough to split.

Released under the MIT License.