vite-plugin-rnw

A vite plugin for React Native Web projects.

This plugin uses the react plugin internally and applies a lot of fixes for react native web on top.

// vite.config.js
import { defineConfig } from "vite";
import { rnw } from "vite-plugin-rnw";

export default defineConfig({
  plugins: [rnw()],
});

Options

include/exclude

Includes .js, .jsx, .ts & .tsx by default. This option can be used to add fast refresh to other files:

import { defineConfig } from "vite";
import { rnw } from "vite-plugin-rnw";

export default defineConfig({
  plugins: [rnw({ include: /\.(js|jsx|ts|tsx)$/ })],
});

node_modules can be processed by this plugin when needed

By default the excludes pattern is:

/\/node_modules\/(?!react-native|@react-native|expo|@expo)/;

This means any package that starts with react-native, @react-native, expo, or @expo will be included and other node_modules will be excluded. But you can change this to include or exclude any package you want.

jsxImportSource

Control where the JSX factory is imported from. Default to 'react'

rnw({ jsxImportSource: "nativewind" });

babel

The babel option lets you add plugins, presets, and other configuration to the Babel transformation performed on each included file.

rnw({
  babel: {
    presets: [...],
    // Your plugins run before any built-in transform (eg: Fast Refresh)
    plugins: [...],
    // Use .babelrc files
    babelrc: true,
    // Use babel.config.js files
    configFile: true,
  }
})

Releasing

Changesets manages package versions and npm publishing.

1. Run bun changeset for each user-facing change and commit the generated file with the change.
2. Merge changes into main. The release workflow creates or updates a Version Packages pull request.
3. Merge the version pull request to publish the new version of vite-plugin-rnw to npm and create a GitHub release.

The vite-plugin-rnw package must have an npm trusted publisher configured for GitHub Actions with:

• Organization or user: dannyhw
• Repository: vite-plugin-rnw
• Workflow filename: release.yml
• Allowed action: npm publish