https://github.com/NoamELB/react-hot-loader-loader

A Webpack Loader that automatically inserts react-hot-loader to your App 👨‍🔬
https://github.com/NoamELB/react-hot-loader-loader

hmr loader react react-hot-loader webpack

Last synced: 3 days ago
JSON representation

A Webpack Loader that automatically inserts react-hot-loader to your App 👨‍🔬

• Host: GitHub
• URL: https://github.com/NoamELB/react-hot-loader-loader
• Owner: NoamELB
• License: mit
• Created: 2018-01-17T18:55:56.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-01-03T21:45:12.000Z (almost 2 years ago)
• Last Synced: 2024-10-08T19:20:56.553Z (about 1 month ago)
• Topics: hmr, loader, react, react-hot-loader, webpack
• Language: JavaScript
• Homepage:
• Size: 1.49 MB
• Stars: 175
• Watchers: 5
• Forks: 8
• Open Issues: 18
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-list - react-hot-loader-loader - hot-loader to your App 👨‍🔬 | NoamELB | 175 | (JavaScript)

README

        
# react-hot-loader-loader

A Webpack Loader that automatically inserts react-hot-loader to your app, **without any changes in your app code**.

All it takes is a simple regex to indicate where your "App" Components are. This module does nothing if `NODE_ENV` is set to `production`.

Example:

![react-hot-loader-loader example](https://i.imgur.com/PQDkTdW.gif)

[This example code (A very informative webpack example)](https://github.com/NoamELB/react-hot-loader-loader/tree/master/examples/webpack)

## Usage

1.  Install

```

npm i react-hot-loader-loader

```

2.  In your Webpack configuration, add this loader:

```js

{

    test: /\/App\.js$/, // regex to match files to receive react-hot-loader functionality

    loader: require.resolve('react-hot-loader-loader'),

}

```

This loader **must** be placed after any ES6 transpiling loader (Babel), to make sure it transforms the code before it.

3.  Add react-hot-loader to your Babel plugins:

```js

{

  "plugins": ["react-hot-loader/babel"]

}

```

[Working project example with HMR, react-hot-loader and error recovery.](https://github.com/NoamELB/react-hot-loader-loader/tree/master/examples/webpack)

**The loader is dependent on react-hot-loader v4+, and won't work with earlier versions**.

## How it works?

[react-hot-loader](https://github.com/gaearon/react-hot-loader) is amazing! It exposes an HOC that does all the heavy lifting. It can wrap any component and will add real time components tweaking functionality while using HMR.

This Webpack loader just make things cleaner and easier, **wrapping components with this HOC for you**. All that from a Webpack configuration and not from inside Components.

This component:

```js

import React from 'react';

export default class App extends React.Component {

    render() {

        return 'something';

    }

}

```

Will transform to this (before ES6 transpilation):

```js

import {hot} from 'react-hot-loader';

import React from 'react';

class App extends React.Component {

    render() {

        return 'something';

    }

}

export default hot(module)(App);

```

[See the test for many more examples.](https://github.com/NoamELB/react-hot-loader-loader/blob/master/test/exampleFiles.js)

## Pros

*   Easier to control through configuration, just decide a convention and then there is no need for any additional code in an app.

*   No need to refactor old code.

*   Allows dynamic control, for example by using a command flag.

*   You can remove the loader on certain Webpack configurations.

## License

MIT