react-hot-boilerplate

Minimal live-editing example for React

Github stars Tracking Chart

A Big Update Is Coming

React Hot Loader 3 is on the horizon, and you can try it today (boilerplate branch, upgrade example). It fixes some long-standing issues with both React Hot Loader and React Transform, and is intended as a replacement for both. The docs are not there yet, but they will be added before the final release. For now, this commit is a good reference.

React Hot Boilerplate

The minimal dev environment to enable live-editing React components.

⚠️⚠️⚠️ This Is Experimental and Incomplete! ⚠️⚠️⚠️

This is not a good starting point for people learning React.
It’s experimental and completely lacks any production features.

Do not use this as an actual project boilerplate!
If you’re just getting started with React, use Create React App instead.

Usage

git clone https://github.com/gaearon/react-hot-boilerplate.git
cd react-hot-boilerplate/
npm install
npm start
open http://localhost:3000

Now edit src/App.js.
Your changes will appear without reloading the browser like in this video.

Linting

This boilerplate project includes React-friendly ESLint configuration.

npm run lint

Using 0.0.0.0 as Host

You may want to change the host in server.js and webpack.config.js from localhost to 0.0.0.0 to allow access from same WiFi network. This is not enabled by default because it is reported to cause problems on Windows. This may also be useful if you're using a VM.

Missing Features

This boilerplate is purposefully simple to show the minimal configuration for React Hot Loader. For a real project, you'll want to add a separate config for production with hot reloading disabled and minification enabled. You'll also want to add a router, styles and maybe combine dev server with an existing server. This is out of scope of this boilerplate, but you may want to look into other starter kits.

WebStorm

Because the WebStorm IDE uses "safe writes" by default, Webpack's file-watcher won't recognize file changes, so hot-loading won't work. To fix this, disable "safe write" in WebStorm.

Dependencies

Resources

Main metrics

Overview
Name With Ownergaearon/react-hot-boilerplate
Primary LanguageJavaScript
Program languageHTML (Language Count: 2)
Platform
License:MIT License
所有者活动
Created At2014-08-24 00:38:09
Pushed At2020-08-21 23:47:32
Last Commit At2020-08-21 23:47:31
Release Count3
Last Release Namev1.0.0 (Posted on )
First Release Namev0.1.1 (Posted on )
用户参与
Stargazers Count3.9k
Watchers Count103
Fork Count870
Commits Count99
Has Issues Enabled
Issues Count84
Issue Open Count12
Pull Requests Count32
Pull Requests Open Count2
Pull Requests Close Count25
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private