React Ruby Build Guide

This Ruby on Rails app uses React to pull data from endpoints, showing the simplicity of using the platform. The example consumes the Homepage and Menu endpoints from


Getting Started with the Example App

Let's start by cloning the example app

cd path/to/your/projects/folder
git clone
cd Zesty-Remote-React-Ruby-Example

Now, let's install and run the app (Make sure you have Ruby version 2.4.4 or higher. To manage your versions and to keep your system Ruby separate, we recommend using rvm)

bundle install
rails g react:install
rails s

Understanding the Example Project

In this project, we are using two custom endpoints, /-/basic-api/homepage.json and /-/custom/menulist.json. To retrieve this data, we've put a React component inside our Ruby app. This streamlines the process significantly, since now we can simply use the same code as that from our Remote React App Guide.

In our React code, we perform a GET request to these endpoints. This can be seen in app/assets/javascripts/components/_home.js.jsx and app/assets/javascripts/components/_menu.js.jsx.

class Home extends Component {
  constructor(props) {
    this.state = {
      homeData: {}
  componentDidMount() {
      .then(response => {
        return response.json();
      .then(data => {
        this.setState({ homeData: data });
  render() { // greatly simplified for explanation, see the full file on Github
    return (
      <div data-spy="scroll" data-target="#site-navbar" data-offset="200">
        <h1 className="site-heading no- mb-3">
          { &&
        <h2 className="h5 site-subheading mb-5 no-">
          { &&

Using componentDidMount, we're able to fetch our JSON and render it accordingly. After we load it in, it's just a matter of parsing a JS Object.

Last updated