Getting Started

Introduction

React Native Boost is a React Native performance compiler.

It analyzes your app at build time and automatically applies safe performance optimizations across your React Native code.

It eliminates unnecessary runtime work, replaces JavaScript abstractions with more efficient native equivalents, and fixes common performance pitfalls without requiring you to rewrite your application code.

Compatibility

Boost 0.x and 1.x are not supported anymore and may break with future React Native updates. For Boost 2.x, we validate runtime behavior against all stable versions of React Native since 0.83.

Starting from React Native 0.80, Boost 0.x causes React Native to print import deprecation warnings. See react-native-community/discussions-and-proposals #893.

Getting Started

1. Install React Native Boost:

npm install react-native-boost

2. Add Boost to metro.config.js:

const { getDefaultConfig } = require('expo/metro-config');
const { withBoostConfig } = require('react-native-boost/metro');

module.exports = withBoostConfig(getDefaultConfig(__dirname));

Bare React Native apps should import getDefaultConfig from @react-native/metro-config instead.

If you do not use Metro in your project, refer to the Babel plugin setup instructions instead.

If you're using Unistyles or Nativewind in your project, refer to these additional setup instructions:

3. Restart the development server and clear cache:

npm start -- --clear

Platform Support

React Native Boost supports all platforms. Optimizations are performed on iOS and Android, while falling back to the default components on all other platforms.