Skip to content

Packages ​

The Vifx packages are published to npm under the @vifx scope. All of them are released together, with the same version.

Packages you install ​

PackageWhat it is
@vifx/cliThe vifx command. It brings the Vite plugins and the other building blocks with it.
@vifx/configdefineVifxConfig and the config loader, for a typed vifx.config.ts.
@vifx/expo-config-pluginRoutes the Xcode and Gradle bundle phases of expo prebuild projects through vifx export:embed.
@vifx/vite-config-bridgevifxResolveRequest(...), for a Metro-style resolveRequest in vite.config.vifx.ts.
@vifx/vite-plugin-expoExpo builds and the Expo Go dev server; expo() for a hand-written vite.config.vifx.ts.
@vifx/vite-plugin-react-nativeReact Native resolution, transforms, assets, Hermes and Fast Refresh; reactNative() for a hand-written vite.config.vifx.ts.

Install @vifx/cli first (see Getting Started), and add the others when your config files import them.

@vifx/vite-plugin-react-native ​

The core replacement for Metro's bundle output. It wires platform resolution, asset collection, source maps, optional Hermes output, the transform cache, and the in-app runtime that applies Fast Refresh patches.

@vifx/vite-plugin-expo ​

The Expo layer above the React Native plugin. It adds Expo app config handling, EXPO_PUBLIC_* env support, Expo shims, the Expo Go dev server with its dev engine, and the browser preview server.

@vifx/expo-config-plugin ​

An Expo config plugin that rewrites the generated native build scripts so that they call vifx export:embed instead of Metro. See Expo native builds.

Building blocks ​

These packages are used by the ones above and have no stable API of their own:

PackageScope
@vifx/typesShared public TypeScript contracts.
@vifx/errorsStructured errors with codes, hints, and docs paths.
@vifx/loggerTerminal and JSON logging helpers.
@vifx/coreProject discovery and orchestration glue.
@vifx/platform-resolverReact Native-style platform resolution.
@vifx/asset-registryAsset scale grouping, dimensions, hashes, and metadata.
@vifx/transform-cacheThe content-addressed transform cache.
@vifx/source-map-toolsSource-map validation, normalization, and comparison helpers.
@vifx/hermes-toolsHermes compiler detection and post-build bytecode orchestration.
@vifx/expo-exportExpo export artifact inspection and generation without Metro.
@vifx/codemodsConservative setup, init, and migration file planning.
@vifx/metro-inspectCaptured Metro artifact inspection.
@vifx/compat, @vifx/compat-runnerCompatibility cases, assertions, execution, and reports.

@vifx/expo-export generates and inspects Expo export artifacts from Vifx bundles: bundles, source maps, assets, manifest.json, and metadata.json. It does not implement the Expo Updates runtime, local Updates serving, response signing, EAS metadata parity, or app execution.

@vifx/metro-inspect inspects captured Metro reference artifacts so that Vifx output can be compared against stable evidence. @vifx/compat and @vifx/compat-runner keep compatibility cases and report generation independent of the implementation, so that the Metro and Vifx adapters are measured against the same expectations.

Released under the MIT License.