Skip to content

Latest commit

 

History

History
64 lines (38 loc) · 2.74 KB

installation-into-an-existing-rails-app.md

File metadata and controls

64 lines (38 loc) · 2.74 KB

Getting Started with an existing Rails app

Also consult the instructions for installing on a fresh Rails app, see the React on Rails Basic Tutorial.

If you have rails-5 API only project, first convert the rails-5 API only app to rails app before getting started.

  1. Add the following to your Gemfile and bundle install. We recommend fixing the version of React on Rails, as you will need to keep the exact version in sync with the version in your client/package.json file.

    gem "react_on_rails", "11.1.4" # Update to the current version
gem "webpacker", "~> 3" # Newer versions might be supported

  2. Run the following 2 commands to install Webpacker with React. Note, if you are using an older version of Rails than 5.1, you'll need to install webpacker with React per the instructions here.

    $ bundle exec rails webpacker:install
$ bundle exec rails webpacker:install:react

  3. Commit this to git (or else you cannot run the generator unless you pass the option --ignore-warnings).

  4. See help for the generator:

    $ rails generate react_on_rails:install --help

  5. Run the generator with a simple "Hello World" example (more options below):

    $ rails generate react_on_rails:install

  6. Ensure that you have foreman installed: gem install foreman.

  7. Start your Rails server:

    $ foreman start -f Procfile.dev

  8. Visit localhost:3000/hello_world. Note: foreman defaults to PORT 5000 unless you set the value of PORT in your environment. For example, you can export PORT=3000 to use the Rails default port of 3000. For the hello_world example this is already set.

Installation

See the Installation Overview for a concise set summary of what's in a React on Rails installation.

NPM

All JavaScript in React On Rails is loaded from npm: react-on-rails. To manually install this (you did not use the generator), assuming you have a standard configuration, run this command (assuming you are in the directory where you have your node_modules):

$ yarn add react-on-rails --exact

That will install the latest version and update your package.json. NOTE: the --exact flag will ensure that you do not have a "~" or "^" for your react-on-rails version in your package.json.

Webpacker Configuration

React on Rails users should set configuration value compile to false, as React on Rails handles compilation for test and production environments.