@wuguishifu/nx-expo-native-modules

An Nx plugin that scaffolds Expo native modules inside an Nx workspace.

Writing an Expo native module by hand means creating a Swift module, a Kotlin module, a podspec, a Gradle build file, an expo-module.config.json, and the TypeScript layer that bridges them — and then wiring all of that into the workspace's Babel, TypeScript, and Nx configuration. This plugin does that in one command.

Installation

pnpm add -D @wuguishifu/nx-expo-native-modules

Usage

nx g @wuguishifu/nx-expo-native-modules:native-module libs/my-module

The first positional argument is the directory the module is created in. The module name defaults to the last segment of that path, so the command above generates a MyModule native module. To set things explicitly:

nx g @wuguishifu/nx-expo-native-modules:native-module libs/my-module \
  --name=hello-world \
  --importPath=@myorg/hello-world \
  --androidNamespace=dev.expo.helloworld \
  --author="Your Name" \
  --description="Says hello from native code"

Add --dry-run to preview the changes without writing them.

What gets generated

libs/my-module/
├── .babelrc.js                       # @nx/react/babel preset, babel-preset-expo for tests
├── eslint.config.mjs                 # extends the workspace root config
├── expo-module.config.json           # registers the Apple + Android modules with Expo
├── package.json                      # expo/react/react-native peer deps
├── project.json
├── tsconfig.json
├── android/
│   ├── build.gradle                  # com.android.library + expo-module-gradle-plugin
│   └── src/main/
│       ├── AndroidManifest.xml
│       └── java/dev/expo/helloworld/
│           ├── HelloWorldModule.kt   # Module with a hello() function and a view
│           └── HelloWorldView.kt     # ExpoView subclass
├── ios/
│   ├── HelloWorld.podspec            # depends on ExpoModulesCore
│   ├── HelloWorldModule.swift        # Module with a hello() function and a view
│   └── HelloWorldView.swift          # ExpoView subclass
└── src/
    ├── index.ts
    ├── hello-world-module.ts         # requireNativeModule<HelloWorldModule>(...)
    └── hello-world-view.tsx          # requireNativeView(...)

Both platforms are generated with a matching hello() function and a native view that renders a centered label, so the module works as-is and gives you a running starting point on each platform.

What it changes in the workspace

Beyond the new project directory, the generator also:

• Adds a root babel.config.json with babelrcRoots: ['*'], so per-project .babelrc.js files are picked up in a monorepo. Skipped if the workspace already has a babel.config.json or babel.config.js.
• Registers the project in the root tsconfig.json references array.
• Adds dependencies to the root package.json. With the default --bundler=tsc: expo, react, react-dom, and react-native as dependencies, plus @nx/expo, @nx/react, @expo/cli, @types/node, metro-config, metro-resolver, and tslib as dev dependencies. With --bundler=none, only @types/node. Existing versions are kept, so this never overwrites versions the workspace has already pinned.
• Reads customConditions from tsconfig.base.json and uses the first entry as the source condition in the generated package.json export map, matching how the rest of the workspace resolves TypeScript sources.

The generator expects a root tsconfig.base.json and tsconfig.json to exist, and throws if either is missing.

Options

Naming

name is lowercased and split on spaces, hyphens, and underscores, then recombined. It is not split on camelCase boundaries, so pass hello-world, hello_world, or "hello world" to get HelloWorldModule — passing HelloWorld yields HelloworldModule.