react-lite

Introduction

react-lite is an implementation of React that optimizes for small script size.

Note: react-lite dose not support React v16.x now.

Size Comparison

React-lite supports the core APIs of React, such as Virtual DOM, intended as a drop-in replacement for React, when you don't need server-side rendering in browser(no ReactDOM.renderToString & ReactDOM.renderToStaticMarkup).

Usage

If you are using webpack, it's so easy to use react-lite, just config alias in webpack.config.js:

// webpack.config.js
{
    resolve: {
        alias: {
            'react': 'react-lite',
            'react-dom': 'react-lite'
        }
    }
}

Note: feel free to try react-lite, if something happen and we can't fix it in time, then use regular react instead.

Installation

You can install react-lite from npm:

npm install react-lite --save

Browser compatibility

supports IE9+ / ES5 enviroment

Documentation

learn react-lite from React official documentation

What can react-lite do?

just the same as what react does, see some demos below(I just add the alias to webpack.config.js, no need to do anything else):

• works with material-ui: docs demo
• works with react-bootstrap: docs demo
• works with ant-design: demo
• works with react-router: examples
• works with redux:
  • async
  • counter
  • shopping-cart
  • todomvc
  • todos-with-undo
• works with react-motion: demos
• works with react-d3-components: demos
• works with react-d3: demos
• react-lite vdom-benchmark
• js-repaint-perf:
  • react
  • react-lite

React-lite vs React

via react-lite:

• all of React.PropTypes method is no-op(empty function)
• use React in server side rendering, and use React-lite in browser
  • react-lite will replace the dom tree with new dom tree
  • you had better avoid script|head|link tag in client side
• can not use react-dev-tool inspect react-lite, should switch to regular react for debugging
• react-lite only works with a JSX toolchain(issue)
• unlike react, event object in react-lite is always persistent, and event.persist is set as no-op to avoid throwing error.
• react-lite can't work with react-tap-event-plugin, please use fastclick instead. or add alias 'react-tap-event-plugin': 'react-lite/lib/react-tap-event-plugin', just like here
• can't work with transform-react-inline-elements, you will get a bundle include both react and react-lite.
• react-lite just follow the best practice of React.

Test

react-lite reuses react's unitest(170), you can see them in __test__, and run the tests with:

npm test

License: MIT (See LICENSE file for details)