Skip to content
App Router...next.config.js OptionsreactCompiler (experimental)

reactCompiler (experimental)

This feature is experimental and may change in future releases.

Next.js 15 introduced experimental support for the React Compiler. The compiler improves performance by automatically optimizing component rendering. This reduces the amount of manual memoization developers have to do through APIs such as useMemo and useCallback.

To use it, upgrade to Next.js 15, install the babel-plugin-react-compiler:

Terminal
npm install babel-plugin-react-compiler

Then, add experimental.reactCompiler option in next.config.js:

next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  experimental: {
    reactCompiler: true,
  },
}
 
module.exports = nextConfig

Optionally, you can configure the compiler to run in "opt-in" mode as follows:

next.config.ts
const nextConfig = {
  experimental: {
    reactCompiler: {
      compilationMode: 'annotation',
    },
  },
}
 
module.exports = nextConfig

Note: The React Compiler is currently only possible to use in Next.js through a Babel plugin. This will opt-out of Next.js's default Rust-based compiler, which could result in slower build times. We are working on support for the React Compiler as our default compiler.

Learn more about the React Compiler, and the available Next.js config options.