babel/packages/babel-preset-react

@babel/preset-react

Babel preset for all React plugins.

This preset always includes the following plugins:

• syntax-jsx
• transform-react-jsx
• transform-react-display-name

And with the development option:

• transform-react-jsx-self
• transform-react-jsx-source

Note: Flow syntax support is no longer enabled in v7. For that, you will need to add the Flow preset.

Installation

You can also check out the React Getting Started page

npm install --save-dev @babel/preset-react

Usage

Via .babelrc (Recommended)

.babelrc

{
  "presets": ["@babel/react"]
}

Via CLI

babel --presets @babel/react script.js

Via Node API

require("@babel/core").transform("code", {
  presets: ["@babel/react"]
});

Options

development

boolean, defaults to false.

Toggles plugins that aid in development, such as @babel/plugin-transform-react-jsx-self and @babel/plugin-transform-react-jsx-source.

This is useful when combined with either a babelrc.js or env option in a .babelrc configuration:

babelrc.js

module.exports = {
  presets: [
    ["@babel/react", {
      development: process.env.BABEL_ENV === "development"
    }],
  ],
}

.babelrc

Note: the env option will likely get deprecated soon

{
  "presets": ["@babel/react"],
  "env": {
    "development": {
      "presets": [
        ["@babel/react", { "development": true }]
      ]
    }
  }
}