rnx-kit

align-deps (previously known as dep-check) is a dependency manager and linter designed for React Native developers. It helps manage and align package versions across small repositories and large enterprise monorepos.

It addresses three main challenges:

1. Package Selection: Recommending the correct, maintained modules for specific React Native versions (e.g., knowing that AsyncStorage moved from core to @react-native-async-storage/async-storage).
2. Code Alignment: Ensuring all packages within a repository use the same versions of community modules to prevent breakages.
3. App Alignment: Helping integrating apps determine the correct set of dependencies required to satisfy the peerDependencies of multiple integrated experiences.

The @rnx-kit/rn-changelog-generator is an experimental tool designed to generate a markdown-formatted list of changes between two git references (such as tags) for the react-native repository.

It handles complex release requirements, such as:

• Author Attribution: Fetches commit metadata from the GitHub API to attribute changes to GitHub handles.
• Cherry-pick Resolution: Parses 'referential revisions' (added by Facebook's infrastructure) to resolve cherry-picked commits back to their original hashes in the main branch. This prevents duplicate entries in changelogs when commits are moved from main to stable release branches.

rnx-kit is a collection of tools designed to optimize the React Native developer experience by filling ecosystem gaps and streamlining workflows.

Key capabilities include:

• Dependency management: Use align-deps to ensure consistent dependency versions across large-scale projects.
• Native builds (experimental): Use the build tool to build Android and iOS apps in the cloud, bypassing the need for heavy local native toolchains.
• Enhanced bundling: Use metro-serializer to extend Metro with features like TypeScript validation, tree shaking, and detection of duplicate or cyclic dependencies.
• Tailored defaults: Access Babel presets for Metro that are opinionated for high-scale usage.

@rnx-kit/tools-workspaces is a collection of tools designed for working with monorepo workspaces. It provides utilities to discover workspace roots and list all packages declared within a workspace.

Supported workspace managers include:

• Bun
• Lerna
• npm
• pnpm
• Rush
• Yarn

@rnx-kit/tools-apple is a collection of utility functions designed to automate tasks related to deploying applications on iOS or macOS. It provides programmatic access to Xcode build processes, simulator management, device selection, and CocoaPods verification.

import * as tools from "@rnx-kit/tools-apple";

@rnx-kit/tools-android is a collection of functions designed to automate the deployment of apps on Android. It provides utilities for interacting with Android devices (physical and emulators), managing Gradle builds, and handling APK installation and execution.

import * as tools from "@rnx-kit/tools-android";

@rnx-kit/tools-windows provides a collection of functions to facilitate deploying, installing, and starting applications on Windows platforms.

import * as tools from "@rnx-kit/tools-windows";

You can control which domains are active via trackPerformance.

Enabling domains:

• All domains: trackPerformance({ strategy: "timing" })
• Specific domain: trackPerformance({ enable: "metro" })
• Multiple domains: trackPerformance({ enable: ["resolve", "transform"] })

Subdomains: Subdomains create a parent-child relationship. Enabling a parent domain automatically enables all its registered subdomains. Use registerSubdomain(parent, child) to establish this link.

import { registerSubdomain, getDomain } from "@rnx-kit/tools-performance";

// Register "metro:resolver" as a subdomain of "metro"
registerSubdomain("metro", "resolver");

// Enabling "metro" now also enables "metro:resolver"
trackPerformance({ enable: "metro", strategy: "timing" });

const domain = getDomain("metro:resolver"); // enabled via parent

Starting from version 0.9.55, the @rnx-kit/cli supports type-checking across multiple projects within a monorepo with the following behaviors:

• When bundling: The process will fail if type errors are encountered.
• When serving: The CLI will print type errors to the console but will continue running without failing.

The package provides three parsing backends to optimize the Metro transform stage. parseToAst uses a fallback chain to ensure compatibility while maximizing speed.

1. OXC (Primary): A fast Rust-based parser. It produces an ESTree AST which is converted to a Babel-compatible format in-place. It is automatically skipped for files that might contain Flow syntax.
2. Hermes (Secondary): Meta's Hermes parser, used if OXC fails.
3. Babel (Fallback): The standard Babel parseSync, used as the final fallback to ensure all supported syntax is handled.

Use TransformerSettings.parseDisableOxc to explicitly disable the OXC parser.

import { parseToAst } from "@rnx-kit/tools-babel";

// Tries OXC -> Hermes -> Babel
const ast = parseToAst(args);