Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucifier129/react-lite
An implementation of React v15.x that optimizes for small script size
https://github.com/lucifier129/react-lite
optimizer react react-lite
Last synced: about 1 month ago
JSON representation
An implementation of React v15.x that optimizes for small script size
- Host: GitHub
- URL: https://github.com/lucifier129/react-lite
- Owner: Lucifier129
- License: mit
- Created: 2015-12-02T14:59:27.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2019-03-29T05:26:10.000Z (over 5 years ago)
- Last Synced: 2024-04-14T05:53:38.860Z (7 months ago)
- Topics: optimizer, react, react-lite
- Language: JavaScript
- Homepage:
- Size: 6.83 MB
- Stars: 1,726
- Watchers: 48
- Forks: 100
- Open Issues: 23
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# react-lite
[](https://travis-ci.org/Lucifier129/react-lite)
[](https://www.npmjs.com/package/react-lite)
[](https://gitter.im/Lucifier129/react-lite?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
## 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
| Framework | Version | Minified Size |
|------------------------|------------|---------------|
| Ember | 2.2.0 | 446kb |
| Polymer | 1.0.6 | 183kb |
| Angular | 1.4.8 | 148kb |
| React | 0.14.3 | 136kb |
| Web Components Polyfill| 0.7.19 | 118kb |
| Riot | 2.3.11 | 20kb |
| React-lite | 0.15.6 | 25kb |
| preact + preact-compat | 8.2.1 | 5kb |
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](http://webpack.github.io/docs/configuration.html#resolve-alias) in webpack.config.js:
```javascript
// 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](https://github.com/facebook/react) instead.
## Installation
You can install react-lite from npm:
```shell
npm install react-lite --save
```
## Browser compatibility
supports IE9+ / ES5 enviroment
## Documentation
learn react-lite from [React official documentation](https://reactjs.org)
## 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](https://lucifier129.github.io/material-ui/build)
- works with react-bootstrap: [docs demo](http://react-lite-with-bootstrap.herokuapp.com/)
- works with ant-design: [demo](http://lucifier129.github.io/ant-design/)
- works with react-router: [examples](http://react-lite-with-react-router.coding.io/)
- works with redux:
* [async](http://lucifier129.github.io/redux-with-react-lite/async/index.html)
* [counter](http://lucifier129.github.io/redux-with-react-lite/counter/index.html)
* [shopping-cart](http://lucifier129.github.io/redux-with-react-lite/shopping-cart/index.html)
* [todomvc](http://lucifier129.github.io/redux-with-react-lite/todomvc/index.html)
* [todos-with-undo](http://lucifier129.github.io/redux-with-react-lite/todos-with-undo/index.html)
- works with react-motion: [demos](http://lucifier129.github.io/react-motion-with-react-lite/index.html)
- works with react-d3-components: [demos](http://lucifier129.github.io/react-d3-components-demos/)
- works with react-d3: [demos](http://lucifier129.github.io/react-d3-demos/)
- react-lite [vdom-benchmark](http://vdom-benchmark.github.io/vdom-benchmark/)
- js-repaint-perf:
* [react](http://lucifier129.github.io/react-lite-repaint-perf/react/index.html)
* [react-lite](http://lucifier129.github.io/react-lite-repaint-perf/react/lite.html)
## 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](https://github.com/Lucifier129/react-lite/issues/51))
- 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](https://github.com/Lucifier129/material-ui/blob/master/docs/webpack-production.config.js#L21)
- 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:
```shell
npm test
```
License: MIT (See LICENSE file for details)