No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
Tie into the `react-rails` gem to notify the client of changed files & reload assets on the client when they are changed.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Project Readme

React::Rails::HotLoader

Reload React.js components with Ruby on Rails & react-rails.

When you edit components, they'll be reloaded by the browser & re-mounted in the page.

Gem Version Build Status Code Climate Test Coverage

Installation

Add this line to your application's Gemfile:

gem 'react-rails-hot-loader'

And then execute:

$ bundle

Or install it yourself as:

$ gem install react-rails-hot-loader

Usage

  • Include the JavaScript:

    // app/assets/javascripts/application.js
    //= require react-rails-hot-loader

    (When not Rails.env.development?, this requires an empty file, so don't worry about leaving it in production deploys.)

  • Restart your development server

  • Edit files in /app/assets/javascripts & save changes -- they'll be reloaded in the client and React components will be remounted.

(This gem includes an initializer to start a change notification server in development only.)

Configuration

If you notice that your assets are not being recompiled and hot loaded, it could be because they aren't being matched by the default asset glob used (**/*.{js,coffee}*). You can modify this asset glob like so:

# config/initializers/react_rails_hot_loader.rb
React::Rails::HotLoader::AssetChangeSet.asset_glob = "**/*.{css,sass,scss,js,rb}*" # I <3 Opal

You can choose a port to start it on (default is 8082):

# config/initializers/react_rails_hot_loader.rb
React::Rails::HotLoader.port = 8088

Doeses & Doesn'ts

react-rails-hot-loader ...

  • does set up a WebSocket server & client
  • does reload JS assets when they change (from /app/assets/javascripts/*.{css,js,coffee}*)
  • does remount components (via ReactRailsUJS) after reloading assets
  • doesn't reload Rails view files (html, erb, slim, etc)

TODO

  • Figure out how the "real" React hot-loader preserves state and do that
  • Log out when a push fails, or log the JS code if the push succeeds but doesn't get eval'ed

License

The gem is available as open source under the terms of the MIT License.