DocumentationShowcaseBlog

turbopackRustReactCompiler

Use the native Rust port of the React Compiler with Turbopack instead of the Babel transform.

The experimental.turbopackRustReactCompiler option enables the native Rust version of the React Compiler, running it directly inside Turbopack as native code instead of through Node.js as it does with the standard Babel version. This typically results in a noticeable performance improvement.

This option is released as experimental to gather feedback before it becomes the default.

import type { NextConfig } from 'next'
 
const nextConfig: NextConfig = {
  // Enable the React Compiler
  reactCompiler: true,
  experimental: {
    // Use the Rust port instead of the Babel transform
    turbopackRustReactCompiler: true,
  },
}
 
export default nextConfig

Good to know

  • This option requires reactCompiler to be enabled. It selects which implementation runs, but does not turn the compiler on by itself.
  • This option is only supported with Turbopack. Using it with webpack will throw an error.
  • When enabled, you do not need to install babel-plugin-react-compiler. The Rust compiler runs natively inside Turbopack.

See the reactCompiler option documentation for details on how to use the compiler.

Version History

VersionChanges
v16.3.0Introduced the experimental turbopackRustReactCompiler option for the native Rust React Compiler.

On this page